ДокументацияОшибки и диагностика
Ошибки и диагностика
Zenvy возвращает ошибки в JSON-формате, совместимом с OpenAI:
{
"error": {
"message": "Неверный API-ключ",
"type": "authentication_error",
"code": "invalid_api_key"
}
}Частые коды ошибок
| Код | HTTP | Что означает |
|---|---|---|
invalid_api_key | 401 | Ключ неверный, удалён или отключён |
insufficient_balance | 402 | На балансе недостаточно средств |
model_not_found | 404 | Модель не найдена |
model_disabled | 403 | Модель отключена администратором |
rate_limit_exceeded | 429 | Превышен лимит запросов в минуту |
provider_unavailable | 502 | Upstream-провайдер недоступен или вернул ошибку |
Если max_tokens выше лимита модели, Zenvy автоматически ограничивает длину ответа допустимым значением.
Что проверить в первую очередь
- API-ключ начинается с
sk-zenvy-. - В заголовке есть
Authorization: Bearer .... - Базовый адрес содержит
/v1:https://api.zenvy.su/v1. - Имя модели совпадает с ID из Модели и баланс.
- На нужном балансе есть средства.
- Модель активна на странице моделей.
Проверка ключа и баланса
curl https://api.zenvy.su/v1/balance \
-H "Authorization: Bearer sk-zenvy-..."Если баланс возвращается — ключ рабочий. Дальше проверьте имя модели и формат запроса.