ИнференсПомощь

Коды ошибок

Какие коды ошибок возвращает API Yenisei, что каждый из них означает и что с ним делать.

Если запрос не удался, API отвечает кодом HTTP и телом в формате OpenAI: в поле message — описание словами, в поле code — короткий код, по которому ошибку удобно разбирать в программе. На этой странице собраны все коды, которые возвращает API, и действия для каждого.

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

Коды ответов

  • 401

    invalid_api_key — ключ API не передан или неверный. Проверьте заголовок 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"} и не требует ключа. Им удобно проверять, доступен ли API.