Ошибки 401, 403 и 404 в API-посреднике: как найти проблему с ключом и моделью

Коды 401, 403 и 404 часто принимают за неисправность провайдера, хотя обычно они указывают на разные настройки. Сначала определите HTTP-код, затем проверьте URL, ключ, идентификатор модели и права аккаунта.

Что означают коды

Код	Типичный смысл	Что проверить первым
401	Аутентификация не пройдена	Authorization и срок действия ключа
403	Личность подтверждена, но доступа нет	Статус аккаунта и разрешения канала
404	Адрес или ресурс не найден	Base URL, путь и ID модели

Всегда учитывайте тело ответа и request ID: посредник может использовать собственные коды. Не записывайте в логи полный ключ и пользовательский prompt.

Ошибка 401: проверьте Authorization

В OpenAI-совместимом API обычно требуется заголовок Authorization: Bearer YOUR_KEY. Ошибки возникают из-за лишних кавычек, пробелов, пустой переменной окружения или использования пароля кабинета вместо API Key.

curl -i https://домен-посредника/v1/models \
  -H "Authorization: Bearer $API_KEY"

Скопируйте ключ заново и убедитесь, что он относится к этому аккаунту и Base URL. Для диагностики можно сохранить только первые и последние четыре символа ключа.

Ошибка 403: права ограничены

Проверьте блокировку аккаунта, баланс, доступ к нужному каналу и ограничения по IP или региону. Если запрос из браузера получает 403, а из командной строки проходит, причиной может быть CORS или политика источника. Храните ключ на сервере и вызывайте собственный backend.

После изменения разрешений подождите синхронизации политики и повторите минимальный запрос с новым request ID.

Ошибка 404: URL или модель

Уточните, не добавлен ли /v1 дважды и соответствует ли путь документации, например /v1/chat/completions. Если URL корректен, проверьте ID модели: название на сайте может отличаться от slug, который требуется в параметре model.

Выведите итоговый URL без секретов и запросите список моделей через /v1/models, если посредник предоставляет такой endpoint. Проверьте регистр символов и доступность модели в вашем канале.

Короткий алгоритм

Выполнить минимальный curl -i и сохранить код, текст ошибки и request ID;
Проверить Base URL, путь, Authorization и ID модели;
Посмотреть баланс, разрешения и политики безопасности в кабинете;
Повторить запрос с коротким prompt и недорогой моделью.

Точные пути и правила доступа зависят от конкретного API-посредника, поэтому сверяйтесь с его актуальной документацией.

Дополнительно: как обрабатывать 429 · проверка AI API перед запуском

Ошибки 401, 403 и 404 в API-посреднике: как найти проблему с ключом и моделью