Ошибки 401, 403, 429 и 404 при работе с API: что каждая значит
Материал из серии инструкций по Kiree.net: коротко, с командами и проверками, которые можно повторить.
Клиенты и SDK показывают код ошибки, но не всегда понятно, где искать причину. Ниже — четыре самых частых случая и порядок проверки.
401 invalid_api_key
Ключ не передан или передан с ошибкой. Проверьте три вещи:
- Заголовок
Authorization: Bearer sk-...— именноBearer, а неToken. - Ключ не обрезан при копировании (иногда теряются последние символы).
- Ключ активен в кабинете: отключённый ключ возвращает ту же ошибку.
403 insufficient quota
Ключ верный, но на балансе нет средств. Это не сбой — нужно пополнить счёт на странице «Пополнение» и активировать код.
429 rate_limit_exceeded
Слишком много запросов за короткое время. Помогает повтор с задержкой: отправляйте запрос повторно через 1–2 секунды, а не сразу.
404 model_not_found
ID модели не совпадает с каталогом. Код ошибки часто содержит подсказку:
{"error":{"message":"model claude-opus-4.6 not found","type":"invalid_request_error"}}
Сверьте ID со страницей «Модели и цены» и используйте точное написание, например claude-opus-4-6 вместо варианта с точкой.
Как проверить подключение отдельно от кода
Самый быстрый способ — один запрос через curl из терминала. Если curl работает, а приложение нет, проблема в клиенте: чаще всего в base_url без /v1 на конце.
Регистрация занимает минуту: $0.20 на тест, Base URL https://kiree.net/v1, оплата из РФ.