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

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

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

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

Откройте Telegram и найдите @nexus_hubbot.
Отправьте /start.
Выберите язык, когда бот предложит.

После выбора языка бот покажет главное меню. Открыть его заново можно в любой момент командой /start.

Главное меню разделено на верхний уровень: Профиль, Информация, Поддержка и, для администраторов, Админ.

Меню команд (кнопка / в Telegram) показывает только доступные вам команды: до создания профиля это лишь /start, после настройки профиля — команды для баланса, ключей и поддержки, а для замороженного профиля остаются только /start, /ticket и /tickets. Оно обновляется после входа и после смены языка.

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

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

После выбора языка выберите один из вариантов:
Создать новый Nexus аккаунт, если вы начинаете с нуля;
У меня уже есть Nexus ID, если нужно восстановить доступ через старый Telegram;
Я оплатил, но не вижу баланс, если платёж ушёл не туда или профиль был создан без 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. Если вы оплатили, но не видите баланс¶

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

В главном меню откройте Профиль.
Выберите История.
Переключайтесь между вкладками Все, API и Пополнения.

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

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

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

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

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

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

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

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

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

Таблица моделей разделена по семействам: Anthropic / Claude и OpenAI / Codex. Для каждой модели бот показывает стоимость входных токенов, выходных токенов и доступные cache-related цены. Под таблицей указан реальный интервал обновления данных.

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

Также модели для конкретного ключа можно проверить через API:

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

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

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

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