Гид по Telegram-боту¶

Telegram-бот — самый простой способ управлять Nexus самостоятельно. Через бота можно создать профиль, пополнить баланс, выпускать и отзывать API-ключи, задавать лимиты, открывать обращение в поддержку и смотреть список моделей.

Адрес бота — @nexus_hubbot

1. Запуск бота¶

Откройте Telegram и найдите @nexus_hubbot.
Отправьте /start.
Выберите язык, когда бот предложит: 🇷🇺 Русский или 🇬🇧 English.

После выбора языка бот покажет главное меню. Для уже привязанного аккаунта явный /start сначала отправляет логотип Nexus Hub отдельным сообщением, а затем отдельное редактируемое меню. Повторный /start создаёт новую пару логотип + меню.

Главное меню для активного профиля устроено так: отдельная крупная кнопка Пополнить, затем ряд Ключи + Модели, затем ряд История + Дополнительно. Для администраторов Админ остаётся отдельной кнопкой.

В разделе Дополнительно находятся: Поддержка, Я оплатил, но не вижу баланс, Перенести в новый Telegram, Сменить язык, публичный статус сервисов, документация и, если настроено, ссылка на новости.

Для замороженного профиля верхний уровень сокращается до Модели, Дополнительно и, если применимо, Админ.

При этом внутри Дополнительно по-прежнему остаются доступны поддержка, заявка по оплате, язык и документация.

Меню команд (кнопка / в Telegram) теперь намеренно содержит только /start для всех ролей. Остальные пользовательские сценарии открываются кнопками в интерфейсе бота.

2. Создание или восстановление доступа¶

В профиле хранятся ваш баланс, ваши API-ключи и их настройки.

После выбора языка выберите один из вариантов:
Создать новый Nexus аккаунт, если вы начинаете с нуля;
У меня уже есть Nexus ID, если нужно восстановить доступ через старый Telegram или перейти к восстановлению платежа.
Перед созданием нового аккаунта бот предупредит, что будет создан отдельный Nexus ID с отдельным балансом.

Nexus ID публичный: его можно использовать для пополнений и поддержки, но нельзя использовать как пароль. Прямой вход по /login отсутствует.

Когда выбирать «Создать новый Nexus аккаунт»¶

Используйте этот вариант только если:

вы раньше не создавали Nexus аккаунт;
у вас ещё не было пополнений;
вам не нужно возвращаться к старому балансу или старым API-ключам.

Важно: бот создаст отдельный Nexus ID и отдельный баланс. Если у вас уже был другой аккаунт, деньги и ключи не объединятся автоматически.

Когда выбирать «У меня уже есть Nexus ID»¶

Используйте этот вариант, если:

у вас уже есть существующий Nexus аккаунт;
доступ к старому Telegram-аккаунту ещё есть;
вы хотите перенести привязку на новый Telegram без создания нового баланса и нового Nexus ID.

В этом сценарии сам Nexus ID не используется как пароль. Для переноса нужен одноразовый transfer-link.

Когда выбирать «Я оплатил, но не вижу баланс»¶

Используйте этот вариант, если:

вы оплатили Digiseller / Plati, но баланс не появился в нужном аккаунте;
платёж ушёл на другой Nexus ID;
профиль был создан без Telegram-привязки;
вы не уверены, в каком именно аккаунте лежит пополнение.

Бот попросит номер заказа, номер инвойса или другой payment reference и попробует безопасно разобраться автоматически.

3. Перенос аккаунта в новый Telegram¶

Этот сценарий подходит, если старый Telegram ещё доступен.

В старом Telegram откройте Дополнительно.
Нажмите Перенести в новый Telegram.
Бот покажет одноразовую команду вида /start transfer_<token>.
Откройте нового Telegram-пользователя и отправьте эту команду боту.
После подтверждения новый Telegram получит доступ к тому же Nexus аккаунту.

Что важно знать:

transfer-link одноразовая;
ссылка живёт ограниченное время;
после переноса customer_id, баланс, история и API-ключи не меняются;
старый Telegram теряет привязку к этому аккаунту.

Если бот пишет, что ссылка истекла, просто создайте новую в старом Telegram.

4. Если вы оплатили, но не видите баланс¶

На экране recovery после кнопки У меня уже есть Nexus ID или в разделе Дополнительно выберите Я оплатил, но не вижу баланс.
Отправьте один из идентификаторов платежа:
номер заказа Digiseller / Plati;
номер инвойса;
другой payment reference, который вы получили после оплаты.
Бот проверит платёж и выберет один из сценариев:
автоматически привяжет найденный аккаунт к вашему Telegram;
автоматически перенесёт пополнение на ваш текущий Nexus аккаунт;
создаст заявку на ручную проверку, если случай неоднозначный.

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

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

5. Пополнение баланса¶

В главном меню выберите Пополнить.
Укажите сумму.
Выберите способ оплаты Digiseller.
Завершите оплату через форму Digiseller.
Бот подтвердит, когда баланс будет зачислен в рублях.

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

Баланс общий для всех API-ключей вашего профиля. Перед оплатой сверяйте Nexus ID в профиле: пополнение другого Nexus ID зачислится на другой аккаунт.

6. Выпуск полноценного API-ключа¶

После пополнения можно выпустить полноценный ключ без ограничения по времени.

В главном меню выберите Ключи.
Нажмите Выпустить ключ.
Новый ключ получит последовательное имя вида #1, #2, #3 внутри вашего профиля.
Скопируйте новый ключ и сохраните его в надежном месте. Сообщение с plaintext-ключом бот удалит автоматически по настроенному TTL.

Используйте ключ как Bearer-токен с базовым URL https://api.nexus-hub.ru.

7. Имя ключа и лимит расходов¶

Удобно, когда у вас несколько проектов или нужно ограничить расход.

Откройте Ключи. По умолчанию бот показывает только активные и неистёкшие ключи.
При необходимости переключайтесь между фильтрами Активные, Все и Отозванные. Фильтр и страница сохранятся, если открыть карточку ключа и вернуться назад.
Нажмите на нужный ключ.
Выберите Изменить название, чтобы задать понятное имя.
Выберите один из inline-вариантов лимита, чтобы задать или снять ограничение расходов.

Лимит ограничивает, сколько может потратить отдельный ключ; при достижении лимита ключ останавливается, пока вы не повысите лимит. Баланс профиля при этом остается общим для всех ключей.

8. Доступные модели для ключа¶

У каждого ключа можно отдельно ограничить, какие модели ему доступны.

Откройте Ключи и нажмите на нужный ключ.
Выберите Доступные модели.
На верхнем экране выберите один из готовых вариантов:
Все — ключ видит все публичные модели;
Нет — ключ временно не сможет вызывать модели.
Ниже нажмите на нужное семейство моделей, например Семейство Claude, Семейство Gemini или Семейство OpenAI/Codex.
На отдельном экране семейства:
можно включить всё семейство целиком;
можно включить или выключить отдельные публичные модели этого семейства.
Нажмите Назад, чтобы вернуться к списку семейств без применения.
Нажмите Применить только когда итоговая политика вас устраивает.

Пока вы не нажали Применить, изменения хранятся только как черновик. Назад на верхнем экране и возврат из экрана семейства не меняют настройки ключа.

Бот показывает только публичные модели из актуального каталога. Окончательно проверить доступ конкретного ключа можно через API:

curl -H "Authorization: Bearer $NEXUS_API_KEY" \
  https://api.nexus-hub.ru/v1/models

9. Списки разрешенных IP¶

Ключ можно ограничить так, чтобы он работал только с доверенных IP-адресов.

Откройте Ключи и нажмите на нужный ключ.
Выберите Список IP.
Добавьте или удалите адреса, которым разрешено использовать ключ.

Если список пустой, ключ работает с любого адреса.

10. Отзыв ключа¶

Откройте Ключи и нажмите на нужный ключ.
Выберите Отозвать.
Подтвердите.

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

11. История запросов и баланса¶

В главном меню выберите История.
Выберите период: 24ч, 7д, 30д, Всё время или Свои даты.
При выборе Свои даты отправьте начальную и конечную даты в формате ДД.ММ.ГГГГ. Бот интерпретирует их в зоне MSK (UTC+3), а конечная дата включается целиком.
Переключайтесь между вкладками Все, API и Пополнения. Выбранный период сохранится при смене вкладки и страницы.

В шапке бот показывает текущий баланс и сводку именно за выбранный период: подтверждённые расходы, входные/выходные токены и число запросов. Время в таблице всегда отображается в MSK.

Если Telegram-клиент или сервер не поддерживает rich-таблицу, бот автоматически переключится на обычный текстовый список с той же клавиатурой.

12. Обращение в поддержку¶

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

В разделе Мои обращения можно открыть карточку тикета и увидеть его статус, описание, публичные комментарии поддержки и число вложений. Кнопка Ответить открывает черновик, в который можно добавить текст, фото и документы. Отправка выполняется отдельной кнопкой Отправить, а по кнопке Открыть вложения бот заново пришлёт сохранённые файлы без повторной загрузки на сервер.

Если обращение уже было помечено как решённое или закрытое, ваш новый ответ автоматически переоткроет тикет.

Когда поддержка отвечает публично или меняет статус обращения, бот присылает отдельное уведомление с кнопкой Открыть обращение. Админы, в свою очередь, получают отдельные уведомления о новых обращениях, ваших публичных ответах, переоткрытии и количестве новых вложений. В уведомлениях не пересылаются полный текст комментария, описание обращения или metadata файлов.

Все времена в карточке обращения показываются в MSK.

Если вопрос связан с ошибочным пополнением или переносом доступа, в описании обращения сразу укажите:

ваш текущий Nexus ID;
номер заказа / инвойса;
что именно произошло: создан новый аккаунт, не тот Nexus ID, не виден баланс, потерян старый Telegram.

13. Доступные модели и цены¶

В главном меню выберите Модели, чтобы увидеть доступные вам модели и их цены в рублях.

В этом же разделе доступны кнопки Статус и Документация, а Назад возвращает в главное меню.

Экран моделей разбит по отдельным страницам семейств Claude, Gemini и GPT / Codex. Перед заголовком каждой страницы бот показывает фирменный custom emoji логотип семейства, а ячейки rich-таблицы центрируются для более читаемого вида. На каждой странице семейства бот показывает одну общую таблицу моделей: эндпоинт, стоимость входных токенов, выходных токенов и доступные cache-related цены. Под таблицей указан реальный интервал обновления данных.

Если Telegram-клиент не поддерживает rich-таблицу, бот автоматически покажет упрощённый текстовый список цен вместо ошибки.

Список зависит от настроек вашего ключа, поэтому ориентируйтесь на ответ /v1/models именно для своего ключа, а не на чужой пример.

Будьте в курсе¶

Новости и анонсы публикуются в нашем канале.