Основное API

Ошибки

Типовые ошибки AllTokens API и как их интерпретировать.

AllTokens возвращает ошибки в формате JSON с полем error.

{
  "error": {
    "code": 400,
    "message": "Detailed error description"
  }
}

Основные коды

КодЧто означает
400Невалидный JSON, отсутствуют обязательные поля, неверные параметры
401Ключ не передан, передан неверно или отозван
402Недостаточно средств на балансе для выполнения запроса
404Не найдена модель, генерация или подходящий маршрут под ограничения
429Сработало ограничение по частоте запросов
500Внутренняя ошибка сервера

Типовые ситуации

  • 400 — проверьте тело запроса и имена полей
  • 401 — перепроверьте Authorization: Bearer ...
  • 402 — пополните баланс и повторите запрос
  • 404 — проверьте model, generation_id и ограничения маршрутизации
  • 429 — повторите запрос позже с увеличивающейся задержкой

Практический совет

При работе с маршрутизацией сначала ослабьте ограничения. Если убрать слишком жёсткие allowed_models или blocked_models, ошибка 404 часто исчезает.