Ошибки и повторы
Ответ об ошибке содержит error.code, сообщение и request_id. Передайте request_id поддержке, не передавайте API-ключ.
| HTTP | Действие |
|---|---|
| 401 | Проверьте адрес API и действительность ключа. |
| 402 | Пополните баланс или увеличьте бюджет ключа. |
| 422 | Исправьте параметры запроса. |
| 409 | Операция уже зарегистрирована. Проверьте её статус по request_id; повторного списания нет. |
| 429 | Снизьте параллельность. Учитывайте Retry-After. |
| 502 / 504 | Проверьте статус запроса перед повтором. |
Повторы
При временной ошибке сервер повторяет запрос к той же модели через 3 секунды, всего до 3 попыток. Списание клиента выполняется один раз. Ошибки параметров и авторизации не повторяются автоматически.
Для изображений и другого медиа повтор после неоднозначного результата ограничен, чтобы не создавать дубликаты генерации. Абсолютное отсутствие ошибок гарантировать нельзя.
Защита от повторного списания
Для одного логического запроса передавайте один и тот же Idempotency-Key. Для нового запроса используйте новое значение. Статус можно проверить через GET /requests/{request_id}.