OpenRouter API key: как получить ключ в 2026

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

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

«Я выпускал ключи OpenRouter не один десяток раз — для своих пайплайнов и для пользователей AI SEO Writer. И почти все обращения в поддержку по этой теме сводились не к выпуску ключа, а к двум вещам: человек не сохранил секрет при создании и не заметил, что баланс нулевой», — Богдан, автор блога AI SEO Writer.

Что такое OpenRouter и зачем ему отдельный ключ

Одна регистрация закрывает доступ сразу к моделям десятка провайдеров — OpenAI, Anthropic, Google, Meta, Mistral, DeepSeek и других. Не нужно заводить аккаунт в каждом сервисе, проходить их проверки и хранить пять разных секретов.

OpenRouter — платформа-агрегатор: она принимает запрос, сама выбирает провайдера по цене и доступности и возвращает ответ. По подсчётам обзора на Habr, в каталоге больше 400 моделей: флагманские платные и открытые модели с бесплатным доступом. Список доступных вариантов и цены на них лежат на витрине https://openrouter.ai/models.

Второй практический плюс — совместимость. Платформа говорит на том же протоколе, что и OpenAI, поэтому официальный OpenAI SDK работает с ней без переписывания кода: в приложении меняются только адрес и ключ.

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

Как получить ключ OpenRouter: пять шагов

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

Шаг 1. Регистрация аккаунта на openrouter.ai

Откройте сайт OpenRouter — https://openrouter.ai — и нажмите Sign up. Зарегистрироваться можно через Google, GitHub или обычную почту.

Отдельного «бесплатного ключа» не существует. Ключ создаётся один и тот же, он даёт доступ и к платным, и к бесплатным моделям — разница только в том, какую модель вы укажете в запросе.

Шаг 2. Раздел Keys в настройках

После входа откройте раздел Keys — он лежит в меню профиля, прямой адрес https://openrouter.ai/keys. В некоторых версиях интерфейса пункт называется API Keys и живёт внутри настроек, поэтому не пугайтесь, если названия разошлись: страница одна и та же.

Здесь же потом будет видно, какие ключи активны и сколько каждый из них потратил.

Шаг 3. Создание ключа и лимит расходов

Нажмите Create Key. В окне создания задайте имя — оно нужно только вам, чтобы потом отличать ключи друг от друга. Я называю по месту использования: prod-backend, local-test, seo-pipeline.

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

Шаг 4. Сохранение ключа — второго шанса не будет

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

Копируйте сразу и кладите в одно из трёх мест:

• переменная окружения в файле .env;
• менеджер паролей (1Password, Bitwarden, KeePass);
• secret-менеджер, если проект уже живёт в облаке.

Потеряли — не катастрофа: старый ключ отзывается, на его место создаётся новый.

Шаг 5. Проверка ключа первым запросом

Проверять лучше сразу, пока помните, что делали. Минимальный пример на Python:

from openai import OpenAI

# OpenRouter is OpenAI-compatible: the official SDK works without changes.
# Create your API key first — open your OpenRouter account at https://openrouter.ai/keys
# Keep one key per app — the OpenRouter dashboard lists every active key
client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="sk-or-v1-...",  # the API key is a secret: keep it out of git
)

completion = client.chat.completions.create(
    model="deepseek/deepseek-r1:free",
    messages=[{"role": "user", "content": "Проверка связи"}],
)
print(completion.choices[0].message.content)

То же самое одной командой, без установки библиотек:

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer sk-or-v1-..." \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek/deepseek-r1:free","messages":[{"role":"user","content":"ping"}]}'

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

Отдельная команда показывает состояние самого ключа — сколько кредитов осталось и какие лимиты действуют:

# Check your API key, plus the credits left on your OpenRouter account
# The response shows the rate limit and access to paid models on the platform
curl https://openrouter.ai/api/v1/auth/key \
  -H "Authorization: Bearer sk-or-v1-..."

Формат ключа sk-or-v1 и где его хранить

Строка начинается с префикса sk-or-v1- и дальше идёт длинный случайный хвост. Если у вас на руках что-то другое — вы скопировали не тот ключ: например, ключ провайдера или идентификатор платежа.

Правильное место для него — переменные окружения, а не код:

OPENROUTER_API_KEY=sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxx

В приложении ключ подтягивается уже оттуда:

import OpenAI from "openai";

// The API key and the base URL are the only things that change vs. plain OpenAI.
// This key grants access to every model on the platform.
const client = new OpenAI({
  baseURL: "https://openrouter.ai/api/v1",
  apiKey: process.env.OPENROUTER_API_KEY, // your API key, loaded from .env
  defaultHeaders: {
    "HTTP-Referer": "https://your-app.com", // the header allows attribution of your app
    "X-Title": "My App", // shown to other users next to similar apps
  },
});

Два заголовка в конце необязательны — они нужны, чтобы ваше приложение отображалось в публичных рейтингах платформы. Хотите остаться незаметным — просто не передавайте их.

И общее правило: файл .env добавляется в .gitignore до того, как в него попал первый секрет, а не после.

Бесплатные модели OpenRouter и лимиты free-тарифа

Пользоваться без единого рубля можно — у части моделей есть бесплатные варианты с суффиксом :free в идентификаторе. Например, deepseek/deepseek-r1:free. Ключевых ограничений здесь два, и про второе обычно узнают в самый неподходящий момент.

По документации OpenRouter (раздел limits, https://openrouter.ai/docs/api-reference/limits) картина такая:

Лимит	Значение
Запросов в минуту к :free	20
Запросов в сутки, если куплено кредитов меньше чем на $10	50
Запросов в сутки после разовой покупки от $10	1000

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

Цифры сходятся у полутора десятков независимых разборов — от Habr и разбора на vc.ru до англоязычного datastudios.org, — но лимиты платформа правила уже не раз: в старых статьях попадается устаревшее значение в 200 запросов в сутки. Перед серьёзной нагрузкой сверьтесь с актуальной документацией: доступных бесплатных моделей и их квот это касается в первую очередь.

Оплата и пополнение баланса из России

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

Карты российских банков не принимаются — ни МИР, ни Visa с Mastercard российской эмиссии, ни UnionPay. Причина техническая: платёж отклоняется по стране BIN эмитента ещё на форме оплаты, до всякой проверки средств. Об этом одинаково пишут РБК Компании и профильные гайды DTF и Sostav.

Что известно про сам биллинг на странице https://openrouter.ai/credits:

• минимальная сумма пополнения — 5 долларов за транзакцию;
• официальный криптоканал — USDC, комиссия около 5%, зачисление 10–30 минут;
• USDT проходит через сторонние шлюзы, а не напрямую.

На практике разработчики из России пользуются четырьмя маршрутами: сервисы-посредники с оплатой в рублях, карта с иностранным BIN, криптовалюта и «доверенный плательщик» за границей. Конкретных посредников я не называю сознательно: их условия и надёжность меняются быстрее, чем успевает устареть эта статья, и проверить каждого я не могу.

Отдельно про VPN, потому что вопрос задают постоянно. Заявленной блокировки российских IP у самого сервиса в источниках 2026 года нет — руководства по интеграции не вводят VPN обязательным шагом, и доступ к OpenRouter API из России работает штатно. Трудности всплывают на стороне оплаты: эквайринг может потребовать, чтобы IP совпадал со страной карты, а часть криптобирж и платёжных сервисов сама ограничивает доступ из России.

Почему ключ не работает: 5 причин

Ключевых причин пять, и каждая опознаётся по коду ошибки в ответе.

1. Лишние символы при копировании. Пробел или перенос строки в начале строки — и сервер видит другой ключ. Ошибка 401. Лечится повторной вставкой.
2. Скопирован не тот ключ. Если строка не начинается на sk-or-v1-, это ключ другого сервиса.
3. Нулевой баланс на платной модели. Ошибка 402: без денег на балансе доступа к платной модели нет. Модель без суффикса :free тарифицируется всегда, даже на первом запросе.
4. Упёрлись в лимит. Ошибка 429 — это либо 20 запросов в минуту, либо суточный потолок. Если сутки не кончились, помогает только пауза.
5. Неверный base_url. Запрос ушёл на адрес OpenAI вместо https://openrouter.ai/api/v1. Ключ при этом валидный, но чужой платформе он не подходит.

Ключ отозван или удалён — шестая, редкая причина: проверьте, что он ещё в списке активных. Расход по каждому ключу виден в кабинете на странице https://openrouter.ai/activity.

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

Что нужно	Адрес на платформе
Создать ключ, посмотреть список	https://openrouter.ai/keys
Пополнить баланс	https://openrouter.ai/credits
Каталог моделей и цены	https://openrouter.ai/models
Расход по каждому ключу	https://openrouter.ai/activity
Документация по лимитам	https://openrouter.ai/docs/api-reference/limits

Безопасность ключа: что делать, если он утёк

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

# an API key is like a password: never log it and never print it in traces
# Rotate it from your OpenRouter dashboard — revoking cuts access for all users instantly

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

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

Как подключить ключ OpenRouter к AI SEO Writer

В интерфейсе кабинета ключ вставляется в раздел API-ключей — один раз, дальше он хранится в зашифрованном виде и подставляется в генерацию автоматически. Отдельно ключ OpenRouter нужен для режима лонгрида.

Полезная деталь для тех, кто не хочет возиться с пополнением баланса: на тарифах AI SEO Writer есть системные ключи, и генератор статей работает на них, когда своего ключа у пользователя нет. Свой ключ имеет смысл подставлять, когда вы упираетесь в лимиты OpenRouter и хотите платить провайдеру напрямую.

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

Можно ли получить ключ OpenRouter бесплатно?

Да. Выпуск ключа ничего не стоит и карта для регистрации не нужна. Платить придётся только за платные модели; бесплатные варианты с суффиксом :free доступны сразу, но с лимитом в 50 запросов в сутки, пока аккаунт не пополнялся на 10 долларов.

Сколько ключей можно создать на один аккаунт?

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