Главная / Руководства / Бесплатный AI API для бота Discord или Telegram

Бесплатный AI API для бота Discord или Telegram

Чат-бот отправляет один запрос к модели на каждое сообщение. На оживлённом сервере один бесплатный уровень достигает лимита за несколько минут. Это руководство подключает бота Discord и бота Telegram к FreeLLMAPI. FreeLLMAPI объединяет бесплатные уровни 45 провайдеров за одним ключом, совместимым с OpenAI, и переходит к следующему провайдеру, когда лимит останавливает запрос. Код написан на Python и полный.

Код, названия моделей и метки живого каталога показаны на английском языке.

Сначала спланируйте лимиты

Бесплатные уровни ограничивают запросы в минуту и в день. Бот на сервере с 200 активными пользователями может отправлять тысячи запросов в день. Переключение распределяет эти запросы между всеми вашими ключами, но общий объём по-прежнему равен сумме бесплатных лимитов.

  • Отвечайте только по запросу. В Discord отвечайте только на упоминания. В группах Telegram отвечайте только на команды или ответы.
  • Ограничивайте каждого пользователя. Разрешайте один запрос от пользователя каждые несколько секунд.
  • Держите историю короткой. Отправляйте последние 10 сообщений, а не всю историю канала.
  • Используйте быстрый маршрут. auto:fast ранжирует модели по скорости. Пользователи чата ждут меньше.
  • Вежливо сообщайте об ошибке. Когда все ключи достигли лимита, попросите пользователя попробовать позже.
Конфиденциальность: бот отправляет сообщения пользователей провайдеру, который отвечает. Некоторые бесплатные уровни могут использовать запросы для улучшения своих моделей. Сообщите пользователям, что сервис ИИ читает их сообщения. Прочитайте какие бесплатные 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. На вкладке бота перейдите к 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 читает пустые сообщения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
Используйте каждую из этих моделей через один ключ. FreeLLMAPI это маршрутизатор с открытым исходным кодом, который работает на вашем сервере. Он объединяет все эти бесплатные тарифы за одной конечной точкой, совместимой с OpenAI, и переключается на другой провайдер, когда достигнут лимит запросов. Открыть каталог или перейти.

Часто задаваемые вопросы

Есть ли бесплатный 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. Код бота перехватывает её и просит пользователя попробовать позже.

Похожие руководства

Источники

Все руководства · Смотреть все бесплатные модели