Справочник ошибок API нейросетей
33 разборов: коды ответов, ошибки провайдеров, инструменты и настройка. Каждая страница начинается с ответа, а не с предыстории.
Коротко: любую ошибку API читают по трём признакам: HTTP-код, поле type или code в теле ответа и инструмент, где она всплыла. 4xx — проблема в запросе, ключе или доступе, её чинят, а не повторяют. 429, 5xx и таймауты — повторяют с паузой. Из России чаще всего встречаются 401 invalid api key, 403 unsupported country и 402 insufficient credits.
Четыре раздела справочника
Коды ответов
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: что значит и что делать
Нажмите на код — откроется подробный разбор: откуда берётся ошибка, порядок действий и настройки в Cursor, Cline, n8n и SDK.
| Код | Что значит | Типичный текст | Что делать |
|---|---|---|---|
| 400 | Запрос собран неверно | invalid_request_error, unsupported parameter | Проверить JSON и поля |
| 401 | Ключ не узнан | invalid api key, missing authentication header | Проверить ключ и заголовок, частый случай — invalid API key |
| 402 | Нет денег на запрос | insufficient credits | Пополнить или снизить max_tokens |
| 403 | Действие запрещено | unsupported_country_region_territory, permission_error | Смотреть тело ответа, из России — страна не поддерживается |
| 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; у совместимых сервисов формулировки могут отличаться, коды те же.
По провайдерам
OpenAI, Anthropic, Gemini, DeepSeek, OpenRouter, Groq: как получить ключ, чем оплатить из России и как читать их ошибки.
Инструменты
Cursor, Claude Code, Codex CLI, Copilot, Cline, Open WebUI: что именно не работает из России и как подключить свой ключ.
Cursor не работает в России
Что закрыто, что нет, чем заменить.
Claude Code не работает: 403 и invalid API key
Вход, регион, ключ и base URL в терминале.
Codex CLI в России
Почему не работает вход, нужен ли VPN, установка и свой провайдер.
Лимиты Codex
Окно 5 часов, недельный лимит, сброс и что делать, когда лимит кончился.
Antigravity не работает в России
Страна аккаунта, Agent terminated due to error, ошибка 400 и чем заменить.
GitHub Copilot не работает в России
Not available in your location: причина и чем заменить.
Cline: настройка API
OpenAI Compatible, три поля, типичные ошибки.
Open WebUI: подключение моделей по API
Connections, base URL, почему список моделей пустой.
Настройка
Ключи, base URL, переменные окружения, прокси и VPN: где вписать и почему ломается.
Частые вопросы
Зачем этот справочник?
Большинство обращений в нашу поддержку начинаются с одной из этих ошибок, и причина почти всегда в двух-трёх строках настроек. Разборы написаны так, чтобы ошибку можно было починить самому: ответ в первом абзаце, дальше порядок действий и настройки по инструментам.
Для кого он?
Для разработчиков и команд, которые подключают нейросети по API из России: в коде, в Cursor и VS Code, в Claude Code, n8n и чат-ботах. И для тех, у кого перестали открываться ChatGPT, Gemini или Copilot.
Какие ошибки здесь разобраны?
Коды ответов 400, 401, 402, 403, 404, 429, 500–503 и таймауты. Ошибки провайдеров: invalid api key, insufficient credits, unsupported country, provider returned error. Отказы Cursor, Claude Code, Codex CLI и Copilot из России. Всего 33 разборов.
С чего начать, если ошибка непонятна?
С кода ответа: он есть почти в любом сообщении об ошибке. Найдите его в таблице кодов выше, там ссылка на разбор. Если кода нет, ищите по названию провайдера или инструмента в разделах.
Моей ошибки нет в справочнике — что делать?
Напишите нам в Telegram @kosareva_cloud с текстом ошибки и названием инструмента. Если ошибка повторяется у нескольких людей, разбор появится в справочнике.
Полезные страницы
Ключ, который работает из России
OpenAI-совместимый адрес, оплата в рублях, ключ сразу после регистрации.