Шпаргалка
401 Unauthorized — Invalid token
Причина. Сервер не принял ваш ключ. Возможные причины:- Подставлен не тот ключ: должен быть ключ RuAPI (
sk-...), а не официальный ключ OpenAI (sk-...) или Anthropic (sk-ant-...). Внешне ключи OpenAI и RuAPI похожи, но рабочий — только из вашей Консоли RuAPI. - В ключ затесались лишние пробелы или перенос строки при копировании — частая беда при копи-пасте.
- Ключ отключён, удалён или истёк срок его действия.
- Ключ исчерпал свой бюджет (если вы задавали бюджет при создании). Общий баланс при этом может быть положительным — бюджет закончился именно у этого ключа.
Решение.
- Откройте Консоль → API-ключи и убедитесь, что ключ активен, срок не истёк, а лимит не исчерпан. При необходимости скопируйте ключ заново.
- Вставьте ключ без пробелов в начале и конце, без переноса строки.
- Проверьте, что заголовок именно
Authorization: Bearer sk-...(OpenAI-протокол) илиx-api-key: sk-...(Anthropic-протокол).
403 — недостаточно средств
Причина. На счёте закончились деньги (или их не хватает на запрос). Запросы не выполняются, пока вы не пополните баланс. Решение.- Пополните баланс в USDT / USDC или банковской картой — минимум 5 $. Криптовалюта зачисляется обычно за 1–5 минут, оплата картой — за секунды.
- Учтите: агентные инструменты (Claude Code, Cline, автономные агенты) и длинный контекст сжигают токены очень быстро — десятки запросов за минуту — это норма.
- Чтобы случайно не уйти в ноль на одном проекте, задайте бюджет ключа в разделе Консоль → API-ключи — ключ перестанет работать при достижении суммы, а остальные продолжат.
403 — ключу не разрешена модель или не хватает лимита ключа
Эти ошибки — про настройки самого ключа, а не про баланс аккаунта.404 — неверный адрес
Причина. Запрос ушёл по несуществующему пути. Почти всегда дело вbase_url, и зависит оно от протокола:
Решение. Проверьте
base_url по таблице выше. Подробный разбор адресов — в справочнике API.
400 — проблема в самом запросе
Причина. Модель не может принять содержимое запроса; точная причина — вerror.message. Чаще всего это:
- Схема инструментов (JSON Schema), которую модель не понимает. В сообщении — текст ошибки от провайдера модели, например
Invalid JSON payload receivedилиUnknown name …. Для моделей Gemini мы заранее убираем из схемы то, что Gemini не принимает ($schema,additionalPropertiesи т. п.); если проблема осталась, вы увидите её как есть. - Картинка или файл не открываются: ссылка недоступна из интернета, файл повреждён или данные base64 обрезаны (например,
Invalid image url). - Параметры продолжения предыдущего ответа в
/v1/responses: см. ниже.
error.message. Раньше такие ошибки иногда приходили как 500, теперь — 400 с причиной.
Генерация видео: коды ошибок reference_video_task_id. При повторном использовании готового видео через reference_video_task_id может прийти ref_task_not_found, ref_task_not_ready, ref_task_failed, ref_task_expired, ref_task_unavailable или unsupported_by_channel; деньги при этом не списываются. Что означает каждый код и что делать — в разделе «Повторное использование готового видео» руководства по генерации видео.
Генерация видео: ошибки модерации Seedance. Коды вроде input_contains_real_person, input_copyright_restricted, InputImageSensitiveContentDetected.PrivacyInformation, ...PolicyViolation или OutputVideoSensitiveContentDetected (первые два приходят в ответе при отправке, официальные коды ModelArk — в поле error задачи) означают, что запрос или готовое видео не прошли модерацию самой модели Seedance. Деньги за отклонённую задачу не списываются. Разбор каждого кода: реальный человек на фото или видео, авторские права и недопустимый контент.
/v1/responses: продолжение предыдущего ответа не поддерживается
RuAPI не хранит диалоги на сервере, поэтому Responses API не поддерживает previous_response_id, conversation и фоновый режим background. Запрос с этими параметрами сразу получает 400 (деньги не списываются), в ошибке указано, какой параметр мешает. Передавайте всю историю диалога в input в каждом запросе — Codex CLI по умолчанию так и делает, его это не касается.
503 — модель недоступна (model_not_found)
Причина. Почти всегда — модели с таким ID нет в каталоге. Имя в полеmodel должно точно совпадать с ID со страницы цен — вплоть до дефисов, префикса и регистра (GLM-5.2 и glm-5.3 — разные написания, kimi/kimi-k3 пишется с префиксом). Алиасы и «примерные» названия не сработают.
В ответе будет "code": "model_not_found", а в error.message — текст: Модель gpt-5 недоступна. Проверьте точное название модели на странице «Цены» или повторите запрос позже.
Решение. Скопируйте ID модели со страницы цен и подставьте его в model без изменений. Если ID точно верный — модель временно недоступна: повторите запрос через минуту.
429 — Too Many Requests / rate limit
Причина. Слишком много запросов за короткий промежуток — либо ваш код шлёт их пачкой, либо провайдер модели временно ограничивает поток. У RuAPI тоже есть ограничение на частоту запросов для каждого аккаунта; обычной работе, в том числе агентам, оно не мешает. Решение.- Сбавьте темп и повторяйте с экспоненциальной задержкой (backoff): 1 с, 2 с, 4 с, 8 с…
- Распределите нагрузку во времени, не отправляйте сотни запросов одновременно.
- Для пакетной обработки добавьте небольшую паузу между запросами или ограничьте число параллельных потоков.
video_concurrency_limit. У аккаунта одновременно может быть не больше 3 незавершённых видеозадач. Следующая задача сразу получает 429 с кодом video_concurrency_limit и заголовком Retry-After: 30, деньги за неё не списываются. Дождитесь, пока одна из задач завершится, и отправьте запрос снова. Если нужно больше параллельных задач, напишите в поддержку — на support@ruapi.ai или в Telegram @RuAPI_Support. Подробнее — в руководстве по генерации видео.
5xx — 500 / 502 / 503 / upstream error
Причина. Временный сбой на стороне провайдера модели или шлюза. Это не проблема вашего ключа или кода. (Исключение —503 с кодом model_not_found: это почти всегда опечатка в имени модели, см. выше.)
Решение.
- Повторите запрос через несколько секунд — чаще всего со второй-третьей попытки проходит.
- Заверните вызовы в retry с backoff, чтобы такие всплески не роняли ваш скрипт.
- Если ошибка держится долго и повторяется на разных моделях — напишите на support@ruapi.ai и приложите номер запроса (
request id) из текста ошибки.
Обрывы стриминга и таймауты
Длинные ответы (большой контекст, рассуждающие модели, генерация кода) могут идти десятки секунд. Если соединение рвётся на середине стрима или клиент отваливается по таймауту — увеличьтеtimeout в SDK (для тяжёлых запросов ставьте 60–120 с и выше), убедитесь, что между вами и RuAPI нет прокси, обрывающего долгие SSE-соединения, и не отключайте стриминг для длинных ответов — именно он не даёт запросу упасть по таймауту.
Ошибки Claude Code
«Unable to connect to Anthropic services», «Invalid API key · Please run /login» и другие ошибки, которые показывает сам Claude Code, разобраны на странице Claude Code в России.Ошибка пришла не от RuAPI, а напрямую от OpenAI, Google, Anthropic или DeepSeek
Если вы обращаетесь к официальному API напрямую и получаете отказ из-за региона, — разбор по каждой ошибке:unsupported_country_region_territory(403, OpenAI) — OpenAI: unsupported_country_region_territoryUser location is not supported for the API use(400, Gemini) — Gemini: User location is not supportedRequest not allowed(403) иnot allowed from unsupported countries(400, Claude) — Claude: Request not allowed
Insufficient Balance (402) — DeepSeek: 402 Insufficient Balance.
Всё ещё не работает?
Напишите в поддержку в Telegram или на support@ruapi.ai: приложите код ошибки, полный текст изerror.message (вместе с request id), имя модели и время запроса — и мы быстро разберёмся.