Безкоштовний 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 і створіть застосунок. Додайте бота і скопіюйте його токен.
- На вкладці bot перейдіть до 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 читає порожні повідомлення | Намір Message Content вимкнено | Увімкніть його в порталі і в intents.message_content |
| Бот відповідає на власні повідомлення | Немає перевірки авторів-ботів | Завершуйте обробку, коли message.author.bot має значення true |
| Помилка Discord 50035 на довгих відповідях | Повідомлення довше за 2000 символів | Розбийте відповідь, як у коді вище |
| Повідомлення "All free models are busy" увечері | Усі ключі в ланцюжку досягли денного ліміту | Додайте ключі від більшої кількості провайдерів. Багато денних лімітів скидаються о півночі за 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 отримує порожній вміст повідомлень?
Намір Message Content вимкнено. Увімкніть його в Developer Portal на вкладці bot і встановіть intents.message_content = True у коді.
Що відбувається, коли всі безкоштовні моделі досягли свого ліміту?
FreeLLMAPI повертає помилку 429 із заголовком Retry-After. Код бота перехоплює її і просить користувача спробувати пізніше.
Схожі посібники
- Безкоштовний LLM API на Python
- Ліміти запитів безкоштовного LLM API
- Базові URL безкоштовних API, сумісних з OpenAI
- Безкоштовний LLM API для AI-агентів
- Безкоштовний 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)