OpenRouter: что это, как пользоваться и получить API-ключ

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

Что такое OpenRouter

OpenRouter — сервис компании OpenRouter, Inc., который объединяет доступ к моделям разных разработчиков. Для программ он предоставляет единый API: способ отправить запрос и получить ответ без ручной работы на сайте. Приложение обращается к OpenRouter, а сервис направляет запрос подходящему провайдеру выбранной модели. Такой порядок описан в руководстве по маршрутизации.

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

Например, помощнику для программирования нужна недорогая модель для объяснения кода, а для сложной ошибки — более сильная. В настройках можно сменить модель, сохранив адрес сервиса и ключ. Работа с файлами и разрешения агента зависят от приложения. Эту разницу разбираем в материале об OpenCode.

Чат на сайте или подключение через API

Для знакомства проще открыть Chat. В нём можно выбрать одну или несколько моделей, отправить им одинаковое сообщение и посмотреть ответы рядом. Это помогает сравнить, например, как они сокращают текст или объясняют ошибку. API-ключ вручную для работы в собственном веб-чате OpenRouter вводить не нужно.

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

Подписки ChatGPT Plus или Pro не пополняют баланс OpenRouter. Вы платите за доступ в конкретном сервисе, а не за универсальное право вызывать все модели семейства GPT. Разницу между подпиской ChatGPT и самостоятельным API объясняем в разборе ChatGPT Pro.

Для подключения модели к программе нужны три настройки: адрес API, ключ и точный идентификатор модели.

Как выбрать модель в OpenRouter

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

На странице модели смотрите четыре вещи:

• Входные и выходные данные. Принимает ли модель только текст, изображения или другие форматы и какой результат возвращает
• Цена. Входные и выходные токены могут оплачиваться по разным ставкам; для других задач встречаются тарифы за изображение, секунду или иную единицу
• Контекст. Сколько материала помещается в один запрос вместе с ожидаемым ответом
• Провайдеры. Какие варианты запуска доступны, какие у них условия и поддерживаемые параметры

Токены — части текста, которыми модель измеряет объём работы. Во вход входят сообщение, инструкции, история диалога и переданные материалы. Поэтому длинный разговор может обходиться дороже короткого запроса с тем же вопросом.

Для подключения копируйте ID модели, а не её красивое название. В API это отдельное поле model. OpenRouter различает отображаемое имя и идентификатор в описании каталога. Если вам важна повторяемость, выбирайте конкретную модель и версию; автоматический выбор или обозначение latest может привести к смене модели без изменения настроек приложения.

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

Создайте аккаунт на официальном сайте, затем откройте раздел API Keys. Условия сервиса допускают пользователей от 18 лет. Для обычных запросов нужен стандартный API-ключ; административный Management API key для первого подключения не требуется.

Порядок создания ключа:

1. Выберите создание нового ключа
2. Дайте ему понятное имя по приложению, например «Личный чат» или «Редактор кода»
3. Задайте небольшой лимит расходов. Для первого знакомства с платной моделью можно выделить, например, $1 из уже пополненного баланса
4. Создайте ключ и сохраните его в защищённом месте, затем укажите в настройках выбранного приложения

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

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

Полный секрет ключа доступен при создании, поэтому сохраните его сразу. Подойдут менеджер паролей, защищённые настройки доверенного приложения или переменная окружения для серверного кода. Не вставляйте ключ в промпт, открытый репозиторий, скриншот или код публичной веб-страницы. Файл .env тоже нужно исключить из Git. Если ключ попал в открытый доступ, сразу отключите его в API Keys, создайте новый и замените в приложении. Управление ключами описано в Security settings.

Как подключить OpenRouter к приложению

В настройках провайдеров выберите OpenRouter, если он есть в списке. Если отдельного пункта нет, ищите OpenAI-compatible или пользовательский API. Этот вариант подойдёт только тогда, когда клиент позволяет поменять адрес сервера и использует поддерживаемый формат запросов.

Base URL — общий адрес API. Полный адрес одного запроса к текстовой модели — https://openrouter.ai/api/v1/chat/completions. Обычно клиент сам добавляет /chat/completions к Base URL, поэтому не дописывайте этот путь в поле базового адреса, если инструкция клиента этого не требует. Основная схема подключения приведена в Quickstart.

Отправьте короткое нейтральное сообщение: «Объясни в двух предложениях, что такое API». Для первого запроса не нужны рабочие документы и личные данные. После ответа откройте Activity: там можно посмотреть расход, запросы и токены с разбивкой по моделям, провайдерам и ключам.

У агента сначала проверьте обычный ответ модели, затем работу с файлами и инструментами. Подключение API не подтверждает правильность разрешений приложения. Настройку рабочей папки и модели показываем в руководстве по DeepSeek Harness.

Пример запроса без установки SDK

Для программы можно отправить обычный HTTP-запрос. Ниже — пример для curl в Bash. Он использует переменную окружения OPENROUTER_API_KEY: задайте её безопасным способом заранее, не записывая секрет прямо в команду или файл статьи.

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openrouter/free",
    "messages": [{"role": "user", "content": "Explain API in two sentences."}]
  }'

Здесь openrouter/free — маршрутизатор бесплатных моделей. Он выбирает случайную доступную бесплатную модель с нужными возможностями. Это удобно для знакомства, но для сравнения конкретных нейросетей укажите фиксированный ID подходящей модели.

В успешном ответе JSON поле choices[0].message.content содержит текст, а model помогает понять, какая модель ответила. Если пришёл объект error, сначала прочитайте его message. Не публикуйте полный журнал запроса с заголовком Authorization: в нём находится секретный ключ.

Сколько стоит OpenRouter

В обычном режиме Standard используется оплата по расходу: вы заранее покупаете credits, а вызовы моделей списываются с баланса. Единой цены «за запрос OpenRouter» нет. Она зависит от выбранной модели, объёма входа и ответа, а также дополнительных операций.

У Standard комиссия покупки credits составляет 5,5%, но не менее $0,80. Минимальная покупка credits — $5. Комиссия взимается при пополнении, отдельно от стоимости обработки запросов. В тарифе Business комиссия платформы составляет 8%; для первого личного подключения обычно достаточно Standard. Условия описаны на странице тарифов и в правилах покупки credits.

Пример расчёта на условном тарифе: если вход стоит $1 за миллион токенов, а выход — $4 за миллион, запрос на 2 000 входных и 500 выходных токенов обойдётся в $0,004. Тысяча таких запросов — $4 стоимости модели, без комиссии пополнения и дополнительных услуг. Здесь важны обе части расчёта: дешёвый вход ещё не означает дешёвый длинный ответ.

У рассуждающих моделей бюджет могут расходовать и токены рассуждения, даже когда они не показаны в обычном ответе. Параметр max_tokens ограничивает объём генерации, но для таких моделей в него могут входить и рассуждения. Особенности разобраны в руководстве по reasoning tokens.

Для контроля расходов используйте лимит ключа и Activity. С автоматическим пополнением лучше разбираться после первого короткого сценария. Неиспользованные credits могут истечь через 365 дней; возврат неиспользованного остатка можно запросить в течение 24 часов после покупки, комиссия платформы не возвращается, а криптоплатежи невозвратны.

Отдельный режим BYOK позволяет подключить собственный ключ провайдера и оплачивать обработку у него. На Standard и Business первые $25 000 обработки в месяц, рассчитанные по эквивалентной стоимости тех же моделей и провайдеров на OpenRouter, идут без комиссии BYOK; после порога применяется 5%. Счёт за модель остаётся у провайдера. Для старта с обычным балансом OpenRouter BYOK не нужен.

Бесплатные модели и лимиты

Чтобы найти бесплатные модели, откройте каталог Models и в меню All variants выберите Free. Откройте карточку подходящей модели, проверьте нулевую стоимость входа и выхода и скопируйте её точный ID. Суффикс :free обозначает отдельный бесплатный вариант, который должен существовать в каталоге: просто дописать его к любой платной модели нельзя. У такого варианта свои провайдеры и лимит контекста, поэтому не переносите на него характеристики платной версии. Это объясняется в руководстве Free Variant.

Есть два способа выбора. Конкретный ID с :free нужен, когда вы хотите пользоваться определённой моделью. openrouter/free, использованный в примере выше, выбирает за вас из доступных бесплатных моделей с нужными возможностями; ответ может прийти от другой модели при следующем запросе. У него нулевая стоимость входных и выходных токенов. Не путайте его с openrouter/auto: автоматический выбор в этом режиме может привести к платной модели.

Базовый лимит бесплатных моделей — 20 запросов в минуту и 50 в сутки. При суммарной покупке как минимум $10 credits заявленный суточный лимит увеличивается до 1 000 запросов. Учитываются накопленные покупки, а не текущий баланс. Числовые квоты приведены в официальном руководстве OpenRouter.

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

Лимит запросов и лимит контекста — разные вещи. Даже при свободной дневной квоте большой документ может не поместиться в выбранную модель: смотрите её собственное контекстное окно и допустимый объём ответа. Набор бесплатных моделей и доступная мощность меняются. При 429 выдержите паузу и сократите параллельные обращения; повторять запрос без остановки не стоит. Бесплатный режим полезен для знакомства и редких задач; на него рискованно опирать сервис, который должен стабильно отвечать клиентам.

У платных запросов нет такого общего дневного лимита платформы, но остаются ограничения провайдера, защита от чрезмерной нагрузки, баланс и настройки расходов. Поэтому формулировку «безлимитный API» не стоит понимать как гарантированную возможность отправлять любое число запросов одновременно.

Что происходит с данными и доступом из России

При использовании API ваш запрос проходит через OpenRouter к провайдеру модели. По умолчанию OpenRouter не сохраняет содержимое обычных запросов и ответов, но сохраняет метаданные использования: например, сведения для учёта расходов. Отдельные настройки включают частное хранение запросов или разрешение на использование их содержимого. У пакетной обработки и других функций есть собственные правила хранения. Эти различия описаны в разделе Data Collection и условиях сервиса.

У провайдера действуют свои правила. Запрет использовать текст для обучения и Zero Data Retention, отсутствие его хранения, решают разные вопросы. Для данных, которые нельзя сохранять, нужен маршрут с ZDR. Настройки маршрутизации по политике данных доступны в Standard и выше. ZDR может сузить выбор провайдеров и моделей; у дополнительных инструментов, например веб-поиска, свои правила. Подробнее — руководство ZDR.

Если важно, в каком регионе обрабатывается запрос, у Business и Enterprise есть отдельная функция In-Region Routing для ЕС и США. Она ограничивает место обработки; правила допуска пользователей к модели по странам проверяют отдельно.

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

Для пользователя из России нужно отдельно проверить доступность выбранной модели и способа оплаты. Единый аккаунт OpenRouter не отменяет ограничений разработчиков моделей по странам и организациям. В разделе 5.7 условий запрещён обход ограничений Restricted Models через VPN и прокси. Наличие модели в каталоге и возможность открыть сайт ещё не дают права использовать её из любого региона.

Почему запрос не работает

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

• 401. Ключ неверный, отключён, отозван или истёк. Проверьте, что это ключ OpenRouter, а не другого сервиса, и что он вставлен полностью
• 402. Не хватает credits, достигнут лимит ключа либо стоимость одновременных запросов превышает доступный бюджет. При временном ограничении следуйте Retry-After; слишком дорогой запрос уменьшите по объёму или max_tokens
• 403. Запрос запрещён правилами доступа, настройками защиты или модерацией. Прочитайте причину и проверьте условия модели
• 429. Превышен лимит частоты. Уменьшите число параллельных запросов и выдержите паузу, указанную в Retry-After, если заголовок присутствует
• 503. Нет доступного провайдера, который соответствует условиям маршрута. Проверьте состояние сервиса и выбранные ограничения

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

Кому подойдёт OpenRouter

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

Если нужна одна модель с конкретными корпоративными условиями, стоит сравнить OpenRouter с прямым API её провайдера. Если нужен только обычный разговор, проще начать с веб-чата выбранного сервиса. Для локальной работы без передачи текста в облако потребуется локально запущенная модель: OpenRouter сам по себе этого не обеспечивает.

Начните с отдельного ключа с лимитом и короткого запроса. После проверки ответа и расхода в Activity можно переходить к длинным диалогам и автоматизациям.