Гайд
API для Telegram-бота: ключ, лимиты и расход
Telegram-бот вызывает модель со своего сервера: главное — не вставлять ключ в клиент и ограничить расход. В чате легко получить сотни запросов в минуту, и лимит на ключ здесь важнее экономии на модели.
Обновлено
Схема работы
Telegram присылает сообщение на ваш webhook. Сервер бота вызывает POST /v1/chat/completions с ключом LLMcode и отправляет ответ обратно в чат.
Ключ живёт только на сервере — в переменной окружения. В mini app и в браузере ключ не нужен: там запрос идёт на ваш бэкенд.
- Ключ: отдельный для бота, с лимитом UT
- Сеть: исходящий HTTPS с сервера бота
- Текст ответа модели LLMcode не хранит — только метаданные и usage
Защита от перерасхода
Поставьте лимит UT на ключ и ограничьте длину ответа (max_tokens). Для групповых чатов добавьте антифлуд на стороне бота: лимит API — 600 запросов в минуту, но бюджет может кончиться раньше.
Если бот нужен нескольким проектам, выпустите отдельные ключи: расход и отзыв не пересекаются.
И про код: вызов модели — блокирующий HTTP. В async-хендлере aiogram оборачивайте его в asyncio.to_thread, иначе один долгий ответ остановит обработку остальных сообщений.
Что учитывать в продукте
Стоимость запроса зависит от длины контекста. Если бот тащит всю историю чата, счёт растёт быстро: обрезайте историю и кэшируйте системный промпт на стороне бота.
Ошибки 402 и 429 нужно показывать пользователю по-разному: «пополните баланс» и «слишком часто».
Подключение
curl https://llmcode.io/v1/chat/completions \
-H "Authorization: Bearer $LLMCODE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-flash","messages":[{"role":"user","content":"Привет"}]}'import asyncio
import os
from aiogram import Bot, Dispatcher, F
from aiogram.types import Message
from openai import OpenAI
client = OpenAI(
base_url="https://llmcode.io/v1",
api_key=os.environ["LLMCODE_API_KEY"],
)
dp = Dispatcher()
@dp.message(F.text)
async def answer(message: Message) -> None:
reply = await asyncio.to_thread(
client.chat.completions.create,
model="deepseek-flash",
messages=[{"role": "user", "content": message.text}],
max_tokens=400,
)
await message.answer(reply.choices[0].message.content)
asyncio.run(dp.start_polling(Bot(os.environ["TELEGRAM_BOT_TOKEN"])))Цены опубликованных моделей
Цена за 1M токенов в USD. Числа приходят из публичного каталога при каждой сборке страницы — это цена продажи, а не оценка.
| Модель | Вход | Выход | Кэш |
|---|---|---|---|
| Claude Opus 5.5 | $2.70 | $8.00 | $0.14 |
| DeepSeek Flash | $0.50 | $2.00 | $0.01 |
| Claude Sonnet 5.5 | $1.33 | $6.67 | $0.07 |
| DeepSeek V4 Pro | $2.20 | $6.60 | $0.07 |
Пополнение от $10, баланс в USD. 1 USD = 1 000 000 UT. Подписки и автосписаний нет.
Вопросы и ответы
Можно ли вызывать API прямо из Telegram Web App?
Технически можно, но ключ станет виден пользователю. Правильно — через свой сервер.
Как ограничить расход бота?
Лимит UT на ключе, max_tokens в запросе и антифлуд в боте. Это три независимых ограничителя.
Хранит ли LLMcode переписку?
Текст ответа модели не хранится. В журнал пишутся метаданные и usage: модель, токены, задержка, код ответа.
Какой лимит запросов?
По умолчанию 600 запросов в минуту и 60 одновременных стримов на ключ. Оператор может изменить лимит.