Ошибки и эксплуатация4 мин чтения

Ошибки 401, 403, 429 и 404 при работе с API: что каждая значит

Материал из серии инструкций по Kiree.net: коротко, с командами и проверками, которые можно повторить.

Клиенты и SDK показывают код ошибки, но не всегда понятно, где искать причину. Ниже — четыре самых частых случая и порядок проверки.

401 invalid_api_key

Ключ не передан или передан с ошибкой. Проверьте три вещи:

  1. Заголовок Authorization: Bearer sk-... — именно Bearer, а не Token.
  2. Ключ не обрезан при копировании (иногда теряются последние символы).
  3. Ключ активен в кабинете: отключённый ключ возвращает ту же ошибку.

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, оплата из РФ.

Руководства по API →