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

Пополнить OpenRouter российской картой нельзя: сервис принимает оплату через зарубежный эквайринг, и платёж с карты российского банка на нём отклоняется. Рабочих вариантов три: взять доступ к тем же моделям через российский сервис-шлюз с оплатой в рублях, завести зарубежную карту и привязать её к биллингу OpenRouter или пополнить баланс криптовалютой. Ниже — что даёт каждый, где брать API-ключ после оплаты и как подставить его в Cursor, Cline и другие инструменты.

Статья про платёжную часть и подключение ключа. Способов обхода региональных ограничений здесь нет — только легальные варианты заплатить и рабочая конфигурация после оплаты.

Что такое OpenRouter и почему за него вообще платят

OpenRouter — это шлюз к моделям разных вендоров через один API. Вместо того чтобы заводить отдельные аккаунты и ключи в OpenAI, Anthropic, Google и у остальных, вы получаете один ключ и обращаетесь к любой модели из каталога, меняя только имя модели в запросе. Имя состоит из двух частей — вендор и модель, через слеш: openai/…, anthropic/…, google/….

Главное техническое свойство OpenRouter: его основной API совместим с API OpenAI. Любая библиотека и любой инструмент, которые умеют работать с OpenAI, работают и с OpenRouter — достаточно подменить базовый адрес и ключ. Из этого же свойства растут и ограничения, о которых пойдёт речь ниже.

Баланс работает по предоплате: вы кладёте деньги на счёт, дальше они списываются по факту за токены. Поэтому вопрос «как пополнить» для разработчика из России встаёт раньше, чем вопрос «как подключить».

Способ 1: доступ к моделям через российский шлюз — оплата в рублях

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

Так устроен наш AI для кода. Логика та же, что у OpenRouter: один API-ключ, единый баланс токенов и две экосистемы моделей сразу — Claude от Anthropic (Haiku, Sonnet, Opus) и GPT от OpenAI. Тарифы на подписку: «Помощник» — 499 ₽ в месяц за 2,5 млн токенов, «Напарник» — 1 199 ₽ за 5,5 млн, «Соавтор» — 2 499 ₽ за 12,5 млн. Неизрасходованные токены переносятся на следующий месяц. Если лимит кончился раньше срока, можно либо дождаться обновления в начале месяца, либо сменить тариф — изменение применяется сразу, — либо докупить дополнительный пакет токенов, не трогая подписку.

Отличие от OpenRouter, которое важно понимать заранее:

• каталог моделей уже, чем у мультивендорного шлюза: семейства Claude и GPT, а не всё подряд. Актуальный набор виден прямо в подключённом инструменте;
• у вас не появляется личного кабинета в OpenAI или Anthropic — вы работаете через ключ сервиса;
• оплата идёт российской картой, без зарубежного биллинга, конвертации и посредников.

Зато подключается это туда же, куда и OpenRouter, и даже в чуть более широкий список инструментов: Claude Code, Codex CLI, расширения для VS Code, Cursor, Cline, Windsurf, Neovim. Конкретные конфиги — в разделе про подключение.

Способ 2: зарубежная карта, привязанная к биллингу OpenRouter

Классический вариант, если нужен именно OpenRouter со всем его каталогом. Вам понадобится карта иностранного банка или платёжного сервиса, которая проходит на зарубежном эквайринге. Дальше всё обычно: карта привязывается в разделе биллинга, баланс пополняется на нужную сумму, дальше списания идут по мере расхода токенов.

Что учесть:

• карта должна быть именно рабочей на международных платежах, а не просто выпущенной за рубежом — часть выпусков отклоняется на стороне платёжного провайдера;
• при оплате в валюте добавляется конвертация вашего банка;
• держите на балансе запас: при нуле доступ к API прекращается сразу, и агент в терминале просто перестаёт отвечать посреди работы.

Набор доступных способов оплаты на стороне OpenRouter время от времени меняется — перед пополнением сверьтесь с актуальным списком в биллинге сервиса.

Способ 3: пополнение криптовалютой

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

Подводные камни здесь не в самом OpenRouter, а вокруг него: нужно где-то купить криптовалюту, завести кошелёк и оплатить комиссию сети. Для разовой задачи «попробовать пару моделей» это заметно дороже по времени, чем кажется. Для постоянной работы схема рабочая, но требует, чтобы весь этот контур у вас уже был настроен.

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

Ключ выдаётся в личном кабинете, в разделе с ключами: вы создаёте новый ключ, даёте ему имя и копируете значение. Показывается оно один раз — после закрытия окна значение уже не посмотреть, только выпустить новый ключ взамен.

Опознать ключ легко по префиксу: он начинается с sk-or-v1-. Эта приставка часто попадает в чужие сниппеты и репозитории — если видите её в коде, перед вами именно ключ OpenRouter, а не OpenAI.

Дальше действуют обычные правила обращения с ключом:

• ключ живёт в переменной окружения, а не в коде и не в репозитории;
• на фронтенде его быть не должно — запрос к модели идёт с сервера;
• если ключ утёк, его отзывают в кабинете и выпускают новый, а не «меняют пароль».

Сам по себе выпущенный ключ ещё не означает доступ к платным моделям: пока на балансе нет средств, запрос к платной модели вернёт ошибку. Это частая причина недоумения — ключ есть, а ничего не работает.

Бесплатные модели OpenRouter и суффикс :free

В каталоге есть модели с суффиксом :free в имени — это бесплатные варианты. Обращение к ним выглядит так же, как к платным, разница только в имени модели в запросе.

Бесплатный доступ ограничен по частоте запросов, и это ограничение — главное, что стоит знать до того, как строить на нём рабочий процесс. Кодовый агент, который ходит в модель десятки раз за задачу, упирается в лимит почти сразу: вы получаете ошибку ограничения частоты вместо ответа и половину сделанной работы. Бесплатные модели хорошо подходят, чтобы проверить интеграцию и посмотреть на качество ответов, и плохо — чтобы каждый день писать с ними код.

Бесплатный тариф не отменяет и вопрос пополнения: чтобы перейти на платные модели, счёт всё равно придётся пополнить одним из способов выше.

Как подключить OpenRouter в коде и в инструментах

Поскольку API совместим с OpenAI, официальная библиотека OpenAI работает без изменений — меняются только baseURL и ключ:

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.OPENROUTER_API_KEY,
  baseURL: 'https://openrouter.ai/api/v1',
});

const response = await client.chat.completions.create({
  // имя модели — в формате «вендор/модель», точный слаг берите
  // из каталога моделей в интерфейсе OpenRouter
  model: '<vendor>/<model>',
  messages: [
    { role: 'user', content: 'Объясни, что делает Array.prototype.flat()' },
  ],
});

console.log(response.choices[0].message.content);

Здесь происходит вот что: клиент OpenAI создаётся с чужим базовым адресом, поэтому все запросы уходят на OpenRouter, а не в OpenAI; ключ подтягивается из переменной окружения; chat.completions.create отправляет обычный запрос к модели и возвращает объект, где текст ответа лежит в первом элементе choices. Тот же приём работает в Python-библиотеке openai — там за это отвечает аргумент base_url.

В инструментах с полем Base URL — Cline, Windsurf и подобных — схема та же: выбирается провайдер, совместимый с OpenAI, в поле базового адреса вписывается https://openrouter.ai/api/v1, в поле ключа — ваш sk-or-v1-…, модель выбирается из списка.

В Cursor базовый адрес OpenAI переопределяется в настройках моделей: там есть отдельное поле для своего адреса и своего ключа. После сохранения редактор ходит в модель через указанный вами шлюз.

С Claude Code так не получится. Claude Code разговаривает с сервером на языке Anthropic API, а не OpenAI-совместимого, поэтому подставить в него ключ OpenRouter вместо ANTHROPIC_API_KEY недостаточно — нужен шлюз, который отвечает в формате Anthropic. Именно поэтому в инструкции нашего сервиса указывается отдельный адрес для Anthropic:

export ANTHROPIC_API_KEY="ваш ключ"
export ANTHROPIC_BASE_URL="https://app.purpleschool.ru/api-v2/public/ai-proxy/anthropic"

Эти две строки добавляются в ~/.zshrc или ~/.bashrc, после чего конфиг перечитывается командой source ~/.zshrc. Первая задаёт ключ, вторая уводит все запросы Claude Code на шлюз вместо серверов Anthropic. Подробный разбор с онбордингом и типовыми ошибками — в статье Claude Code в России.

Для Codex CLI логика другая: он берёт провайдера из ~/.codex/config.toml.

model = "<MODEL_NAME>"
model_provider = "purpleschool"

[model_providers.purpleschool]
name = "PurpleSchool OpenAI Proxy"
base_url = "https://app.purpleschool.ru/api-v2/public/ai-proxy/openai/v1"
env_key = "PURPLESCHOOL_API_KEY"
wire_api = "responses"
supports_websockets = false

Блок добавляется в конфиг, не удаляя остальные настройки, а ключ кладётся в переменную PURPLESCHOOL_API_KEY. Установка и разбор по шагам — в статье Codex в России.

Что выбрать

Коротко: если у вас уже есть рабочая зарубежная карта и нужен широкий каталог моделей, включая экзотику, — берите OpenRouter, он для этого и сделан. Если задача приземлённее — каждый день писать код с Claude или GPT в привычном редакторе и не заниматься платёжной акробатикой, — рублёвый шлюз закрывает её быстрее и без посредников.

Если вы выбираете не между шлюзами, а между шлюзом и прямой оплатой провайдеру, посмотрите разбор как оплатить OpenAI из России — там те же способы, но применительно к аккаунту в самой OpenAI.

Подключить модели с оплатой в рублях можно на странице AI для кода: там же лежат пошаговые инструкции для Claude Code, Codex CLI, VS Code, Cursor, Cline, Windsurf и Neovim под macOS, Windows и Linux.