Коды ошибок API

Разделы документации

Формат ошибки

Ошибки возвращаются в формате OpenAI:

tokventa.tech/v1
{ "error": { "message": "текст ошибки", "type": "invalid_request_error" } }

Коды

КодТипПричинаЧто делать
400invalid_request_errorНевалидный JSON, неизвестная модель, неверные параметры запросаПроверьте тело запроса и ID модели (GET /v1/models)
401invalid_request_error«Неверный или отсутствующий API-ключ»Передайте заголовок Authorization: Bearer sk-…
402invalid_request_errorПробная квота исчерпана / недостаточно средств на балансеПополните баланс в личном кабинете
403invalid_request_errorКлюч отключён или модель недоступна на вашем тарифеПроверьте список моделей ключа: GET /v1/models
405invalid_request_errorMethod not allowed — например, GET вместо POSTИспользуйте метод из документации эндпоинта
429invalid_request_error«Превышен лимит: N запросов/мин» (лимит ключа) или общий IP-лимит шлюзаСнизьте частоту запросов; повторите через 30 с (заголовок Retry-After). Для платных ключей лимит можно поднять через поддержку
5xxupstream_error«Upstream error: HTTP N» — ошибка на стороне провайдера моделиПовторите запрос с экспоненциальной задержкой; при повторяющихся ошибках выберите другую модель

Пример тела ошибки 402

tokventa.tech/v1
{
  "error": {
    "message": "Пробная квота исчерпана (100000 токенов). Зарегистрируйся в личном кабинете /dashboard — ключи работают без лимита токенов, оплата по факту.",
    "type": "invalid_request_error"
  }
}

Рекомендации по обработке

  • Повторяйте запросы на 429 и 5xx с экспоненциальной задержкой (1 с, 2 с, 4 с…).
  • На 402 — не ретраить, а пополнить баланс.
  • Логируйте error.message — сообщения шлюза объясняют причину на русском.

Базовый URL API: https://tokventa.tech/v1 · Каталог моделей · Цены · Получить ключ