OpenRouter в России: API-ключ, пополнение, ошибки 402 и 403 и чем заменить

Один ключ на сотни моделей — удобно, пока дело не доходит до оплаты. Разбираем, как выдаётся ключ, что работает из России, что нет, и куда смотреть, если карта не проходит.

Получить ключ Что делать

Коротко: OpenRouter — агрегатор нейросетей: один ключ и один OpenAI-совместимый адрес, за которым стоят модели OpenAI, Anthropic, Google, DeepSeek и десятков других поставщиков. Запросы из России он принимает, регистрация проходит, API-ключ создаётся в разделе Keys. Без оплаты ключ работает только с бесплатными моделями, до 50 запросов в день. Ломается всё на пополнении: баланс пополняется картой или криптовалютой, и карты российских банков не проходят.

/ Подробнее

Что важно знать

Отсюда три обходных пути: зарубежная виртуальная карта, криптовалюта или посредник, который зачисляет кредиты за рубли. Все три означают, что деньги идут через третью сторону, а закрывающих документов по российским правилам для бухгалтерии не будет.

Ошибки у OpenRouter свои. 402 — не хватает кредитов на этот запрос, причём с учётом резерва под max_tokens. 403 — модерация, защитный фильтр, исчерпанный лимит ключа или модель, закрытая для вашей страны. 408 — таймаут поставщика, 502 Provider returned error — сбой на его стороне. Если главной проблемой стала оплата, а не ошибки, вариант — сервис с тем же OpenAI-совместимым API и оплатой в рублях: в коде меняется одна строка с base_url.

/ На kosareva.cloud

Замена OpenRouter с оплатой в рублях

Тот же принцип — один ключ ко многим моделям, но с оплатой в рублях. Моделей меньше, чем у OpenRouter: редкую сначала поищите в каталоге.

Адрес: https://api.kosareva.cloud/v1, ключ из кабинета
Оплата: Карта РФ или СБП от 50 ₽, компаниям — по счёту
Доступ: Без VPN, запросы идут с российских IP

Получить ключ

from openai import OpenAI

client = OpenAI(
    api_key="ВАШ_API_КЛЮЧ",
    base_url="https://api.kosareva.cloud/v1",
)

response = client.chat.completions.create(
    model="gpt-5-6",
    messages=[{"role": "user", "content": "Привет!"}],
    stream=True,
)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "ВАШ_API_КЛЮЧ",
  baseURL: "https://api.kosareva.cloud/v1",
});

const response = await client.chat.completions.create({
  model: "gpt-5-6",
  messages: [{ role: "user", content: "Привет!" }],
  stream: true,
});

curl https://api.kosareva.cloud/v1/chat/completions \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5-6","messages":[{"role":"user","content":"Привет!"}],"stream":true}'

/ Почему

Откуда берутся отказы

Карта РФ отклонена

Платёжная форма OpenRouter не проводит карты российских банков. Ошибка появляется на этапе оплаты, аккаунт и ключ при этом живые.

402 Insufficient credits

Кредитов не хватает на худший случай запроса: цена выхода умножается на max_tokens. Поэтому 402 бывает и при ненулевом остатке.

403 на запросе

Ввод не прошёл модерацию, сработал защитный фильтр (guardrail), кончился лимит ключа или бюджет, либо модель закрыта для вашей страны. Новый ключ тут не поможет, а лимит текущего проверить стоит.

408 Request timeout

Поставщик модели не ответил вовремя. Чаще на длинных запросах без стриминга и на загруженных моделях.

502 Provider returned error

Сломалось у поставщика, а не у OpenRouter. Помогает повтор или другой маршрут через provider.order.

Access denied by security policy

В документации OpenRouter такого текста нет (проверено 30.10.2026). Если ответ пришёл не JSON-объектом error, его, скорее всего, вернул кто-то на пути: корпоративный прокси, антивирус или VPN.

/ Тексты ошибок

Ошибки OpenRouter: текст, причина, что делать

Текст ошибки	Причина	Что делать
402 Insufficient credits	Кредитов не хватает на запрос с учётом резерва под max_tokens	Пополнить или уменьшить max_tokens; запрос не выполнен и не списан
403 Forbidden	Модерация ввода, защитный фильтр, исчерпанный лимит ключа или бюджета, модель закрыта для вашей страны	Прочитать error.metadata: там причина и, для лимита, дата сброса. Лимит поднять на странице ключа, запрос смягчить, модель сменить
408 Request timeout	Поставщик не ответил в отведённое время	Включить стриминг, повторить, увеличить timeout в клиенте
502 Provider returned error	Сбой у поставщика модели	Повторить через несколько секунд, разрешить allow_fallbacks, сменить модель
401 No auth credentials found	Ключ не передан или передан не в том заголовке	Проверить Authorization: Bearer и что ключ не пустой
Access denied by security policy	В документации OpenRouter такого текста нет: ответ мог прийти не от него	Посмотреть сырой ответ. Если это не JSON с объектом error, искать прокси, антивирус или VPN на пути. Если JSON с кодом 403, см. строку выше

Тело ошибки в формате OpenAI: объект error с полями code и message, у 502 внутри ещё и сырой ответ поставщика. Коды и причины 403 — по документации OpenRouter, проверено 30.10.2026.

/ Что делать

Порядок действий

Прочитайте тело ответа

Код и текст говорят, что делать: 402 — деньги, 403 — смотрите error.metadata (модерация, фильтр, лимит ключа или страна), 408 и 502 — сбой у поставщика. Новый ключ нужен только при 401.

Уменьшите max_tokens при 402

Резерв считается от заявленного максимума. Если ответы обычно короткие, не ставьте 32 000 «на всякий случай».

response = client.chat.completions.create(
    model="anthropic/claude-sonnet-5",
    max_tokens=1000,
    messages=[{"role": "user", "content": "ping"}],
)

Пополните баланс доступным способом

Зарубежная карта, криптовалюта или посредник за рубли. Кладите столько, сколько готовы потерять при споре: поддержка OpenRouter посредникам не помогает.

При 403 и 502 переключите маршрут

У одной модели бывает несколько поставщиков. Поле provider задаёт, кого пробовать первым и разрешено ли переключаться на остальных.

response = client.chat.completions.create(
    model="deepseek/deepseek-chat",
    messages=[{"role": "user", "content": "ping"}],
    extra_body={"provider": {"allow_fallbacks": True}},
)

Если платить негде, смените точку входа

Любой OpenAI-совместимый сервис подключается той же строкой base_url. Имена моделей у каждого свои, проверьте по каталогу.

client = OpenAI(
    api_key="ваш ключ",
    base_url="https://api.kosareva.cloud/v1",
)

/ По инструментам

Где это чинится в разных инструментах

Cursor, Cline, Continue

Провайдер OpenRouter или OpenAI Compatible. Ошибки 402 и 403 приходят в чат текстом; пополнение делается только на сайте OpenRouter.

Python и Node.js SDK

Обычный клиент OpenAI с base_url OpenRouter. Параметры маршрута передаются через extra_body, исключения те же, что у OpenAI.

n8n, Make

Нода OpenRouter или OpenAI с переопределённым адресом. 402 останавливает сценарий до пополнения, повторы не помогают.

Open WebUI

Раздел Connections: адрес и ключ, модели подтянутся списком. Ошибки 402 и 403 придут уже в чате при запросе.

/ API-ключ

Как получить ключ OpenRouter и что с ним из России

По документации и условиям OpenRouter, проверено 30.10.2026. Сам ключ из России получить можно, ограничения начинаются дальше: оплата и часть моделей.

Где выдаётся

После регистрации ключ создаётся в разделе Keys личного кабинета OpenRouter. Ему дают имя и, по желанию, лимит в долларах, в том числе с ежедневным, недельным или месячным сбросом. Ключ передаётся в заголовке Authorization: Bearer, адрес API — /api/v1 на домене OpenRouter.

Ключ из онбординга

Ключ, который OpenRouter создаёт при первом входе, получает лимит $100 и истекает через 180 дней. Для постоянной работы лучше выпустить свой.

Без оплаты

Ключ работает только с бесплатными вариантами моделей (с суффиксом :free): 20 запросов в минуту и 50 в день. После покупки от 10 кредитов — 1 000 в день. Платные модели без баланса отвечают 402.

Оплата из России

OpenRouter принимает банковские карты, AliPay и криптовалюту USDC. Карты российских банков не проходят. Неиспользованные кредиты могут сгореть через год после покупки, возврат за них можно запросить только в первые 24 часа, а криптоплатёж не возвращается вовсе.

Модели с ограничением по стране

По условиям OpenRouter (п. 5.7, редакция 31.08.2026) часть поставщиков не разрешает доступ к своим моделям из отдельных стран, и через OpenRouter к таким моделям обращаться нельзя. Поставщики отвечают на такие запросы 403, у OpenRouter это отдельная категория отказов.

Если ключ утёк

OpenRouter участвует в программе GitHub secret scanning и присылает письмо, если находит ключ в открытом доступе. Такой ключ удаляют и выпускают новый.

/ FAQ

Частые вопросы

Как получить API-ключ OpenRouter?

Зарегистрироваться и создать ключ в разделе Keys: задать имя и, если нужно, лимит в долларах. Ключ передаётся в заголовке Authorization: Bearer, подходит к OpenAI SDK со сменой base_url. Без пополнения он работает только с бесплатными моделями: 20 запросов в минуту и 50 в день.

Почему OpenRouter отвечает 403?

По документации OpenRouter 403 бывает, когда ввод не прошёл модерацию, сработал защитный фильтр или кончился лимит ключа либо бюджета; причина и дата сброса лежат в error.metadata. Есть и страновая причина: по условиям OpenRouter часть поставщиков не разрешает доступ к своим моделям из отдельных стран. Если 403 приходит только на одной модели, попробуйте другую.

OpenRouter не работает или заблокирован: что делать?

Сначала посмотрите код ответа. При 502 сломалось у поставщика модели, при 503 не нашлось поставщика под ваши настройки маршрута: помогают повтор и другая модель. 401 говорит о ключе, 402 о балансе, 403 о модерации, лимите или стране. Если не проходит оплата, это отдельная история: что делать, если OpenRouter перестал принимать карты.

Можно ли пополнить OpenRouter картой российского банка?

Нет. По справке OpenRouter на 30.10.2026 он принимает банковские карты, AliPay и криптовалюту USDC, но карты российских банков за рубежом не работают с 2022 года. Остаются зарубежные карты, криптовалюта и посредники, которые зачисляют кредиты за рубли.

Выдаст ли OpenRouter документы для бухгалтерии?

Договора, счёта и акта по российским правилам у него нет. При оплате через посредника документы, если они есть, выдаёт посредник.

Подходит ли ключ OpenRouter к OpenAI SDK?

Да, формат совместим, нужно сменить base_url. Верно и обратное: ключ любого совместимого сервиса подставляется тем же способом.

Почему 402 приходит, хотя баланс не нулевой?

OpenRouter резервирует деньги на худший случай: цена выхода умножается на max_tokens. Уменьшите max_tokens до реального размера ответа, и запрос пройдёт.

Чем заменить OpenRouter, если нужна оплата в рублях?

Сервисом с тем же OpenAI-совместимым API: в коде меняются base_url и ключ. У нас модели OpenAI, Anthropic, Google, DeepSeek и другие по одному ключу, карта РФ или СБП от 50 ₽, компаниям — договор и акт. Моделей меньше, чем у OpenRouter.

/ Дальше

Рядом в справочнике

Ключ, который работает из России

OpenAI-совместимый адрес, оплата в рублях, ключ сразу после регистрации. Пополнение картой от 50 ₽.

Получить ключ