Ошибки и fallback
| HTTP / code | Действие клиента |
|---|---|
| 400 / 422 | Исправить параметры запроса; не повторять без изменений. |
| 401 | Проверить или заменить API-ключ. |
402 insufficient_balance | Пополнить баланс. |
| 404 | Проверить идентификатор ресурса. |
409 idempotency_conflict | Использовать новый ключ для нового запроса. |
409 result_not_ready | Продолжить polling и повторить скачивание только после статуса succeeded. |
409 result_unavailable | Задание завершилось без файла; использовать собственный fallback. |
| 413 | Уменьшить загружаемый файл или JSON-запрос. |
| 429 | Повторить после Retry-After с тем же Idempotency-Key. |
503 service_unavailable | Задание не создано. Немедленно отправить в собственный fallback. |
capacity_timeout | Терминальный статус уже созданного задания. Запустить fallback. |
generation_failed | Терминальная техническая ошибка; резерв освобождён, использовать собственный fallback. |
content_policy_violation / unsupported_request | Изменить входные данные и создать новое задание с новым Idempotency-Key. |
| Другие 5xx / сеть | Сначала повторить создание с тем же Idempotency-Key; затем проверить статус. |
API не имеет SLA. Клиент обязан иметь независимый fallback, собственные таймауты, мониторинг и хранение результата. Подробнее — в Регламенте API.
Изображения: при недоступности сервиса запрос может сразу получить 503. Видео: задание ожидает доступной мощности до 60 секунд, затем получает capacity_timeout. Резерв освобождается, автоматического резервного провайдера у Corporate API нет.