Как создать бота в Telegram: раздел «Код», API-ключ и ответы ИИ

Как создать бота в Telegram, который не только повторяет заготовки, но и сам отвечает по-человечески? Нужны две вещи: сам бот и нейросеть за ним. Мы покажем оба шага на нашем сервисе: в разделе «Код» бот собирается по шаблону без настройки серверов, а API-ключ выпускается на странице «API-ключи» — после этого бот отвечает текстом от языковой модели, а при желании рисует картинки, пишет музыку и озвучивает видео. Всю документацию читайте на neuralspace.pro/v1/docs — она открыта без регистрации.

Шаг 1. Соберите бота в разделе «Код»

Раздел «Код» — это чат с ИИ-программистом: вы описываете, что должно получиться, а он сам пишет код, правит файлы и запускает проект. Для бота здесь есть отдельный шаблон: в окне «Создать проект» выберите заготовку «Telegram бот» (выделите её текст и впишите свою роль — например, «помощник по моему расписанию, отвечает вежливо и коротко»), выберите модель из каталога и нажмите «Создать проект».

Больше ничего настраивать не нужно: размещение на платформе бесплатное, для сайта-проекта выдаётся адрес вида *.app.neuralspace.pro, а боты запускаются прямо из интерфейса проекта — «Открыть сайт» покажет состояние, чат проекта остаётся местом, куда вы пишете правки: «добавь кнопку», «отвечай списком», «исправь ошибку». Код в любой момент можно скачать ZIP-архивом или откатить к прошлой версии. Токены списываются только за сообщения программисту в чате проекта; просмотр проекта и скачивание — бесплатны.

Шаг 2. Выпустите API-ключ

Откройте страницу «API-ключи» в личном кабинете и создайте ключ: он имеет вид nsk-… и показывается ровно один раз — скопируйте его сразу. Ключ можно выпустить и проще: попросите программиста в чате проекта подключить нейросеть, и он запустит выпуск ключа, а вы подтвердите его в диалоге — молча ключ никому не создаётся.

Ключом авторизуется каждый вызов API. Передавайте его в заголовке x-api-key: nsk-… или, для SDK-совместимых клиентов, в заголовке Authorization: Bearer nsk-…. Базовый URL — https://neuralspace.pro: текстовые модели вызываются через POST /v1/chat/completions (совместим с распространённым форматом Chat Completions) и через POST /v1/messages. Если ваш код уже работал с чужим сервисом, достаточно поменять базовый URL и ключ — формат запросов останется тем же. Поддерживается и потоковый ответ (stream: true): ответы приходят через Server-Sent Events в формате выбранного SDK.

Шаг 3. Научите бота отвечать нейросетью

Минимальная логика бота — один обработчик сообщения: пришла фраза — отправляем её в модель и отправляем пользователю ответ. Пример на Python (проверено по живой документации):

import requests

def ask_ai(text):
    r = requests.post("https://neuralspace.pro/v1/chat/completions",
        headers={"x-api-key": "nsk-ВАШ_КЛЮЧ"},
        json={"model": "<модель>", "max_tokens": 1024,
              "messages": [{"role": "user", "content": text}]}, timeout=120)
    r.raise_for_status()
    return r.json()["choices"][0]["message"]["content"]

Имя модели берите из справочника: GET /v1/models вернёт актуальный каталог с ценами, баланс проверяется эндпоинтом GET /v1/balance. Системную роль с описанием характера бота («ты вежливый assistant магазина…») отправляйте сообщением с ролью system — так бот будет держать стиль, а историю переписки удобно передавать в массиве сообщений.

Бот умеет больше, чем текст

По тому же ключу бот может генерировать картинки (асинхронно: создали задачу POST /v1/images/generations — опрашиваете статус — забираете ссылку), музыку и видео, транскрибировать речь и озвучивать текст: все эндпоинты с примерами кода есть в одной таблице на странице документации. Если бот пишет не код, а управляет контентом — например, вы просите его в Telegram «сделай иллюстрацию к этому посту» — те же вызовы доступны и как MCP-сервер: подключите https://neuralspace.pro/mcp к своему ИИ-агенту, и он сам будет дёргать нужные инструменты от вашего аккаунта.

Сколько это стоит

Оплата идёт токенами баланса аккаунта: один токен — один рубль, пополнение с любой карты, без подписок и иностранных карт. Цены моделей по токенам совпадают с теми, что показаны в личном кабинете, — наценки за API нет. Ограничения, о которых стоит знать заранее: до пяти ключей на аккаунт, до 60 запросов в минуту на ключ и минимум 50 токенов на балансе для доступа к текстовым моделям. Потеряли ключ — отзовите старый и выпустите новый на той же странице.

Частые вопросы

Нужно ли уметь программировать? В разделе «Код» бот собирается по описанию: шаблон, роль бота, правки в чате. Пример обработчика выше — это уже готовая минимальная логика, код за вас допишет программист чата.

Бот сможет отвечать не только текстом? Да: картинки, музыка, видео и озвучка доступны по тому же ключу, часть из них — асинхронно (создали задачу — дождались статус).

Ключ показывается один раз — что если его потерять? Выпустите новый на странице «API-ключи» и отзовите старый: одновременно активны до пяти ключей.

Ответы бота идут по одному формату? Два SDK-совместимых формата на выбор (Chat Completions и Messages) — код под известные SDK меняет только базовый URL и ключ.