Skip to content

Telegram Bot Guide

The Telegram bot is the easiest way to manage Nexus on your own. From the bot you can create a profile, top up your balance, issue and revoke API keys, set limits, open a support ticket, and check the model list.

The bot handle is @nexus_hubbot

1. Start the Bot

  1. Open Telegram and find @nexus_hubbot.
  2. Send /start.
  3. Choose your language when prompted.

The bot replies with the main menu. You can reopen it any time by sending /start again.

The command menu (the / button in Telegram) shows only the commands available to you: just /start before you have a profile, and the full set of balance, key, and support commands once your profile is set up. It refreshes after you sign in.

2. Create or Bind a Profile

A profile holds your balance, your API keys, and their settings.

  1. From the main menu, choose to create or bind a profile.
  2. Follow the prompts to confirm.

If you already have a Nexus profile, the bot links your Telegram account to it. If not, a new profile is created for you.

3. Top Up Your Balance

  1. From the main menu, choose Top up balance.
  2. Pick the amount.
  3. Complete the payment through the Digiseller checkout.
  4. The bot confirms once the balance is credited in rubles.

The balance is shared across all API keys on your profile.

4. Issue a Full API Key

After topping up, you can issue a full key with no time limit.

  1. In the main menu, choose API keys.
  2. Tap Issue a key.
  3. Copy the new key and store it securely.

Use the key as a Bearer token against the base URL https://api.nexus-hub.ru.

5. Name a Key and Set a Spending Limit

Helpful when you run several projects or want to cap usage.

  1. Open API keys and select the key.
  2. Choose Rename to give it a clear name.
  3. Choose Spending limit to set a maximum amount the key may spend.

A limit caps how much a single key can spend; once reached, that key stops until you raise the limit. The profile balance stays shared across keys.

6. Manage IP Allowlists

You can restrict a key so it only works from trusted IP addresses.

  1. Open API keys and select the key.
  2. Choose IP allowlist.
  3. Add or remove the addresses that are allowed to use the key.

If the allowlist is empty, the key works from any address.

7. Revoke a Key

  1. Open API keys and select the key.
  2. Choose Revoke.
  3. Confirm.

A revoked key stops working right away. Revoke any key you no longer use or that may have leaked.

8. Open a Support Ticket

  1. From the main menu, choose Support.
  2. Describe your question or issue.
  3. Send it. The bot creates a ticket and notifies you when there is a reply.

9. View Available Models and Prices

  1. From the main menu, choose Models to see the models available to you and their prices in rubles.

You can also check models for a specific key with the API:

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

The list depends on your key settings, so rely on this response rather than someone else's example.

Stay Updated

News and announcements are posted in our channel.