Коды ошибок API
Распространённые коды ошибок при вызове Kimi API и способы их устранения.
Справочник кодов ошибок
| Код ошибки | Значение | Как исправить |
|---|---|---|
| 400 | Некорректный запрос | Проверьте формат тела запроса, имена и типы параметров. Частые причины: некорректный JSON, отсутствие обязательных параметров, значения вне допустимого диапазона. |
| 401 | Не авторизовано | Убедитесь, что API-ключ указан верно, не истёк и не отключён. Проверьте формат заголовка: Authorization: Bearer <your-api-key>. |
| 403 | Доступ запрещён (недостаточный баланс) | Баланс аккаунта исчерпан — пополните его в консоли. Аккаунт также может быть ограничен; при необходимости обратитесь в поддержку. |
| 404 | Не найдено | Проверьте путь URL запроса и имя модели. Убедитесь, что endpoint имеет вид https://api.moonshot.ai/v1/.... |
| 429 | Too Many Requests (слишком много запросов) | Превышен rate limit. Снизьте частоту запросов, реализуйте экспоненциальную задержку повторных попыток или обратитесь в поддержку для повышения лимитов. |
| 500 | Internal Server Error (внутренняя ошибка сервера) | Временная проблема на сервере — повторите попытку позже. Если ошибка сохраняется, напишите на [email protected] и укажите request_id. |
Общие рекомендации по устранению неполадок
- Проверьте полное сообщение об ошибке: ответ в формате JSON содержит
error.messageс подробным описанием. - Запишите request_id: он поможет поддержке быстро найти проблему.
- Сверьтесь с официальной документацией: убедитесь, что вызовы соответствуют документации на platform.kimi.ai.
- Реализуйте логику повторных попыток: для ошибок 429 и 500 используйте экспоненциальную задержку.