OpenRouter API key: как получить ключ, настроить лимиты и чем заменить из России
Где создать ключ OpenRouter, какие у него настройки, сколько стоит пополнение и как работают лимиты бесплатных моделей. И что делать, если из России не получается оплатить кредиты.
7 мин · · API-ключи · сравнение · оплата
OpenRouter API key создаётся на странице Keys в аккаунте OpenRouter: при создании задают имя и кредитный лимит или выбирают вариант без лимита. Ключ передаётся как Bearer-токен, а в OpenAI SDK указывают base_url https://openrouter.ai/api/v1. Из России трудности обычно возникают не с самим ключом, а с пополнением баланса. Если оплатить кредиты не выходит, тот же код можно направить на ключ Zukko: меняются base URL, ключ и имена моделей.
Условия OpenRouter ниже приведены по документации и странице тарифов, проверено 29.10.2026. Они могут меняться, поэтому перед оплатой их стоит сверить.
Как создать ключ OpenRouter
По документации об аутентификации на 29.10.2026 порядок такой:
- Войти в аккаунт OpenRouter.
- Открыть страницу Keys.
- Задать имя ключа. По имени потом видно, какой проект или агент его использует.
- Указать кредитный лимит или выбрать вариант без лимита.
- Сохранить ключ в переменную окружения, например
OPENROUTER_API_KEY, а не в код.
Уже созданными ключами управляют в настройках ключей.
Отдельный случай — ключи, созданные при онбординге. Они получают лимит $100 и истекают через 180 дней. Если ключ, полученный при регистрации, через несколько месяцев перестал работать, стоит проверить именно срок.
Остаток лимита и счётчик бесплатных запросов ключа показывает отдельный эндпоинт (документация о лимитах, на 29.10.2026):
curl https://openrouter.ai/api/v1/key \
-H "Authorization: Bearer $OPENROUTER_API_KEY"Если в ответ приходит 401, ключ скопирован не полностью, удалён или передан не в том заголовке. Типичные причины разобраны в статье про ошибку 401 Invalid API key.
Лимит, сброс и срок действия ключа
OpenRouter рекомендует ставить кредитный лимит на каждый ключ. Без лимита утёкший ключ или агент, который ушёл в цикл, может потратить весь баланс.
По справочнику API на 29.10.2026 у ключа есть такие настройки:
- кредитный лимит — сколько ключ может потратить;
- сброс лимита — daily, weekly или monthly, в полночь UTC;
- дата истечения.
Когда ключ израсходовал лимит, запросы с ним отклоняются, пока лимит не поднимут или он не сбросится. На практике удобно держать отдельный ключ на каждый проект и каждого агента, с небольшим лимитом и регулярным сбросом. Тогда ошибка в одном месте не съедает бюджет остальных.
Сколько стоит пополнение: комиссии OpenRouter
По странице тарифов и FAQ на 29.10.2026 сами модели продаются по цене провайдера без наценки. Комиссия берётся при покупке кредитов:
- тариф Standard — 5,5%, при оплате картой минимум $0.80;
- тариф Business — 8%.
Как это выглядит на конкретных суммах:
- пополнение $50 на Standard: $50 × 0.055 = $2.75 комиссии;
- пополнение $10 картой: $10 × 0.055 = $0.55, это меньше минимума, поэтому комиссия составит $0.80.
Другие условия, которые стоит знать до оплаты:
- способы оплаты — банковские карты, AliPay и криптовалюта USDC;
- криптоплатежи не возвращаются;
- неиспользованные кредиты можно вернуть только в течение 24 часов, комиссия при этом не возвращается;
- по условиям использования на 29.10.2026 OpenRouter вправе сжечь неиспользованные кредиты через 365 дней после покупки.
Для тех, у кого есть собственные ключи провайдеров, есть режим BYOK: до $25,000 инференса в месяц без комиссии, сверх этого — 5% (по FAQ на 29.10.2026).
Лимиты бесплатных моделей
Модели с суффиксом :free работают с ограничениями (по документации о лимитах на 29.10.2026):
| Условие | Лимит |
|---|---|
| Любой аккаунт | 20 запросов в минуту |
| За всё время куплено меньше 10 кредитов | 50 запросов в день |
| Куплено 10 кредитов или больше | 1000 запросов в день |
Неудачные запросы тоже засчитываются. Дополнительные аккаунты и ключи лимиты не увеличивают: OpenRouter считает их глобально. Для разработки и проверки идей этого обычно хватает, для агентов и постоянной нагрузки — нет.
Почему из России сложно пополнить OpenRouter
Основное препятствие — оплата. OpenRouter принимает банковские карты, AliPay и USDC, а карты российских банков на зарубежных сервисах, как правило, не проходят. Остаются криптовалюта и посредники, у каждого варианта свои издержки и риски. Варианты подробно разобраны в статье об оплате OpenRouter из России.
Есть и второй момент. В условиях OpenRouter Россия отдельно не упоминается, но некоторые провайдеры не пускают пользователей из отдельных стран к своим моделям, и обходить такие ограничения через OpenRouter запрещено. Пользоваться сервисом можно с 18 лет.
Альтернатива: ключ Zukko
Zukko — шлюз к API языковых моделей с OpenAI-совместимым эндпоинтом. Ключ имеет вид fetch_... и создаётся в кабинете, в разделе API-ключей.
Лимиты на ключ
На ключ Zukko можно поставить:
- дневной лимит расхода в долларах;
- месячный лимит расхода в долларах;
- список разрешённых моделей.
Когда лимит исчерпан, запрос получает ответ 429 с кодом key_daily_limit_reached или key_monthly_limit_reached. При нулевом балансе приходит 402. По коду ответа в клиенте видно, что закончилось: лимит ключа или деньги на счёте.
Оплата
Баланс ведётся в долларах, списываются только использованные токены, абонентской платы нет. Пополнение от $1:
| Способ | Условия |
|---|---|
| СБП | в рублях по рыночному курсу, платёжная страница добавляет около 8,5% |
| Криптовалюта | без комиссии сверху |
| Иностранная карта MasterCard | от $2 до $594 за платёж, около 13% сверху |
Российские карты временно не принимаются, в рублях платят через СБП. Пополнение на $10 через СБП: $10 × 0.085 = $0.85 сверху, итого $10 + $0.85 = $10.85 в рублях по курсу. Это оценка, потому что наценка указана как «около 8,5%». Подробности — в документации.
Бесплатного тарифа и стартового бонуса нет. Один раз дают $0.50 за подписку на Telegram-канал @zukkopro.
Пример расхода: claude-sonnet-5 стоит $0.4 за 1M входных и $2 за 1M выходных токенов. Задача на 2M входных и 0.5M выходных токенов обойдётся в 2 × $0.4 + 0.5 × $2 = $0.8 + $1 = $1.80. Актуальный список моделей с ценами отдаёт GET https://api.zukko.pro/v1/models.
Как перенести код с OpenRouter на Zukko
Меняются три вещи:
- base_url:
https://openrouter.ai/api/v1наhttps://api.zukko.pro/v1; - ключ OpenRouter на ключ
fetch_...; - имена моделей: у Zukko id без префикса вендора, например
claude-sonnet-5.
import os
from openai import OpenAI
# Было: OpenRouter
# client = OpenAI(
# base_url="https://openrouter.ai/api/v1",
# api_key=os.environ["OPENROUTER_API_KEY"],
# )
# Стало: Zukko
client = OpenAI(
base_url="https://api.zukko.pro/v1",
api_key=os.environ["ZUKKO_API_KEY"], # ключ вида fetch_...
)
response = client.chat.completions.create(
model="claude-sonnet-5", # id без префикса вендора
messages=[{"role": "user", "content": "Привет"}],
)
print(response.choices[0].message.content)Список доступных id:
curl https://api.zukko.pro/v1/models \
-H "Authorization: Bearer $ZUKKO_API_KEY"Для Cursor, Codex и opencode схема та же: base URL https://api.zukko.pro/v1, ключ fetch_... в поле API key.
Claude Code и Anthropic SDK подключаются через другие переменные:
export ANTHROPIC_BASE_URL=https://api.zukko.pro
export ANTHROPIC_AUTH_TOKEN=fetch_...Здесь base URL указывают без /v1, клиент добавит путь сам. Переменную ANTHROPIC_API_KEY использовать нельзя: с ней Claude Code требует вход в аккаунт Anthropic. Разница между переменными объяснена в статье про ANTHROPIC_API_KEY и ANTHROPIC_AUTH_TOKEN. Полный список того, что поменять в коде и конфигах, — в материале о переезде с OpenRouter.
Сравнение ключей OpenRouter и Zukko
Данные OpenRouter — на 29.10.2026.
| OpenRouter | Zukko | |
|---|---|---|
| Где создать ключ | страница Keys в аккаунте | кабинет, раздел API-ключей |
| Ограничения ключа | кредитный лимит, сброс daily/weekly/monthly, дата истечения | дневной и месячный лимит в долларах, список разрешённых моделей |
| Лимит исчерпан | запросы отклоняются | 429 с кодом лимита |
| Base URL для OpenAI SDK | https://openrouter.ai/api/v1 | https://api.zukko.pro/v1 |
| Id моделей | с префиксом вендора | без префикса, например claude-sonnet-5 |
| Комиссия | 5,5% на Standard (минимум $0.80 картой), 8% на Business | СБП около 8,5%, криптовалюта без комиссии, MasterCard около 13% |
| Способы оплаты | карты, AliPay, USDC | СБП, криптовалюта, иностранная MasterCard |
| Бесплатный доступ | модели :free с дневными лимитами | бесплатного тарифа нет, разово $0.50 за подписку на канал |
Разбор по остальным параметрам — в статье Zukko против OpenRouter.
Частые вопросы
Можно ли пользоваться ключом OpenRouter без пополнения?
Да, для моделей :free. Лимит — 20 запросов в минуту и 50 в день, пока за всё время куплено меньше 10 кредитов (на 29.10.2026). Неудачные запросы тоже учитываются.
Почему ключ OpenRouter перестал принимать запросы?
Частые причины: исчерпан кредитный лимит ключа, истёк срок действия (у ключей из онбординга — 180 дней) или закончился дневной лимит бесплатных моделей. Остаток лимита и счётчик бесплатных запросов показывает GET https://openrouter.ai/api/v1/key.
Подойдёт ли ключ Zukko к коду, написанному под OpenRouter?
Да, если код работает через OpenAI SDK или OpenAI-совместимый формат. Нужно заменить base URL, ключ и имена моделей на id из https://api.zukko.pro/v1/models.
Есть ли у Zukko бесплатные модели или пробный баланс?
Нет. Бесплатного тарифа и стартового бонуса нет, один раз дают $0.50 за подписку на Telegram-канал @zukkopro. Пополнение — от $1.
Как ограничить расход ключа Zukko?
Поставить на ключ дневной и месячный лимит в долларах и при необходимости список разрешённых моделей. После исчерпания лимита запросы получают 429, пока лимит не сбросится или его не поднимут. Вопросы по настройке можно задать в поддержке.
zukko
Платите в 25×
меньше
за Claude Code & ChatGPT
Один ключ fetch_* и base URL api.zukko.pro — в Cursor, Claude Code, Codex и любом SDK.
Похожие статьи
- Подписка Codex: Plus, Pro или API-ключ — что выбрать из РоссииОтдельной подписки Codex нет: он входит в планы ChatGPT, которые из России официально недоступны. Разбираем Plus, Pro и Codex CLI на API-ключе с расчётом месяца работы.
- Как зарегистрироваться в DeepSeek из России и получить доступ к APIРегистрация на платформе DeepSeek и доступ к API из России: что делать по шагам, где чаще всего застревают и как получить модели DeepSeek через шлюз с оплатой СБП.
- Агрегатор API нейросетей: Claude, GPT, Gemini и DeepSeek по одному ключуАгрегатор даёт один ключ и один баланс для моделей разных вендоров. Разбираем, как устроен OpenAI-совместимый API, сколько стоят модели напрямую и через шлюз и на что смотреть при выборе.
- DeepSeek API key: как получить ключ и какой base_url указатьДва пути к ключу DeepSeek: официальная платформа и шлюз Zukko. Разбираем адреса API, имена моделей, проверку ключа и частые ошибки подключения.
- Grok API key: как получить ключ xAI и вызвать Grok 4.7 через шлюзДва пути к Grok: ключ в консоли xAI или ключ шлюза с оплатой СБП, MasterCard и криптой. Что делать по шагам, как выглядит запрос и сколько он стоит.
- Qwen API key: как получить ключ в Alibaba Cloud или через шлюзДва пути к ключу для Qwen: официальный в Model Studio и единый ключ шлюза. Пошаговая инструкция, адреса, идентификаторы моделей и пример запроса.