OpenRouter - это один аккаунт, один ключ и один баланс в долларах для сотен моделей разных компаний. За сами модели вы платите по цене их разработчиков, а сам OpenRouter берёт комиссию при пополнении. Российская карта для пополнения не пройдёт, нужна зарубежная. Я пополняю OpenRouter картой ZARUB, и это работает. Ниже по шагам: ключ с лимитом, где взять карту, сколько класть и как подключить ключ к агенту.
Я веду курс по Гермесу, и в нём одним из способов оплатить модель назван OpenRouter, так что мне выгодно, чтобы у вас всё получилось. Минусы назову сразу: комиссия на маленьких пополнениях и срок жизни денег на балансе.
Что такое OpenRouter и за что вы платите?
Коротко: OpenRouter - это один аккаунт, один ключ и один баланс в долларах для сотен моделей. За модели вы платите по цене их разработчиков, а при покупке кредитов сервис берёт комиссию.
OpenRouter даёт доступ к сотням моделей через один адрес API. Вы заводите аккаунт и кладёте на баланс деньги, а при каждом запросе сервис списывает его стоимость. Баланс ведётся в долларах.
У каждой модели своя цена за миллион токенов. Токен - это фрагмент текста, с которым работает модель: примерно слог или короткое слово. Входящий текст и ответ модели обычно стоят по-разному. Надбавки к цене самой модели нет, но при покупке кредитов сервис берёт комиссию. Так сказано в самих вопросах и ответах сервиса (FAQ OpenRouter).
Схема: запросы агента идут по одному ключу, лимит ключа ограничивает расход, а баланс в долларах списывается по цене выбранной модели.
Здесь вы платите за расход, а не за подписку. Молчащий агент ничего не стоит, а агент, который ночью ушёл в бесконечный цикл, стоит денег. От этого защищает лимит на ключе. В следующем разделе покажу, как его поставить. Чем такая оплата отличается от подписки ChatGPT для Гермеса, объясняет моя статья про выбор модели и способа оплаты.
Как получить ключ OpenRouter с лимитом расходов?
Коротко: зарегистрируйтесь на openrouter.ai, скопируйте ключ, пополните баланс зарубежной картой и поставьте на ключ лимит расходов. Для агента начните с 10 $ в неделю.
- Откройте openrouter.ai и нажмите Sign up.
- Скопируйте API-ключ. Его предложат на приветственном экране, позже ключи создаются в разделе API Keys. Ключ показывают один раз: сразу сохраните его в менеджер паролей и никому не давайте. По нему тратят ваши деньги.
- Пополните баланс зарубежной картой, как описано в следующем разделе. Готовые суммы начинаются от 10 $, но в поле Other amount можно вписать 5.
- Поставьте лимит на ключ: API Keys → три точки у ключа → Edit → Credit limit 10 $, Reset limit: Weekly. Больше 10 $ в неделю с этого ключа не уйдёт, что бы агент ни делал. Лимит бывает с суточным, недельным и месячным сбросом. Когда ключ его израсходовал, запросы отклоняются, пока лимит не сбросится или вы его не поднимете.
- Заведите отдельный ключ под агента. Не давайте ему ключ, на котором лежат деньги под другие задачи: агент может израсходовать баланс, отложенный на другое.
Ключ храните в переменной окружения или в файле .env на сервере. Публичный репозиторий, скриншот и чат для этого не годятся. Если ключ всё же утёк, удалите его на странице ключей и создайте новый.
Проверить ключ и остаток его лимита можно одной командой. Ответ покажет лимит, остаток и период сброса.
export OPENROUTER_API_KEY="<ваш ключ>"
curl https://openrouter.ai/api/v1/key -H "Authorization: Bearer $OPENROUTER_API_KEY"Первый запрос можно отправить на бесплатной модели. Псевдоним openrouter/free сам выбирает бесплатную модель.
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": "Ответь одним словом: привет"}]}'Обе команды взяты из документации OpenRouter. Если пришёл текст, ключ работает. Код 401 значит, что ключ неверный или отключён, а код 402 значит, что не хватает кредитов или исчерпан лимит самого ключа (лимиты OpenRouter).
Лимит на ключе работает как предохранитель: агент может уйти в цикл, а расход остановится на заданной вами цифре.
Какой лимит поставить. Документация советует ставить лимит на каждый ключ: ключ без лимита при утечке или при агенте, ушедшем в цикл, расходует весь баланс, включая автопополнения (авторизация). Для агента, который работает по расписанию, начните с 10 $ в неделю, как в курсе, а через неделю подстройте цифру под свой расход. Автопополнение не включайте, пока не видите реальный расход. История расхода по моделям и ключам лежит на странице Activity.
Ключ готов, дальше его нужно подключить к агенту. Если Гермеса у вас ещё нет, установка и подключение модели по шагам разобраны в курсе «Hermes Agent: свой ИИ-помощник»: четыре практических урока со скриншотами на каждом шаге, 8 700 ₽. Сервер и модель оплачиваются отдельно, прямо на странице курса это сказано.
Как пополнить OpenRouter из России?
Коротко: российская карта не пройдёт, нужна зарубежная. Пополняйте понемногу, по 5-10 $: при пополнении картой OpenRouter берёт комиссию 5,5 %, минимум 0,80 $.
Российская карта не пройдёт. OpenRouter принимает карты через Stripe, а Stripe не обрабатывает операции с подсанкционными российскими банками и не поддерживает карты «Мир» (страница Stripe). Нужна зарубежная карта. Карта ZARUB проходит и в OpenRouter, и на хостинге сервера для Гермеса: проверено.
Где взять зарубежную карту
Такие карты выпускают сервисы, которые работают через сайт или Telegram: оформляете за несколько минут и пополняете рублями. Все они платные. Цену выпуска, комиссии и остальные условия сверяйте у самого сервиса: они меняются.
| Карта | Выпуск | Где оформить |
|---|---|---|
| ZARUB, виртуальная Visa | 19 $ | на сайте zarub.io или в боте в Telegram |
| Плати по миру, карта «Для подписок» | 2 990 ₽ | platipomiru.com |
| MIG Pay, пополняемая Mastercard | 800 ₽ | migpay.app |
| WantToPay, тариф Easy | 990 ₽ | wanttopay.net |
Картами ZARUB, «Плати по миру» и MIG Pay я пользовалась сама: все три проходят в OpenRouter. WantToPay я не проверяла. Ссылки на ZARUB, «Плати по миру» и MIG Pay реферальные: вам так проще найти сервис, а мне придёт небольшой бонус.
Три правила при оплате
- Данные той карты, которой платите. В форме оплаты указывайте страну и адрес своей карты и ничего не выдумывайте: расхождение в данных может закончиться проверкой аккаунта.
- Платёж не прошёл: не повторяйте его подряд с разных карт. Так блокируют уже аккаунт целиком.
- Пополняйте понемногу, по 5-10 $. К пополнению картой OpenRouter добавляет комиссию 5,5 %, минимум 0,80 $.
Кредиты, которые вы не потратили, OpenRouter оставляет за собой право аннулировать через 365 дней после покупки. Поэтому кладите столько, сколько реально потратите за год.
Не покупайте «дешёвые ключи» с рук
Объявления про доступ к моделям «в три раза дешевле» почти всегда продают краденые ключи. Их блокируют, деньги сгорают. Условия OpenRouter к тому же запрещают перепродажу доступа к моделям, а за всё, что происходит с ключом, отвечает владелец аккаунта, то есть продавец. Ключ берите только в своём аккаунте OpenRouter.
Если денег на балансе нет
Бесплатные модели есть, но с жёсткими лимитами: у моделей с окончанием :free лимит 20 запросов в минуту и 50 в день, пока вы не купили кредитов. Если за всё время вы купили кредитов не меньше чем на 10 $, суточный лимит поднимается до 1 000 запросов. Страница лимитов добавляет, что повышенный лимит дают уже с 9 кредитов, это учитывает округление и комиссии. FAQ добавляет, что такие модели обычно не подходят для рабочих задач. Подробно про бесплатные модели и подключение их к Claude Code я писала в статье «Claude Code бесплатно».
Сколько положить на первый месяц?
Коротко: в курсе я советую около 5 $ на старт, а для начала с дешёвой моделью этого хватает. Больше, чем реально потратите за год, не кладите: деньги могут сгореть.
Расход зависит от модели и от того, сколько агент читает и пишет. Замера вашего расхода пока нет, поэтому ниже условный пример. Допустим, агент за день получает миллион токенов входящего текста и пишет сто тысяч токенов ответа. И так 30 дней, кэш не учитывается. Цены взяты из каталога OpenRouter на момент написания, расчёт сделан скриптом.
| Модель | Вход, за 1 млн токенов | Ответ, за 1 млн токенов | Условный месяц |
|---|---|---|---|
| z-ai/glm-5.3-flash | 0,048 $ | 0,16 $ | 1,92 $ |
| deepseek/deepseek-v4-flash | 0,091 $ | 0,182 $ | 3,28 $ |
| anthropic/claude-sonnet-5.5 | 2 $ | 10 $ | 90 $ |
Условный расход за 30 дней: миллион входящих и сто тысяч исходящих токенов в день, цены каталога OpenRouter на момент написания.
В этом примере расход на каждую из двух дешёвых моделей в десятки раз ниже, чем на Claude Sonnet 5.5. Качество у моделей тоже разное, и какая подойдёт, зависит от ваших задач: цена на странице модели про качество ничего не говорит. Цены меняются, перед пополнением откройте страницу своей модели и пересчитайте. Реальный расход через неделю покажет страница Activity.
На странице курса я пишу: около 5 $ на старт, а у меня на модель уходит около 3 $ в месяц. Это мой расход на моих задачах, ваш может отличаться. Ориентир в 5 $ стоит и в статье про установку Гермеса, где я советую пополнять по 5-10 $. Для начала с дешёвой моделью пяти долларов хватает.
Теперь комиссия. При пополнении картой она 5,5 %, но не меньше 0,80 $, поэтому на маленьких суммах её доля выше.
| Пополнение | Комиссия | Доля от суммы |
|---|---|---|
| 5 $ | 0,80 $ | 16 % |
| 10 $ | 0,80 $ | 8 % |
| 20 $ | 1,10 $ | 5,5 % |
Три пополнения по 5 $ стоят 2,40 $ комиссии, а одно на 15 $ около 0,83 $. Если выбирать между 5 и 10 $, у пополнения на 10 $ доля комиссии ниже: 8 % против 16 %. Пополнение на 10 $ также даёт повышенный лимит бесплатных моделей. Больше, чем реально потратите за год, не кладите: деньги могут сгореть, а возврат возможен только в первые сутки.
Как выбрать модель и подключить ключ к агенту?
Коротко: у Гермеса одно требование к модели: контекст не меньше 64 000 токенов. Ключ вставляется в поле OPENROUTER_API_KEY в панели Гермеса или записывается в файл ~/.hermes/.env.
У Гермеса есть одно требование к модели: контекст не меньше 64 000 токенов. Все три модели из таблицы выше это требование закрывают: у каждой в каталоге указано не меньше миллиона токенов контекста. Какую взять под свои задачи, я разбирала в статье про модель и оплату для Гермеса, здесь повторять не буду.
Гермес. В панели Гермеса откройте Keys → вкладка Providers → строка OpenRouter. В поле OPENROUTER_API_KEY вставьте ключ и сохраните: когда ключ принят, рядом появится пометка Set. Модель выбирается в Models → Main model → Change → вкладка OpenRouter. В курсе мы берём deepseek-v4-flash: он дешёвый, быстрый и хорошо работает с инструментами. Картинок он через OpenRouter не видит, это проверено. Если будете отправлять боту фото и скриншоты, выберите z-ai/glm-5.3-flash: цена того же порядка, изображения он видит.
Если Гермес стоит у вас без панели, ключ записывается как переменная OPENROUTER_API_KEY в файле ~/.hermes/.env, а модель выбирает мастер, который запускает команда hermes model. Как поставить самого агента, написано в статье «Как установить Hermes Agent».
OPENROUTER_API_KEY=<ваш ключ>Claude Code. OpenRouter описывает подключение через переменные окружения. Адрес https://openrouter.ai/api, ваш ключ как ANTHROPIC_AUTH_TOKEN, а ANTHROPIC_API_KEY нужно явно оставить пустым:
export OPENROUTER_API_KEY="<ваш ключ>"
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY=""OpenRouter предупреждает, что работа Claude Code заявлена только с провайдером Anthropic. Работа с другими провайдерами не обещана, поэтому проверяйте на пробном задании. Полный разбор с бесплатными моделями есть в статье про Claude Code без подписки.
Что может пойти не так при работе с OpenRouter?
Коротко: чаще всего встречаются ошибка 402, ошибка 429 на бесплатной модели, задержка кредитов после оплаты и утечка ключа. По каждому случаю ниже сказано, что делать.
- Ошибка 402. В теле ответа смотрите поле
limit_source. Если тамopenrouter_key_limit, исчерпан лимит самого ключа: поднимите его или дождитесь сброса. Еслиopenrouter_credits, не хватает баланса. Еслиopenrouter_in_flight_budget, запросов в работе слишком много, подождите время из заголовкаRetry-Afterи повторите. - Ошибка 429 на бесплатной модели. Вы упёрлись в лимит бесплатных запросов в минуту или в день. Подождите, купите кредиты или перейдите на платную версию модели.
- Деньги списались, а кредитов нет. Если вы платили через Stripe, кредиты иногда появляются с задержкой: по FAQ подождите до часа. Потом проверьте, было ли списание и пришёл ли чек на почту. Списание есть, а кредитов нет: пишите на support@openrouter.ai с данными платежа. Для криптоплатежей FAQ тоже называет эту почту.
- Ключ утёк. Удалите его на странице ключей и создайте новый. OpenRouter сканирует утечки вместе с GitHub и, если найдёт ваш ключ, пришлёт письмо.
Источники
- OpenRouter: вопросы и ответы: оплата, комиссии, возвраты, способы пополнения, бесплатные модели.
- OpenRouter: условия использования: платёжные системы, срок кредитов, ответственность за ключи, перепродажа доступа.
- OpenRouter: авторизация и ключи: создание ключа, лимит расходов, утечка ключа.
- OpenRouter: лимиты: ошибки 401, 402, 429, бесплатные модели, проверка ключа.
- OpenRouter: быстрый старт и подключение Claude Code.
- Каталог моделей OpenRouter: цены моделей.
- Stripe: санкции против России и Беларуси.
- Hermes Agent: провайдеры моделей.
- Страница курса по Гермесу на keybrain.ru: состав уроков, цена, блок про расходы.
- Урок 1 курса по Гермесу «Свой Гермес»: оплата, зарубежные карты, получение ключа и лимит, подключение ключа в панели Гермеса, выбор модели.
Цены, комиссии и условия сервисов меняются, поэтому перед оплатой сверьтесь с этими страницами. Когда ключ с лимитом и баланс будут готовы, подключить модель к своему агенту и дойти до работающего бота в Telegram можно по шагам в курсе по Гермесу.