Формат ошибки
json
{
"error": {
"code": "invalid_request",
"message": "The request is invalid",
"request_id": "req-...",
"details": [{ "path": "parameters.duration_seconds", "code": "too_big", "message": "Number must be less than or equal to 30" }]
}
}Записывайте request_id и передавайте его поддержке. Для программной обработки используйте error.code, а не текст message.
HTTP-ошибки
| HTTP | Код | Значение |
|---|---|---|
| 400 | invalid_request | Неверный JSON, поля или комбинация параметров |
| 401 | authentication_required | Ключ отсутствует или недействителен |
| 402 | insufficient_balance | Недостаточно средств на балансе |
| 403 | forbidden / model_not_available | Нет нужного права или доступа к модели |
| 404 | generation_not_found / media_asset_not_found | Ресурс не найден в проекте |
| 409 | idempotency_conflict | Конфликт с текущим состоянием |
| 413 | payload_too_large | Превышен допустимый размер запроса |
| 415 | unsupported_media_type | Требуется Content-Type: application/json |
| 422 | input_media_dimensions_invalid | Размеры входного изображения или видео не подходят Seedance; details указывает файл и ограничения. Генерация и резерв не создаются. |
| 500 | internal_error | Внутренняя ошибка |
Ошибки во время генерации
Если ошибка произошла после создания генерации, GET вернёт HTTP 200, status: failed и объект error.
Обрабатывайте error.code, а не текст сообщения. HTTP 400 провайдера сам по себе не означает отказ фильтра.
| Код | Значение | Что делать |
|---|---|---|
| moderation_blocked / content_policy_violation | Запрос отклонён фильтром провайдера | Не повторять тот же промпт автоматически; изменить запрос. При подтверждённом отказе резерв освобождается. |
| invalid_parameter / openai_http_400 / openai_http_422 | Провайдер отклонил параметры | Проверить параметры модели; не повторять неизменённый запрос автоматически. |
| provider_submission_unknown | Провайдер мог принять запрос, но результат отправки неизвестен | Не создавать дубль. Сохранить ID генерации и обратиться в поддержку. |
| billing_reconciliation_required | Требуется сверка использования или стоимости | Проверять существующую генерацию; не считать резерв автоматически возвращённым. |
Это основные примеры, а не исчерпывающий список кодов провайдеров. Неизвестный код не должен ломать клиент: сохраняйте ID генерации и request_id. Состояния submission_unknown и billing_reconciliation означают незавершённую сверку, а не подтверждённую ошибку или разрешение повторить платный запрос.