Что понадобится для бота на LLM
Для рабочего Telegram-бота на LLM нужны три вещи: токен бота от Telegram, ключ к языковой модели и немного кода-обвязки между ними.
Первое, токен бота. Его выдает @BotFather, официальный служебный бот Telegram для регистрации ботов. Токен выглядит как строка вида 123456:ABC-DEF..., по нему ваш код авторизуется в Bot API и получает право читать входящие сообщения и отправлять ответы.
Второе, доступ к модели. Нужен ключ провайдера с OpenAI-совместимым API: тогда подойдет стандартный OpenAI SDK, а модель выбирается значением поля model в запросе.
Третье, обвязка. Это скрипт, который получает сообщение из Telegram, передает его текст в модель через chat completions и отправляет ответ обратно в чат. На Python это компактный скрипт на aiogram или python-telegram-bot, на Node.js на Telegraf.
Шаг 1. Токен бота у @BotFather
Откройте в Telegram диалог с @BotFather и отправьте команду /newbot. BotFather попросит имя бота (отображаемое) и username, который должен заканчиваться на bot (например, my_llm_assistant_bot). После создания он пришлет токен доступа к Bot API.
Этот токен секретный: любой, у кого он есть, может управлять вашим ботом. Не коммитьте его в репозиторий и не вставляйте прямо в код, держите в переменной окружения (например, TELEGRAM_BOT_TOKEN). Если токен утек, отзовите его командой /revoke у того же @BotFather и получите новый.
Здесь же, у @BotFather, можно задать описание бота, аватар и список команд (/setcommands). Это влияет на то, как бот выглядит в интерфейсе Telegram, но для первого запуска достаточно одного токена.
Шаг 2. Ключ OpenAI-совместимого API
Модель, на которой думает бот, подключается по API провайдера. Выпустите ключ у провайдера с OpenAI-совместимым адресом и сохраните его в переменной окружения (LLM_API_KEY) рядом с токеном бота. Если провайдер дает несколько моделей через один адрес, бот переключается между ними сменой значения model.
Шаг 3. Код на Python: aiogram и OpenAI SDK
Ниже минимальный бот на aiogram. Логика простая: на каждое текстовое сообщение бот вызывает chat completions и отправляет ответ модели обратно в чат. Отличие от кода под официальный OpenAI SDK только в параметре base_url при создании клиента.
Обратите внимание на две детали. Первая: клиент OpenAI SDK создается один раз с адресом провайдера и вашим ключом. Вторая: для бота удобно держать system-подсказку и по желанию короткую историю диалога, чтобы ответы были в контексте.
import os
import asyncio
from aiogram import Bot, Dispatcher
from aiogram.types import Message
from openai import OpenAI
# Клиент модели: любой OpenAI-совместимый провайдер
llm = OpenAI(
api_key=os.environ["LLM_API_KEY"],
base_url="https://api.example.com/v1", # адрес вашего провайдера
)
bot = Bot(token=os.environ["TELEGRAM_BOT_TOKEN"])
dp = Dispatcher()
SYSTEM = "Ты дружелюбный ассистент. Отвечай кратко и по делу."
@dp.message()
async def on_message(message: Message) -> None:
resp = llm.chat.completions.create(
model="gpt-6-luna", # имя модели у провайдера
messages=[
{"role": "system", "content": SYSTEM},
{"role": "user", "content": message.text or ""},
],
)
await message.answer(resp.choices[0].message.content)
async def main() -> None:
await dp.start_polling(bot) # long polling, публичный адрес не нужен
if __name__ == "__main__":
asyncio.run(main())Во вкладках есть и вариант на python-telegram-bot: API библиотеки другой, но вызов модели тот же, chat.completions.create с нужным именем модели. Переключить бота на другую модель того же провайдера значит поменять одно значение model.
Шаг 4. Запуск: polling или webhook
У Telegram Bot API два способа получать обновления, и код выше по умолчанию использует long polling.
Long polling: бот сам периодически спрашивает у серверов Telegram новые сообщения. Работает откуда угодно, не нужен публичный HTTPS-адрес и настройка вебхука, достаточно запустить скрипт там, где есть доступ в интернет. Это удобный способ для разработки и небольших ботов. В aiogram это dp.start_polling(bot), в python-telegram-bot application.run_polling().
Webhook: Telegram сам присылает обновления POST-запросом на ваш HTTPS-URL. Нет постоянного опроса, обновления приходят сразу, это подходит для продакшена. Но нужен публичный адрес с валидным TLS-сертификатом и веб-сервер, принимающий запросы Telegram. Модель вызывается одинаково в обоих режимах.
Секреты (токен бота и ключ API) в любом варианте держите в переменных окружения, а не в коде.
Какую модель выбрать для бота
Большинству ботов (чат-ассистент, ответы на вопросы, обработка коротких сообщений) не нужна топовая модель. Важнее низкая цена за токен и приемлемая скорость, потому что бот делает много мелких запросов.
Разумные недорогие варианты: gpt-6-luna (OpenAI), deepseek-v4.1-flash (DeepSeek), claude-haiku-5-5 (Anthropic) и gemini-3.8-flash (Google). Все они рассчитаны на быстрые массовые запросы и стоят заметно дешевле флагманов вроде gpt-6-astra или claude-fable-5-1. Начните с одной дешевой модели, а если качество на вашем сценарии не устраивает, переключите бота на другую и сравните.
Проверка ключа на адресе PayClarus
Адрес https://payclarus.com/api/llm/v1 совместим с OpenAI Chat Completions: подойдет официальный SDK OpenAI для Python и Node.js или любой клиент с настройкой base_url. Ключ вида pcl_... выпускается в разделе «API-доступ» после входа на сайт. В примере модель gpt-6-luna, ее можно заменить на любую модель каталога. Ошибки, лимиты, потоковый ответ и настройка Cursor, Cline и Continue описаны в документации API.
# pip install openai
from openai import OpenAI
client = OpenAI(
api_key="pcl_...",
base_url="https://payclarus.com/api/llm/v1",
)
resp = client.chat.completions.create(
model="gpt-6-luna",
messages=[{"role": "user", "content": "Привет! Ответь одним предложением."}],
)
print(resp.choices[0].message.content)Калькулятор стоимости
Задайте нагрузку: сколько токенов уходит на запрос и сколько запросов в месяц. Расчет покажет месячную стоимость недорогих чат-моделей в рублях по ценам на сегодня.
При такой нагрузке дешевле всего выходит gpt-6-luna: 639 ₽ в месяц.
| Модель | За 1 запрос | В месяц |
|---|---|---|
| gpt-6-lunaдешевле всего | 0.06 ₽ | 639 ₽ |
| claude-haiku-5-5 | 0.08 ₽ | 781 ₽ |
| deepseek-v4.1-flash | 0.21 ₽ | 2 051 ₽ |
| gemini-3.8-flash | 0.51 ₽ | 5 091 ₽ |
Оценка по ценам каталога в рублях по курсу ЦБ на сегодня, без надбавки за длинный запрос. Реальный расход зависит от структуры промптов.
На что хватит пополнения
| Пополнение | Писем | Статей | Дней бота |
|---|---|---|---|
| 500 ₽ | 10 000 | 1 923 | 25 |
| 1 000 ₽ | 20 000 | 3 846 | 50 |
| 5 000 ₽ | 100 000 | 19 230 | 250 |
Размеры задач это наше допущение, а не замер: письмо: 1 запрос, 300 токенов на входе и 500 на выходе, статья: 1 запрос, 1 000 токенов на входе и 3 000 на выходе, бот: 100 диалогов в день по 4 запроса, в каждом 1 500 токенов на входе (история и инструкция) и 300 на выходе. Каждый запрос списывается по фактическим токенам и округляется вверх до копейки, поэтому длинные промпты и история диалога заметно меняют итог.
Цены по курсу ЦБ на сегодня. Весь каталог: /ai-tools/models/.
Смежные материалы
- Все модели и цены в рублях
- Модели OpenAI (gpt-6-luna)
- Модели DeepSeek (deepseek-v4.1-flash)
- DeepSeek API в России
- OpenAI API в России
Частые вопросы
Где взять токен бота?
Какую модель выбрать для Telegram-бота?
Сколько стоит держать бота?
Polling или webhook, что выбрать?
У меня уже есть код под официальный OpenAI SDK. Что менять при смене провайдера?
Можно ли купить доступ к моделям для бота у PayClarus?
Нужен доступ к моделям для бота?
Ключ можно получить сразу: войдите на PayClarus и в разделе «API-доступ» пополните баланс и выпустите ключ. Если задача нестандартная, опишите ее в заявке, ответим на email.