ИнференсСправка

Ошибки

Коды ответов шлюза и что делать с каждым.

Ошибка приходит в формате OpenAI:

{
  "error": {
    "message": "Model not available on your plan.",
    "type": "invalid_request_error",
    "code": "model_not_allowed"
  }
}

• 401

  invalid_api_key — ключа нет или он неверный. Проверьте заголовок Authorization и сам ключ в кабинете.

• 403

  model_not_allowed — модель не входит в ваш тариф. Возьмите другую модель или смените тариф.

• 404

  model_not_found — такой модели нет в каталоге. Список доступных отдаёт GET /v1/models.

• 429

  session_limit_exceeded, week_limit_exceeded, month_limit_exceeded — исчерпан запас кредитов в одном из окон. Когда он вернётся, сказано в заголовках Retry-After и X-RateLimit-Reset — см. Пределы расхода.

• 502

  bad_gateway — модель не ответила. Повторите запрос.

Проверка живости

GET /healthz отвечает {"status":"ok"} и не требует ключа.