OpenRouter: один ключ ко множеству моделей

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

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

#Что понадобится

• Почта для регистрации. Карта на старте не нужна, если вы остаётесь на бесплатных моделях.
• Зарубежная карта — если планируете пополнять баланс. Российская карта на платёжной форме, по нашей проверке 26 августа 2026 года, не проходила; рабочие варианты оплаты разобраны в обзоре того, где взять ключ к языковой модели.
• Приложение, которое умеет говорить по OpenAI-совместимому протоколу. OpenRouter намеренно повторяет его формат — почему это стало отраслевым стандартом, разобрано в статье про OpenAI-совместимый API.

#Шаг 1. Регистрация и выпуск ключа

1. Откройте openrouter.ai и зарегистрируйтесь по почте или через привязку существующего аккаунта.
2. В профиле найдите раздел Keys.
3. Нажмите Create key, дайте ключу говорящее имя — по имени вы потом поймёте, какое приложение его использует.
4. Если сервис предлагает ограничить ключ по сумме — поставьте ограничение сразу, даже нулевое. Позже вы к этому не вернётесь.
5. Скопируйте ключ. Он начинается с sk-or- и показывается один раз: сервис хранит хэш, а не строку. Потеряли — выпускайте новый.

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

#Шаг 2. Разобраться с именами моделей

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

вендор/модель
вендор/модель:суффикс

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

Три правила, которые сэкономят вам вечер:

• Имя копируется целиком, вместе с суффиксом. модель и модель:free — это две разные позиции с разной ценой и разными лимитами.
• Модель может исчезнуть из каталога. Вендор снял версию — строка перестала работать, приложение получило ошибку о неизвестной модели. Это нормальный режим жизни агрегатора, а не поломка.
• Бесплатный вариант ≠ та же модель бесплатно. Обычно это тот же вес, но с меньшим приоритетом в очереди и более узкой квотой.

#Шаг 3. Подключить в Persona

В Persona на странице /settings/llm есть готовый пункт 🌐 OpenRouter: выберите его, вставьте ключ и сохраните. По умолчанию используется бесплатная модель, чтобы связка заработала без пополнения баланса.

Если вам нужна конкретная модель из каталога, удобнее другой путь: выберите пункт 🔧 Свой OpenAI-совместимый сервис и заполните три поля — адрес эндпоинта OpenRouter, точное имя модели из каталога и тот же ключ. У этого пункта поле модели есть, у готового пресета OpenRouter — нет. Хвост /chat/completions дописывать не нужно, он добавляется автоматически.

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

#Проверка результата

Признак успеха — не «ошибок нет», а расход, который видно у провайдера.

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

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

#Чем вы платите за удобство

Раздел, которого нет в большинстве обзоров агрегаторов.

Наценка. Агрегатор зарабатывает на разнице между тем, что берёт с вас, и тем, что платит источнику. Иногда наценка нулевая или отрицательная (сервис держит цену ради потока), иногда заметная. Цифру здесь не приводим намеренно: она меняется по моделям и во времени. Сравнивать нужно конкретную позицию каталога с прайсом её вендора в день, когда вы выбираете.

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

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

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

#Что может пойти не так

• Ошибка «модель не найдена». Опечатка в имени, потерянный суффикс :free или снятая с каталога версия. Проверяется копированием строки прямо со страницы модели.
• Ошибка авторизации. Чаще всего — невидимый пробел или перенос строки, попавший при копировании. Вставьте ключ заново, набрав его вручную или очистив поле перед вставкой.
• Ответ приходит с большой задержкой или обрывается на бесплатной модели. Бесплатные варианты обслуживаются по остаточному принципу, и в часы нагрузки очередь растёт. Это не сбой, это условие бесплатного уровня.
• Ошибка о превышении лимита через несколько минут работы. У бесплатных позиций квоты жёсткие. Ошибка при этом одна и та же независимо от того, что сработало: минутный лимит, суточный или лимит по токенам.
• Списание идёт быстрее ожидаемого. Почти всегда причина — длинный контекст, а не количество вопросов. Как оценить это заранее, показано в разборе бесплатных API языковых моделей и их реальных лимитов.

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

#Можно ли пользоваться OpenRouter совсем бесплатно?

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

#Дороже ли агрегатор, чем прямой ключ вендора?

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

#Видит ли OpenRouter текст моих запросов?

Через него проходит весь трафик, поэтому технически — да. Что именно и как долго хранится, определяется его политикой и настройками аккаунта, а не общими словами о приватности. Если содержание переписки критично, разумнее либо прямой ключ вендора, либо собственная модель на своём железе.

#Что произойдёт, если модель уберут из каталога?

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

#Как выбрать модель из сотен позиций?

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

#Подойдёт ли OpenRouter, если у меня нет зарубежной карты?

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

Факты о сервисе проверялись 26 августа 2026 года. Названия разделов интерфейса, состав каталога и условия бесплатного уровня меняются — сверяйтесь с документацией сервиса на день чтения.