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

Ошибки / Лимиты запросов

Ошибки

Ошибки HTTP возвращают объект error с полями code и message. Успешно принятая задача всё ещё может завершиться ошибкой позже; запрашивайте статус задачи или обрабатывайте вебхук об ошибке.

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

HTTP	Поле	Что делать
400	`invalid_request`	Исправьте JSON, добавьте отсутствующий промпт, скорректируйте диапазоны параметров или проверьте медиа-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."
  }
}