Гайды
Обработка ошибок
Коды ошибок и как на них реагировать
Обработка ошибок
Все ошибки возвращаются в формате:
{
"error": {
"code": "invalid_api_key",
"message": "API key not found or revoked",
"type": "authentication_error"
}
}
Коды
| Status | code | Что делать |
|---|---|---|
| 400 | invalid_request | Проверьте тело запроса |
| 401 | invalid_api_key | Сгенерируйте новый ключ |
| 403 | insufficient_scope | Ключ без нужных прав |
| 404 | model_not_found | Проверьте model в запросе |
| 429 | rate_limit_exceeded | Backoff по Retry-After |
| 429 | tokens_per_minute_exceeded | Backoff или повысьте тариф |
| 500 | internal_error | Повторите с экспоненциальной задержкой |
| 503 | model_overloaded | Подождите и повторите |
Идемпотентность
Передайте заголовок Idempotency-Key: <uuid> чтобы безопасно повторять
запросы — повтор с тем же ключом вернёт исходный ответ.