Лимиты и ошибки
Коды ошибок API и правила ограничения частоты запросов (rate limiting).
Формат ошибки
Все ошибки возвращаются в едином формате с HTTP-статусом и телом:
{
"error": {
"type": "rate_limit_error",
"message": "Rate limit exceeded, retry after 12 seconds"
}
}Коды ошибок
| HTTP | type | Описание |
|---|---|---|
| 400 | invalid_request_error | Некорректные параметры запроса. |
| 401 | authentication_error | Отсутствует или недействителен API-ключ. |
| 403 | permission_error | Ключ не имеет доступа к указанной модели. |
| 404 | not_found_error | Эндпоинт или ресурс не найден. |
| 429 | rate_limit_error | Превышен лимит запросов или расхода. |
| 500 | api_error | Внутренняя ошибка на стороне Tokenola. |
Rate limits
Лимиты частоты запросов зависят от тарифа и модели и передаются в заголовках ответа:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 1735689660При получении 429 используйте экспоненциальный backoff перед повторной отправкой запроса.