Бесплатный AI API для бота Discord или Telegram
Чат-бот отправляет один запрос к модели на каждое сообщение. На оживлённом сервере один бесплатный уровень достигает лимита за несколько минут. Это руководство подключает бота Discord и бота Telegram к FreeLLMAPI. FreeLLMAPI объединяет бесплатные уровни 45 провайдеров за одним ключом, совместимым с OpenAI, и переходит к следующему провайдеру, когда лимит останавливает запрос. Код написан на Python и полный.
Код, названия моделей и метки живого каталога показаны на английском языке.
Сначала спланируйте лимиты
Бесплатные уровни ограничивают запросы в минуту и в день. Бот на сервере с 200 активными пользователями может отправлять тысячи запросов в день. Переключение распределяет эти запросы между всеми вашими ключами, но общий объём по-прежнему равен сумме бесплатных лимитов.
- Отвечайте только по запросу. В Discord отвечайте только на упоминания. В группах Telegram отвечайте только на команды или ответы.
- Ограничивайте каждого пользователя. Разрешайте один запрос от пользователя каждые несколько секунд.
- Держите историю короткой. Отправляйте последние 10 сообщений, а не всю историю канала.
- Используйте быстрый маршрут.
auto:fastранжирует модели по скорости. Пользователи чата ждут меньше. - Вежливо сообщайте об ошибке. Когда все ключи достигли лимита, попросите пользователя попробовать позже.
У этих бесплатных моделей самая высокая измеренная скорость сегодня. У многих из них высокие лимиты запросов:
| Модель | Бесплатно в | Контекст | Бесплатные лимиты (лучшее предложение) | Инструменты | Зрение |
|---|---|---|---|---|---|
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo ещё +3 | 262K | 30 запр./мин 250 запр./день 70,000 токенов/мин ~6M | Да | Да |
| GPT-OSS 20B | Api.Airforce, Cloudflare Workers AI, Groq ещё +4 | 131K | 30 запр./мин 1,000 запр./день 8,000 токенов/мин 200,000 токенов/день ~6M | Да | Нет |
| Nemotron 3.5 Lightning | ElectronHub, Gizmo, Kilo Gateway ещё +2 | 1M | 20 запр./мин 50 запр./день 50 req/day account-wide (1,000 after a $10 purchase) | Да | Нет |
| GPT-OSS 120B | Cloudflare Workers AI, ElectronHub, Groq ещё +1 | 131K | 30 запр./мин 1,000 запр./день 8,000 токенов/мин 200,000 токенов/день ~6M | Да | Нет |
| GPT-OSS 20B (via Groq) | DreamPrompting | 131K | 100 запр./мин 5,000 запр./день 500,000 токенов/день 500K tokens/day · 5,000 req/day | Нет | Нет |
| GPT-OSS Safeguard 20B | Groq | 131K | 30 запр./мин 1,000 запр./день 8,000 токенов/мин 200,000 токенов/день ~6M | Да | Нет |
| Groq Compound Mini | DreamPrompting | 131K | 100 запр./мин 5,000 запр./день 500,000 токенов/день 500K tokens/day · 5,000 req/day | Нет | Нет |
| Gemini 3.5 Flash Lite | ElectronHub, Google AI Studio | 1M | 15 запр./мин 20 запр./день 250,000 токенов/мин ~3M | Да | Да |
| Step 3.7 Flash | ElectronHub | 256K | $0.25/week shared recurring credit | Да | Да |
| Gemini 3.1 Flash-Lite | DreamPrompting, Google AI Studio | 1M | 100 запр./мин 5,000 запр./день 500,000 токенов/день 500K tokens/day · 5,000 req/day | Да | Да |
Показано 10 из 215 подходящих бесплатных моделей. Смотреть все модели.
Актуальные данные из каталога FreeLLMAPI (версия 2026.11.19, проверено 2026-11-19). Бесплатные лимиты часто меняются. Каталог проверяется каждый день.
Общий код: вызов модели
Оба бота используют один модуль. Он хранит короткую историю для каждого чата, отправляет один ID сессии на каждый чат и обрабатывает лимиты частоты. Сначала установите FreeLLMAPI и скопируйте единый ключ со страницы Keys панели управления.
Установка
curl -fsSL https://freellmapi.co/install.sh | bash
python3 -m pip install -U openai discord.py python-telegram-bot
export FREELLMAPI_API_KEY=<unified-key>brain.py
import asyncio
import os
import time
from collections import defaultdict, deque
import openai
from openai import AsyncOpenAI
llm = AsyncOpenAI(
base_url="http://localhost:3001/v1",
api_key=os.environ["FREELLMAPI_API_KEY"],
max_retries=2,
timeout=60,
)
SYSTEM = "You are a helpful chat bot. Answer in short paragraphs."
history = defaultdict(lambda: deque(maxlen=10)) # chat id -> last 10 messages
last_call = {} # user id -> time of the last request
COOLDOWN_S = 5
async def ask(chat_id: str, user_id: str, text: str) -> str:
now = time.monotonic()
if now - last_call.get(user_id, 0) < COOLDOWN_S:
return "Please wait a few seconds before the next question."
last_call[user_id] = now
turns = history[chat_id]
turns.append({"role": "user", "content": text[:4000]})
messages = [{"role": "system", "content": SYSTEM}, *turns]
for attempt in range(3):
try:
resp = await llm.chat.completions.create(
model="auto:fast",
messages=messages,
max_tokens=800,
extra_headers={"X-Session-Id": f"chat-{chat_id}"},
)
answer = resp.choices[0].message.content or "(no answer)"
turns.append({"role": "assistant", "content": answer})
return answer
except openai.RateLimitError as err:
header = err.response.headers.get("retry-after", "")
wait = int(header) if header.isdigit() else 2 ** attempt
if wait > 30:
break
await asyncio.sleep(wait)
except openai.APIError:
break
turns.pop() # forget the unanswered question
return "All free models are busy now. Please try again later."
def split(text: str, size: int) -> list[str]:
return [text[i:i + size] for i in range(0, len(text), size)] or [""]Заголовок X-Session-Id держит один чат на одной модели 30 минут. Так бот сохраняет один стиль в разговоре. Если эта модель достигает лимита, маршрутизатор переходит к другой модели, которая получает ту же историю.
История и задержки хранятся в памяти. При перезапуске бота они теряются. Если боту нужно помнить долгие разговоры, храните историю в базе данных, например SQLite или Redis.
Бот Discord с discord.py
- Откройте Discord Developer Portal и создайте приложение. Добавьте бота и скопируйте его токен.
- На вкладке бота перейдите к Privileged Gateway Intents. Включите Message Content.
- Пригласите бота на сервер с областью
botи правом Send Messages. - Задайте токен в переменной окружения
DISCORD_TOKENи запустите скрипт.
discord_bot.py
import os
import discord
from brain import ask, split
intents = discord.Intents.default()
intents.message_content = True
client = discord.Client(intents=intents)
@client.event
async def on_ready():
print(f"Logged in as {client.user}")
@client.event
async def on_message(message: discord.Message):
if message.author.bot or client.user not in message.mentions:
return
text = message.content
for tag in (f"<@{client.user.id}>", f"<@!{client.user.id}>"):
text = text.replace(tag, "")
text = text.strip()
if not text:
return
async with message.channel.typing():
answer = await ask(str(message.channel.id), str(message.author.id), text)
parts = split(answer, 2000) # Discord limit: 2000 characters
await message.reply(parts[0])
for part in parts[1:]:
await message.channel.send(part)
client.run(os.environ["DISCORD_TOKEN"])Бот Telegram с python-telegram-bot
- В Telegram откройте @BotFather и отправьте
/newbot. Скопируйте токен. - Задайте токен в переменной окружения
TELEGRAM_TOKEN. - Запустите скрипт. Отправьте сообщение своему боту.
telegram_bot.py
import os
from telegram import Update
from telegram.constants import ChatAction
from telegram.ext import Application, ContextTypes, MessageHandler, filters
from brain import ask, split
async def on_text(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
chat_id = update.effective_chat.id
await context.bot.send_chat_action(chat_id=chat_id, action=ChatAction.TYPING)
answer = await ask(str(chat_id), str(update.effective_user.id), update.message.text)
for part in split(answer, 4096): # Telegram limit: 4096 characters
await update.message.reply_text(part)
def main() -> None:
app = Application.builder().token(os.environ["TELEGRAM_TOKEN"]).build()
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, on_text))
app.run_polling(allowed_updates=Update.ALL_TYPES)
if __name__ == "__main__":
main()Статус «печатает» в Telegram держится 5 секунд или меньше. Для медленных моделей отправляйте действие чата повторно во время долгих запросов. Код использует python-telegram-bot версии 22, которая полностью асинхронная.
Готовые агенты для ботов
Если вы не хотите писать бота, два агента могут отвечать в Discord и Telegram и использовать FreeLLMAPI как свою модель. У FreeLLMAPI есть команда настройки для каждого из них. Каждая команда поддерживает --dry-run и сначала создаёт резервную копию конфигурации.
| Агент | Команда настройки | Что записывает |
|---|---|---|
| OpenClaw | npx freellmapi setup-openclaw --url http://localhost:3001 --api-key <unified-key> | Провайдер freellmapi в ~/.openclaw/openclaw.json, модель по умолчанию freellmapi/auto |
| Hermes Agent | npx freellmapi setup-hermes --url http://localhost:3001 --api-key <unified-key> | Пользовательский блок модели в ~/.hermes/config.yaml |
Работающий шлюз OpenClaw или Hermes нужно перезапустить после команды настройки.
Запускайте бота и FreeLLMAPI на одном компьютере или сервере. Тогда бот обращается к шлюзу по localhost, а порт шлюза остаётся закрытым для интернета. Для обоих хватит небольшого сервера или Raspberry Pi.
Устранение неполадок
| Проблема | Причина | Решение |
|---|---|---|
| Бот Discord читает пустые сообщения | Intent Message Content выключен | Включите его в портале и в intents.message_content |
| Бот отвечает на собственные сообщения | Нет проверки авторов-ботов | Выходите из обработчика, когда message.author.bot равно true |
| Ошибка Discord 50035 на длинных ответах | Сообщение длиннее 2000 символов | Разбейте ответ, как в коде выше |
| «Все бесплатные модели заняты» вечером | Все ключи в цепочке достигли дневного лимита | Добавьте ключи от других провайдеров. Многие дневные лимиты сбрасываются в полночь по UTC. |
| Медленные ответы | Медленная модель или длинная история | Используйте auto:fast и держите 10 сообщений или меньше |
Connection refused от бота | Бот работает в Docker и использует localhost | Используйте host.docker.internal или общую сеть Docker |
Часто задаваемые вопросы
Есть ли бесплатный AI API для бота Discord?
Да. Несколько провайдеров имеют бесплатные уровни, которые работают с пакетом openai для Python. FreeLLMAPI объединяет их за одним ключом, поэтому загруженный бот может использовать лимиты многих провайдеров.
Можно ли сделать бесплатного AI-бота для Telegram?
Да. Используйте python-telegram-bot для бота и бесплатный API, совместимый с OpenAI, для ответов. Код на этой странице полный.
Как не допустить, чтобы мой AI-бот упирался в лимиты частоты?
Отвечайте только на упоминания или команды, ограничивайте каждого пользователя одним запросом каждые несколько секунд, держите историю короткой и добавьте ключи от других провайдеров.
Почему мой бот Discord получает пустое содержимое сообщений?
Intent Message Content выключен. Включите его в Developer Portal на вкладке бота и задайте в коде intents.message_content = True.
Что происходит, когда все бесплатные модели достигли лимита?
FreeLLMAPI возвращает ошибку 429 с заголовком Retry-After. Код бота перехватывает её и просит пользователя попробовать позже.
Похожие руководства
- Бесплатный LLM API на Python
- Лимиты запросов бесплатного LLM API
- Базовые URL бесплатных API, совместимых с OpenAI
- Бесплатный LLM API для ИИ-агентов
- Бесплатный LLM API без банковской карты
Источники
- discord.py docs: quickstart (проверено 20 November 2026)
- discord.py docs: privileged intents (проверено 20 November 2026)
- Discord developer docs: message resource (2000 character content limit) (проверено 20 November 2026)
- python-telegram-bot v22 docs: echobot example (проверено 20 November 2026)
- Telegram Bot API: sendMessage and sendChatAction (проверено 20 November 2026)
- FreeLLMAPI docs: clients (OpenClaw, Hermes Agent, context handoff) (проверено 20 November 2026)