Коды ошибок — Документация TokSpan

Коды состояния HTTP

Код	Значение	Действие
400	Неверный запрос	Проверьте тело запроса на наличие некорректного JSON или отсутствующих обязательных полей
401	Не авторизован	Проверьте, что ваш API-ключ действителен и активен в панели управления
404	Неверный URL / конечная точка не найдена	Проверьте путь запроса по справочнику API
429	Превышен лимит запросов / недостаточно квоты	Для лимитов запросов реализуйте экспоненциальную задержку с джиттером. Если ошибка упоминает квоту или баланс (например, `insufficient_user_quota`), пополните баланс в панели управления вместо повторов — см. лимиты запросов
500	Внутренняя ошибка	Проблема на стороне TokSpan — повторите запрос с задержкой или обратитесь в поддержку
502	Ошибка шлюза	Ошибка upstream-провайдера — может активироваться автоматическое переключение
503	Сервис недоступен / модель не найдена	Временная перегрузка — повторите с задержкой. Если ошибка содержит код `model_not_found`, модель недоступна для вашего ключа — проверьте название модели в каталоге моделей

Формат ответа с ошибкой

Ошибки возвращаются в объекте error с читаемым message и идентификатором type. В TokSpan type обычно равен new_api_error, а ошибки баланса аккаунта сопровождаются code: "insufficient_user_quota". Пример:

json
{
  "error": {
    "message": "You can access all models, but this request exceeded your account balance. Please top up at the Dashboard.",
    "type": "new_api_error",
    "param": null,
    "code": "insufficient_user_quota"
  }
}

Важно читать сообщение. 429 с сообщением о лимите запросов означает «подожди и повтори», а 429 (или 400) с сообщением о квоте — «сначала пополни баланс». Прежде чем решать, как реагировать, прочитайте сообщение. Приведённый текст сообщения является иллюстративным — всегда опирайтесь на код состояния HTTP и поле code.