Документація

Помилки / Ліміти запитів

Помилки

Помилки HTTP містять об’єкт error із кодом (code) та повідомленням (message). Завдання, успішно прийняте в роботу, все одно може завершитися помилкою згодом; опитуйте статус або обробляйте вебхук про помилку.

{
  "error": {
    "code": "invalid_request",
    "message": "input.prompt is required."
  }
}

HTTP	Поле	Що робити
400	`invalid_request`	Виправте структуру JSON, додайте prompt, перевірте ліміти параметрів або URL-адреси медіа перед повторною спробою.
401	`invalid_api_key`	Перевірте Bearer-токен та переконайтеся, що ключ API активний.
402	`insufficient_credits`	Поповніть баланс або зменште вартість завдання. Відповідь може містити необхідну та доступну кількість кредитів.
403	`forbidden`	Перевірте обмеження на рівні облікового запису, описані в повідомленні про помилку.
404	`not_found`	Перевірте ID завдання та переконайтеся, що ключ належить користувачеві, який створив це завдання.
429	`rate_limited`	Зачекайте інтервал, указаний у Retry-After, перед повторним запитом.
500	`internal_error`	Перевірте повідомлення про помилку та логи API. Повторюйте запити обережно: повторне надсилання запиту на створення може створити ще одне платне завдання.

Ліміти запитів

Створення завдань: за замовчуванням для кожного ключа API дозволено до 100 запитів на хвилину. Індивідуальні ліміти запитів наразі недоступні.

Запити щодо завдань: за замовчуванням для кожного ключа API дозволено до 120 запитів на хвилину. Запити на отримання інформації та запити на створення завдань враховуються окремо.

Для запитів на створення зображень і відео діє спільний ліміт частоти запитів API-ключа.

Помилка HTTP 429 містить заголовок Retry-After: 60 для створення завдань та Retry-After: 5 для запитів статусу. Використовуйте експоненційне збільшення інтервалів та уникайте занадто частого опитування.

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Retry-After: 60

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded."
  }
}