Telegram-бот на LLM: как собрать своего бота на Python

от 16 ₽ за 1 млн входных токенов, списание по факту. Пополнение от 500,00 ₽.

Подключить API

Telegram-бот на LLM принимает сообщения пользователей и отвечает через языковую модель. Собрать его можно за четыре шага: получить токен бота у @BotFather, получить ключ OpenAI-совместимого API, написать код на Python (aiogram или python-telegram-bot) с обычным OpenAI SDK и своим base_url, а затем запустить бота через long polling или webhook. Адрес api.example.com и ключ LLM_API_KEY в примерах условные, подставьте данные своего провайдера.

API-доступ к моделям через PayClarus

OpenAI-совместимый адрес https://payclarus.com/api/llm/v1, свой ключ и баланс в рублях. Списание по фактическим токенам каждого запроса. Пополнение от 500,00 ₽ картой или через СБП.

  1. Войдите или зарегистрируйтесь на PayClarus.
  2. В личном кабинете, раздел «API-доступ», пополните баланс и выпустите ключ.
  3. Укажите ключ и адрес в OpenAI SDK или любом клиенте с настройкой base_url.
Подключить API
Цены API за 1 млн токенов (29 моделей)
МодельВходВыход
claude-fable-5-11 953 ₽9 764 ₽
claude-haiku-5-5запрос длиннее 100 тыс. токенов: вход ×5, выход ×520 ₽98 ₽
claude-opus-5-5782 ₽3 906 ₽
claude-sonnet-5-5391 ₽1 953 ₽
deepseek-v4-pro176 ₽528 ₽
deepseek-v4.1-flash59 ₽235 ₽
doubao-seed-2-1-pro-260915176 ₽879 ₽
doubao-seed-2-1-turbo-26062888 ₽440 ₽
gemini-3.1-flash-lite43 ₽255 ₽
gemini-3.1-pro-previewзапрос длиннее 200 тыс. токенов: вход ×2, выход ×1,5340 ₽2 037 ₽
gemini-3.8-flash128 ₽637 ₽
gemini-4-argon340 ₽1 697 ₽
glm-5.3274 ₽860 ₽
glm-5.3-flash30 ₽98 ₽
gpt-4o-mini24 ₽96 ₽
gpt-5.3-codex229 ₽1 828 ₽
gpt-6-astraзапрос длиннее 272 тыс. токенов: вход ×2, выход ×1,51 598 ₽7 989 ₽
gpt-6-lunaзапрос длиннее 272 тыс. токенов: вход ×2, выход ×1,516 ₽80 ₽
gpt-6.1-solзапрос длиннее 272 тыс. токенов: вход ×2, выход ×1,5320 ₽1 598 ₽
gpt-6.1-terraзапрос длиннее 272 тыс. токенов: вход ×2, выход ×1,5160 ₽799 ₽
grok-4.3запрос длиннее 200 тыс. токенов: вход ×2, выход ×298 ₽196 ₽
grok-4.7запрос длиннее 200 тыс. токенов: вход ×2, выход ×2157 ₽470 ₽
kimi-k3400 ₽1 998 ₽
kimi-k3.1-pro391 ₽1 953 ₽
MiniMax-M3запрос длиннее 512 тыс. токенов: вход ×2, выход ×259 ₽235 ₽
MiniMax-M3.1-Flash20 ₽80 ₽
qwen3.7-plusзапрос длиннее 256 тыс. токенов: вход ×3, выход ×379 ₽313 ₽
qwen3.8-flash30 ₽92 ₽
qwen3.8-max391 ₽1 172 ₽

Цены на 22/11/2026 по курсу ЦБ, пересчитываются каждый день и округлены вверх до рубля. Списываем по фактическому числу токенов каждого запроса, итоговую сумму округляем вверх до копейки. Если под моделью есть пометка, запрос длиннее указанного порога списывается целиком по цене с надбавкой.

Цены по курсу ЦБ · 22/11/2026

Что понадобится для бота на 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-50.08 ₽781 ₽
deepseek-v4.1-flash0.21 ₽2 051 ₽
gemini-3.8-flash0.51 ₽5 091 ₽

Оценка по ценам каталога в рублях по курсу ЦБ на сегодня, без надбавки за длинный запрос. Реальный расход зависит от структуры промптов.

На что хватит пополнения

ПополнениеПисемСтатейДней бота
500 ₽10 0001 92325
1 000 ₽20 0003 84650
5 000 ₽100 00019 230250

Размеры задач это наше допущение, а не замер: письмо: 1 запрос, 300 токенов на входе и 500 на выходе, статья: 1 запрос, 1 000 токенов на входе и 3 000 на выходе, бот: 100 диалогов в день по 4 запроса, в каждом 1 500 токенов на входе (история и инструкция) и 300 на выходе. Каждый запрос списывается по фактическим токенам и округляется вверх до копейки, поэтому длинные промпты и история диалога заметно меняют итог.

Цены по курсу ЦБ на сегодня. Весь каталог: /ai-tools/models/.

Смежные материалы

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

Где взять токен бота?
Токен выдает @BotFather, служебный бот Telegram для регистрации ботов. Откройте с ним диалог, отправьте /newbot, задайте имя и username (заканчивается на bot), и он пришлет токен доступа к Bot API. Храните токен в переменной окружения, а не в коде. При утечке отзовите его командой /revoke и получите новый.
Какую модель выбрать для Telegram-бота?
Для чат-ботов обычно достаточно недорогой быстрой модели, например gpt-6-luna, deepseek-v4.1-flash, claude-haiku-5-5 или gemini-3.8-flash. Начните с дешевой модели и смените, если качество на вашем сценарии не устроит.
Сколько стоит держать бота?
Зависит от выбранной модели и объема трафика: API оплачивается за токены. Цены за 1M токенов в рублях есть в каталоге моделей и в калькуляторе на этой странице.
Polling или webhook, что выбрать?
Long polling проще: бот сам опрашивает Telegram, публичный HTTPS-адрес не нужен, это удобно для разработки и небольших ботов. Webhook отдает обновления сразу POST-запросом на ваш URL, но требует публичного адреса с валидным TLS-сертификатом и подходит для продакшена. Модель вызывается одинаково в обоих режимах.
У меня уже есть код под официальный OpenAI SDK. Что менять при смене провайдера?
Если провайдер OpenAI-совместимый, обычно меняются base_url (в Node.js baseURL), ключ и имя модели. Вызовы chat.completions.create и структура messages остаются теми же.
Можно ли купить доступ к моделям для бота у PayClarus?
Да. Войдите на PayClarus и откройте раздел «API-доступ»: пополните баланс в рублях, выпустите ключ и укажите его вместе с адресом API в OpenAI SDK или любом клиенте с настройкой base_url. Списание по фактическим токенам каждого запроса.

Нужен доступ к моделям для бота?

Ключ можно получить сразу: войдите на PayClarus и в разделе «API-доступ» пополните баланс и выпустите ключ. Если задача нестандартная, опишите ее в заявке, ответим на email.