Базовые концепции
БАЗОВЫЕ КОНЦЕПЦИИ

Дотратить баланс OpenRouter (BYOK)

Подключите свой ключ OpenRouter — Hubris потратит его баланс вместо рублёвого. Комиссия — 1 копейка за запрос.

Если у вас уже есть аккаунт и оплаченный баланс в OpenRouter — этот раздел для вас.

Что это

OpenRouter не принимает запросы напрямую из России. Если у вас есть аккаунт OpenRouter с оплаченным балансом, он может попросту зависнуть — потратить его штатным способом из РФ не получится.

«Дотратить баланс OpenRouter» решает эту проблему: вы подключаете свой ключ OpenRouter к Hubris, и дальше расходуете баланс через нашу инфраструктуру. Комиссия Hubris — 1 копейка за успешный запрос, сама генерация оплачивается напрямую с вашего баланса OpenRouter — по тем же ценам, что там указаны.

Такой режим иногда называют BYOK (bring your own key — «принесите свой ключ»).

Как это работает

  1. Вы подключаете свой ключ OpenRouter (sk-or-v1-...) на странице «BYOK» в личном кабинете.
  2. Hubris автоматически создаёт связанный ключ Hubris (sk-gw-...) — пара «один ключ OpenRouter → один ключ Hubris».
  3. Запросы этим ключом Hubris форвардятся на OpenRouter по вашему ключу и списывают токены с вашего баланса OpenRouter.
  4. Ваши обычные ключи Hubris при этом не меняются и продолжают работать в рублях с баланса Hubris, как и раньше — подключение BYOK-ключа ничего в них не трогает.

Подключение

  1. Откройте страницу «BYOK» в личном кабинете.
  2. Вставьте ключ OpenRouter. Ключ создаётся в кабинете OpenRouter → Keys — скопируйте его оттуда.
  3. Нажмите «Подключить и создать ключ Hubris». В открывшемся окне появится готовый ключ Hubris (sk-gw-...) — он показывается один раз, сохраните его сразу.
  4. В вашей интеграции замените прежний ключ на этот. Адрес api.hubris.pw менять не нужно — меняется только значение заголовка Authorization:
curl https://api.hubris.pw/v1/chat/completions \-H "Authorization: Bearer sk-gw-обычный-ключ" \-H "Content-Type: application/json" \-d '{  "model": "anthropic/claude-haiku-4.5",  "messages": [{"role": "user", "content": "Привет"}]}'
curl https://api.hubris.pw/v1/chat/completions \-H "Authorization: Bearer sk-gw-byok-ключ" \-H "Content-Type: application/json" \-d '{  "model": "anthropic/claude-haiku-4.5",  "messages": [{"role": "user", "content": "Привет"}]}'

Больше в коде ничего не меняется — тот же base_url, тот же формат запроса, тот же формат ответа.

Несколько ключей и проекты

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

Обновление ключа (rotate)

Ключ Hubris показывается один раз — если вы его не сохранили, не нужно подключать ключ OpenRouter заново. На странице «BYOK» у нужной пары нажмите «Обновить ключ Hubris»: выдастся новый ключ Hubris, старый сразу перестанет работать. Привязанный ключ OpenRouter при этом остаётся прежним — вписывать его снова не требуется.

Где работает

BYOK-ключ работает на тех же эндпоинтах, что и обычный ключ Hubris, кроме генерации видео:

ЭндпоинтПутьКомментарий
Чат/v1/chat/completions
Генерация изображений/v1/images/generations
Эмбеддинги/v1/embeddings
Responses API/v1/responses
Messages API/v1/messagesAnthropic-совместимый
Видео/v1/videosпока не поддерживается

Видео (/v1/videos) для BYOK-ключей добавим позже — пока запрос на этот эндпоинт с BYOK-ключом вернёт ошибку.

Стоимость и логи

За каждый успешный запрос BYOK-ключом с вашего баланса Hubris списывается фиксированная 1 копейка — это комиссия за форвардинг запроса. Стоимость самих токенов при этом не входит в эту копейку и не проходит через баланс Hubris вообще — она списывается напрямую с вашего баланса OpenRouter по его собственным ценам.

В разделе /logs такие запросы помечены значком OpenRouter и подписью «через ваш OpenRouter» — их легко отличить от запросов, оплаченных с обычного баланса Hubris.

Когда баланс OpenRouter закончится

Как только баланс на вашем аккаунте OpenRouter будет исчерпан, запросы BYOK-ключом перестанут проходить — вернётся ошибка:

{
  "error": {
    "message": "Баланс вашего аккаунта OpenRouter исчерпан. Пополните его на openrouter.ai или переключитесь на оплату в рублях через Hubris.",
    "type": "insufficient_quota",
    "code": "byok_insufficient_credits"
  }
}

В этом случае можно либо пополнить баланс на стороне OpenRouter, либо просто продолжить работу на обычном балансе Hubris — переключитесь на любой из ваших ключей Hubris без пометки BYOK. Пополнение баланса Hubris — в рублях через СБП, подробнее в разделе Биллинг.

Безопасность

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

Использование ключа OpenRouter через посредника может подпадать под условия использования самого OpenRouter — оцените это самостоятельно перед подключением.

Что дальше

  • «BYOK» — страница подключения ключей в личном кабинете.
  • Биллинг — пополнение обычного баланса Hubris через СБП.
  • Ошибки — формат ошибок и таблица кодов.

Обновлено:

Дотратить баланс OpenRouter (BYOK) · Hubris