Справочник ошибок API нейросетей
29 разборов: коды ответов, ошибки провайдеров, инструменты и настройка. Каждая страница начинается с ответа, а не с предыстории.
Сначала код, потом текст, потом инструмент
Любая ошибка API нейросети раскладывается на три вопроса. Какой код ответа: 4xx значит, что проблема в запросе или в доступе, 5xx, что на стороне сервиса. Что написано в теле: поле type или code у OpenAI, error.type у Anthropic, status у Gemini уточняют причину точнее кода. И где вы это увидели: терминал, Cursor, Cline, n8n показывают одну и ту же ошибку по-разному.
Справочник устроен по этим трём вопросам. В разделе «Коды ответов» каждый код разобран отдельно, с ответом на главный вопрос: повторять или чинить. «По провайдерам» собирает то, что специфично для OpenAI, Anthropic, Gemini, DeepSeek, OpenRouter и Groq, включая ключи и оплату из России. «Инструменты» про то, что именно сломалось в Cursor, Claude Code, Codex CLI, Copilot и как подключить свой ключ в Cline и Open WebUI. «Настройка» про ключи, base URL, прокси.
Если вы не знаете, с чего начать, начните с таблицы кодов ниже: в ней есть ссылка на разбор каждого.
Четыре раздела справочника
Коды ответов
400, 401, 402, 403, 404, 429, 5xx и таймауты: что значит код, чем отличается от соседнего и какие ошибки безопасно повторять.
По провайдерам
OpenAI, Anthropic, Gemini, DeepSeek, OpenRouter, Groq: как получить ключ, чем оплатить из России и как читать их ошибки.
Инструменты
Cursor, Claude Code, Codex CLI, Copilot, Cline, Open WebUI: что именно не работает из России и как подключить свой ключ.
Настройка
Ключи, base URL, переменные окружения, прокси и VPN: где вписать и почему ломается.
Коды ошибок API: что значит и что делать
| Код | Что значит | Типичный текст | Что делать |
|---|---|---|---|
| 400 | Запрос собран неверно | invalid_request_error, unsupported parameter | Проверить JSON и поля |
| 401 | Ключ не узнан | invalid api key, missing authentication header | Разбор 401 и invalid API key |
| 402 | Нет денег на запрос | insufficient credits | Пополнить или снизить max_tokens |
| 403 | Действие запрещено | unsupported_country_region_territory, permission_error | Разбор 403 и страна не поддерживается |
| 404 | Нет такого пути или модели | model not found, not found | Проверить base URL и имя модели |
| 429 | Слишком часто или кончилась квота | rate limit exceeded, insufficient_quota | Повтор с паузой либо пополнение |
| 500, 502, 503 | Сбой на стороне сервиса | server_error, bad gateway, service unavailable | Повторить через 5–30 секунд |
| timeout | Ответ не пришёл вовремя | timeout, connection error | Поднять таймаут, проверить сеть |
Тексты ошибок приведены как в ответах OpenAI и Anthropic; у совместимых сервисов формулировки могут отличаться, коды те же.
Коды ответов
400, 401, 402, 403, 404, 429, 5xx и таймауты: что значит код, чем отличается от соседнего и какие ошибки безопасно повторять.
Ошибка 400 API
Запрос собран неверно: JSON, имена полей, max_tokens, формат messages.
Ошибка 401 API
Сервер не узнал ключ: missing authentication header, invalid api key.
Insufficient credits (402)
На счёте нет денег на этот запрос, даже если баланс не нулевой.
Ошибка 403 API
Ключ узнан, но действие запрещено: страна, план, модель, права ключа.
Unsupported country, region, territory
403 из России и что на самом деле помогает.
Ошибка 404 API
Нет такого пути или модели: base URL без /v1, опечатка в имени модели.
Rate limit exceeded (429)
Частота или квота, повторы с паузой, лимиты по уровням.
Ошибки 500, 502 и 503
Internal server error, bad gateway, service unavailable: когда повторять и как.
Таймаут и connection error
Запрос не дождался ответа или не соединился: где чинить, сколько ждать.
По провайдерам
OpenAI, Anthropic, Gemini, DeepSeek, OpenRouter, Groq: как получить ключ, чем оплатить из России и как читать их ошибки.
Ошибки API OpenAI
Как читать тело ответа: type, code, message, и что делать с каждым.
Как получить API-ключ OpenAI
Где выдаётся, где ломается из России, что вместо.
Invalid API key
Восемь причин, почему ключ не принимают, и проверка одной командой.
Сервисы OpenAI недоступны в вашей стране
Сообщение при входе в ChatGPT и что оно значит для API.
Anthropic API из России
Ключ, base URL, оплата, ошибки credit balance too low и 403.
Gemini API из России
Ключ в AI Studio, оплата, API key not valid, location not supported.
Gemini не работает в России
Приложение, сайт и API: что закрыто, что работает, чем заменить.
DeepSeek API: ключ и оплата из России
Как получить ключ, чем пополнить, server busy и 402.
OpenRouter в России
Пополнение, ошибки 402 и 403, чем заменить.
Provider returned error
Что значит ошибка агрегатора и как её обойти сменой маршрута.
Groq API из России
Ключ, бесплатный уровень, лимиты, что доступно из России.
Инструменты
Cursor, Claude Code, Codex CLI, Copilot, Cline, Open WebUI: что именно не работает из России и как подключить свой ключ.
Cursor не работает в России
Что закрыто, что нет, чем заменить.
Claude Code не работает: 403 и invalid API key
Вход, регион, ключ и base URL в терминале.
Codex CLI из России
Установка, config.toml, свой провайдер и ключ.
GitHub Copilot не работает в России
Not available in your location: причина и чем заменить.
Cline: настройка API
OpenAI Compatible, три поля, типичные ошибки.
Open WebUI: подключение моделей по API
Connections, base URL, почему список моделей пустой.
Настройка
Ключи, base URL, переменные окружения, прокси и VPN: где вписать и почему ломается.
Частые вопросы
Чем 401 отличается от 403?
При 401 сервер не понял, кто вы: ключа нет или он неверный. При 403 понял, но запретил: страна, план или модель недоступны для этого ключа.
Почему 429 приходит при пустом балансе?
У OpenAI исчерпанная квота и превышение частоты отдаются одним кодом 429. Различаются полем type: insufficient_quota против rate_limit_exceeded.
Какие ошибки безопасно повторять?
429 с паузой, 500, 502, 503 и таймауты. Ошибки 400, 401, 402, 403 и 404 повторять бессмысленно, пока не исправлена причина.
Ошибка не из этого списка, что делать?
Напишите нам в Telegram @kosareva_cloud с текстом ошибки и названием инструмента. Если ошибка повторяется у нескольких клиентов, разбор появится в справочнике.
Зачем этот справочник у нас
Большинство обращений в нашу поддержку начинаются с одной из этих ошибок, и почти всегда причина в двух-трёх строках настроек. Мы собрали разборы так, чтобы ответ был в первом абзаце, а дальше шли детали по инструментам. Наш API OpenAI-совместимый и Anthropic-совместимый, поэтому всё написанное относится и к нему.
Полезные страницы
Ключ, который работает из России
OpenAI-совместимый адрес, оплата в рублях, ключ сразу после регистрации.