Справочник по ошибкам

Стандартизированный формат ошибок и наиболее частые коды.

Формат

Каждая ошибка следует одной и той же JSON-структуре, независимо от эндпоинта:

json

{
  "error": {
    "code": "insufficient_credits",
    "message": "Solde de credits insuffisant ou budget mensuel du projet depasse.",
    "request_id": "9480fe92-f68e-4731-b98e-d35a5e8b9819",
    "details": {}
  }
}

request_id идентифицирует запрос сквозным образом через все сервисы — полезно указывать его, если вы обращаетесь к нам по поводу неожиданной ошибки.

Частые коды

HTTP	код	Значение
401	missing_api_key	Отсутствует заголовок Authorization.
401	invalid_api_key	Недействительный, отозванный или истёкший API-ключ.
403	insufficient_scope	У ключа нет необходимой области действия для этой категории.
403	not_a_member	Вы не принадлежите к этой организации.
403	csrf_check_failed	Отсутствует заголовок безопасности (сессионный cookie, неприменимо при использовании API-ключа).
404	model_not_found	routing_strategy «manual» с моделью, отсутствующей в каталоге.
404	no_model_available	Ни одна модель не соответствует запрошенным критериям.
402	insufficient_credits	Недостаточный баланс кредитов или превышен месячный бюджет проекта.
409	conflict	Состояние несовместимо с действием (например, диалог агента не в состоянии idle).
422	validation_error	Некорректное тело запроса (отсутствует поле, неверный тип и т. д.).
429	rate_limit_exceeded	Слишком много запросов для этого ключа — см. Лимиты запросов.
503	all_providers_unavailable	Все кандидаты-поставщики завершились неудачей (см. Маршрутизация и отказоустойчивость).

В SDK

Официальные SDK преобразуют каждый диапазон HTTP-статусов в типизированный класс ошибки (AuthenticationError, PermissionDeniedError, NotFoundError, InsufficientCreditsError, ConflictError, ValidationError, RateLimitError, ServerError), каждый из которых, помимо сообщения, предоставляет .code, .status, .requestId и .details. См. SDK для JavaScript / SDK для Python.