Як працює API пакетної обробки?
Кінцева точка API пакетної обробки, описана тут, дає змогу користувачам надсилати запити для асинхронної пакетної обробки. Ми обробимо ці запити протягом 24 годин. Дані кожного запиту буде прочитано з попередньо завантаженого файлу, а відповіді буде записано у вихідний файл. Ви можете запитувати пакетний об’єкт, щоб отримувати оновлення статусу та результати.
Яка ціна API пакетної обробки?
Кожна модель пропонуватиметься з 50% знижкою на вартість порівняно із синхронними API. Ось додаткова інформація про ціни на наш API.
Які моделі можна використовувати для пакетної обробки?
API пакетної обробки широко доступний для більшості наших моделей, але не для всіх. Зверніться до довідкової документації щодо моделей, щоб переконатися, що модель, яку ви використовуєте, підтримує API пакетної обробки.
Що станеться, якщо API не виконає мій запит у межах обіцяного часу?
Ми прагнемо обробити всі запити протягом 24 годин. Якщо термін дії пакета завершується (тобто його не вдалося завершити в межах часового вікна SLA), решта роботи скасовується, а вся вже виконана робота повертається. З розробників стягуватиметься плата за всю виконану роботу.
Який ліміт кількості запитів, які можна обробляти пакетно?
API для ембедингів мають ліміт у 1 мільйон запитів у черзі одночасно.
Для всіх інших API немає обмеження на кількість запитів, які можна обробляти пакетно; однак кожен рівень використання має відповідний ліміт запитів для пакетної обробки. Ваш ліміт запитів для пакетної обробки включає максимальну кількість вхідних токенів, які одночасно перебувають у черзі. Свої ліміти запитів можна знайти тут.
Чи можу я змінити час очікування відповіді від API пакетної обробки?
Наше поточне задане часове вікно становить 24 години. Наразі ми не можемо змінити цей період часу.
Чи підтримує API пакетної обробки потокову передачу?
Ні, API пакетної обробки не підтримує потокову передачу. Пакетні запити повертають результати через вихідні файли, а не як потокові відповіді.
Чи підтримує API пакетної обробки зображення?
Так, API пакетної обробки підтримує зображення.
Я отримав повідомлення про помилку “The URL provided for this request does not prefix-match the batch endpoint”. Що мені робити?
Якщо ви отримали цю помилку, це означає, що вашу URL-адресу неправильно відформатовано для кінцевої точки API пакетної обробки. Зверніться до нашої документації тут, щоб переконатися, що ви правильно викликаєте кінцеву точку.
Чи враховується використання API пакетної обробки в моїх інших лімітах запитів?
Ліміти запитів API пакетної обробки повністю відокремлені від наявних лімітів.
Що станеться, якщо пакет буде скасовано?
Якщо пакет скасовано вручну, буде повернено всі результати, які вже було завершено. З розробників стягуватиметься плата за всю виконану роботу.
Що станеться, якщо термін дії пакета завершиться?
Якщо термін дії пакета завершується (тобто його не вдалося завершити в межах часового вікна SLA), решта роботи скасовується, а вся вже виконана робота повертається. З розробників стягуватиметься плата за всю виконану роботу.
Яких статусів можна очікувати для пакетних завдань?
Пакетне завдання може мати будь-який із таких статусів: Перевірка, Збій, Виконується, Фіналізація, Завершено, Прострочено, Скасовується та Скасовано. Якщо ви перевіряєте значення статусу API програмно, використовуйте літерали в нижньому регістрі: validating, failed, in_progress, finalizing, completed, expired, cancelling і cancelled.
Перевірка: виконується перевірка завантаженого файлу перед запуском пакета.
Збій: файл не пройшов процес перевірки.
Виконується: файл успішно перевірено, і пакетний процес триває.
Фіналізація: пакетне завдання завершено, і результати готуються.
Завершено: пакетне завдання завершено, і результати готові.
Прострочено: пакет не вдалося завершити в межах часового вікна SLA.
Скасовується: скасування пакетного завдання ініційовано.
Скасовано: пакетне завдання було скасовано.
Як перевірити, які пакетні завдання я вже створив?
Ви можете отримати список усіх своїх пакетних завдань за допомогою виклику API, зазначеного тут.
Чи підтримується нульове збереження даних на цій кінцевій точці?
Якщо для вашої організації ввімкнено нульове збереження даних, зверніть увагу, що нульове збереження даних не застосовується до API пакетної обробки. Організації з ZDR можуть створювати пакетні завдання, але вхідні файли пакетів, вихідні дані, помилки та проміжні артефакти зберігаються відповідно до налаштованих політик збереження Batch, File Service і Sediment.