Головна / Посібники / Безкоштовний AI API для бота Discord або Telegram

Безкоштовний AI API для бота Discord або Telegram

Чат-бот надсилає один запит до моделі на кожне повідомлення. На жвавому сервері один безкоштовний рівень досягає ліміту за хвилини. Цей посібник підключає бота Discord і бота Telegram до FreeLLMAPI. FreeLLMAPI об'єднує безкоштовні рівні 45 провайдерів за одним ключем, сумісним з OpenAI, і переходить до наступного провайдера, коли ліміт зупиняє запит. Код написано на Python, він повний.

Код, назви моделей і мітки живого каталогу показано англійською.

Спершу плануйте ліміти

Безкоштовні рівні обмежують запити за хвилину і за день. Бот на сервері з 200 активними користувачами може надіслати тисячі запитів на день. Резервний перехід розподіляє ці запити між усіма вашими ключами, але загальна сума все одно дорівнює сумі безкоштовних лімітів.

  • Відповідайте лише на запит. У Discord відповідайте лише на згадки. У групах Telegram відповідайте лише на команди або відповіді.
  • Обмежуйте кожного користувача. Дозволяйте один запит від користувача кожні кілька секунд.
  • Тримайте історію короткою. Надсилайте останні 10 повідомлень, а не всю історію каналу.
  • Використовуйте швидкий маршрут. auto:fast ранжує моделі за швидкістю. Користувачі чату чекають менше.
  • Коректно обробляйте відмову. Коли всі ключі досягли ліміту, попросіть користувача спробувати пізніше.
Приватність: бот надсилає повідомлення користувачів провайдеру, який відповідає. Деякі безкоштовні рівні можуть використовувати промпти для покращення своїх моделей. Повідомте користувачів, що AI-сервіс читає їхні повідомлення. Прочитайте які безкоштовні LLM API навчаються на ваших даних і вилучіть з ланцюжка провайдерів, які вам не підходять.

Ці безкоштовні моделі мають найшвидшу виміряну швидкість на сьогодні. Багато з них мають високі ліміти запитів:

Швидкі безкоштовні моделі для чату
МодельБезкоштовно наКонтекстБезкоштовні ліміти (найкращі)ІнструментиЗображення
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo +ще 3262K30 запитів/хв
250 запитів/добу
70,000 токенів/хв
~6M
ТакТак
GPT-OSS 20BApi.Airforce, Cloudflare Workers AI, Groq +ще 4131K30 запитів/хв
1,000 запитів/добу
8,000 токенів/хв
200,000 токенів/добу
~6M
ТакНі
Nemotron 3.5 LightningElectronHub, Gizmo, Kilo Gateway +ще 21M20 запитів/хв
50 запитів/добу
50 req/day account-wide (1,000 after a $10 purchase)
ТакНі
GPT-OSS 120BCloudflare Workers AI, ElectronHub, Groq +ще 1131K30 запитів/хв
1,000 запитів/добу
8,000 токенів/хв
200,000 токенів/добу
~6M
ТакНі
GPT-OSS 20B (via Groq)DreamPrompting131K100 запитів/хв
5,000 запитів/добу
500,000 токенів/добу
500K tokens/day · 5,000 req/day
НіНі
GPT-OSS Safeguard 20BGroq131K30 запитів/хв
1,000 запитів/добу
8,000 токенів/хв
200,000 токенів/добу
~6M
ТакНі
Groq Compound MiniDreamPrompting131K100 запитів/хв
5,000 запитів/добу
500,000 токенів/добу
500K tokens/day · 5,000 req/day
НіНі
Gemini 3.5 Flash LiteElectronHub, Google AI Studio1M15 запитів/хв
20 запитів/добу
250,000 токенів/хв
~3M
ТакТак
Step 3.7 FlashElectronHub256K$0.25/week shared recurring creditТакТак
Gemini 3.1 Flash-LiteDreamPrompting, Google AI Studio1M100 запитів/хв
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

  1. Відкрийте Discord Developer Portal і створіть застосунок. Додайте бота і скопіюйте його токен.
  2. На вкладці bot перейдіть до Privileged Gateway Intents. Увімкніть Message Content.
  3. Запросіть бота на свій сервер з областю bot і дозволом Send Messages.
  4. Встановіть токен у змінній середовища 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

  1. У Telegram відкрийте @BotFather і надішліть /newbot. Скопіюйте токен.
  2. Встановіть токен у змінній середовища TELEGRAM_TOKEN.
  3. Запустіть скрипт. Надішліть повідомлення своєму боту.

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 і спочатку створює резервну копію конфігурації.

АгентКоманда налаштуванняЩо вона записує
OpenClawnpx freellmapi setup-openclaw --url http://localhost:3001 --api-key <unified-key>Провайдер freellmapi у ~/.openclaw/openclaw.json, модель за замовчуванням freellmapi/auto
Hermes Agentnpx 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
Використовуйте кожну з цих моделей через один ключ. FreeLLMAPI це маршрутизатор з відкритим кодом, який ви розгортаєте самі. Він об'єднує всі ці безкоштовні тарифи за однією кінцевою точкою, сумісною з OpenAI, і переходить до наступного, коли один з них досягає ліміту. Переглянути каталог або або почніть роботу.

Часті запитання

Чи є безкоштовний 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. Код бота перехоплює її і просить користувача спробувати пізніше.

Схожі посібники

Джерела

Усі посібники · Переглянути всі безкоштовні моделі