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 порядок такой:

  1. Войти в аккаунт OpenRouter.
  2. Открыть страницу Keys.
  3. Задать имя ключа. По имени потом видно, какой проект или агент его использует.
  4. Указать кредитный лимит или выбрать вариант без лимита.
  5. Сохранить ключ в переменную окружения, например OPENROUTER_API_KEY, а не в код.

Уже созданными ключами управляют в настройках ключей.

Отдельный случай — ключи, созданные при онбординге. Они получают лимит $100 и истекают через 180 дней. Если ключ, полученный при регистрации, через несколько месяцев перестал работать, стоит проверить именно срок.

Остаток лимита и счётчик бесплатных запросов ключа показывает отдельный эндпоинт (документация о лимитах, на 29.10.2026):

bash
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

Меняются три вещи:

  1. base_url: https://openrouter.ai/api/v1 на https://api.zukko.pro/v1;
  2. ключ OpenRouter на ключ fetch_...;
  3. имена моделей: у Zukko id без префикса вендора, например claude-sonnet-5.
bash
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:

bash
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 подключаются через другие переменные:

bash
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.

OpenRouterZukko
Где создать ключстраница Keys в аккаунтекабинет, раздел API-ключей
Ограничения ключакредитный лимит, сброс daily/weekly/monthly, дата истечениядневной и месячный лимит в долларах, список разрешённых моделей
Лимит исчерпанзапросы отклоняются429 с кодом лимита
Base URL для OpenAI SDKhttps://openrouter.ai/api/v1https://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.