Ошибки

Ошибки возвращаются в формате OpenAI с дополнительными полями status_code и request_id. Указывайте request_id при обращении в поддержку.

{
  "error": {
    "message": "model \"x\" is not available",
    "type": "invalid_request_error",
    "code": "model_not_found"
  },
  "status_code": 404,
  "request_id": "req_…"
}

HTTP	`code`	Значение
400	`model_required`	Тело не JSON или нет `model`.
400	`invalid_request_error`	Модель отклонила запрос; причина в `message`.
400	`context_length_exceeded`	Промпт с `max_tokens` превышает контекстное окно.
400	`streaming_required`	Ответ слишком длинный — повторите с `"stream": true`.
400	`unsupported_parameter`, `unsupported_value`	Модель не принимает параметр или значение.
400	`content_policy_violation`	Модель отказалась обрабатывать контент.
400	`wrong_endpoint`	Модель обслуживает другой эндпоинт; он указан в `message`.
402	`insufficient_balance`	Недостаточно свободного баланса. В `meta` — `required_micro_usd`, `balance_micro_usd`, `held_micro_usd`.
404	`model_not_found`	Модели нет в каталоге.
404	`not_found`	Неизвестный эндпоинт.
404	`job_not_found`	Нет такой задачи у этого аккаунта.
409	`job_not_completed`	У задачи пока нет результата.
410	`content_expired`	Срок хранения файла истёк.
413	`request_too_large`	Слишком большое тело запроса.
429	`rate_limited`	Слишком много запросов — повторите после `Retry-After`.
429	`too_many_jobs`	Достигнут лимит одновременных медиа-задач.
502	`backend_error`	Сбой бэкенда модели. Можно безопасно повторить.
503	`no_provider_active`	Сервис временно недоступен.
503	`model_unavailable`	Модель сейчас не может обслужить эту конфигурацию.

Когда повторять: 429 — после Retry-After; 502 — сразу или с небольшой задержкой; 503 — позже или с другой моделью. Ошибки 400 и 404 не повторяйте без изменения запроса.

Начало работы

Гайды

API