Darmowe API AI dla bota Discord lub Telegram
Bot czatu wysyła jedno żądanie do modelu za każdą wiadomość. Na ruchliwym serwerze jeden darmowy poziom osiąga limit w ciągu kilku minut. Ten poradnik łączy bota Discord i bota Telegram z FreeLLMAPI. FreeLLMAPI łączy 45 darmowych poziomów dostawców za jednym kluczem zgodnym z OpenAI i przechodzi do następnego dostawcy, gdy limit zatrzyma żądanie. Kod jest w Pythonie i jest kompletny.
Kod, nazwy modeli i etykiety z katalogu na żywo są podane po angielsku.
Najpierw zaplanuj limity
Darmowe poziomy ograniczają żądania na minutę i na dzień. Bot na serwerze z 200 aktywnymi użytkownikami może wysłać tysiące żądań dziennie. Przełączanie awaryjne rozkłada te żądania na wszystkie Twoje klucze, ale suma nadal jest sumą darmowych limitów.
- Odpowiadaj tylko na wezwanie. W Discordzie odpowiadaj tylko na wzmianki. W grupach Telegram odpowiadaj tylko na polecenia lub odpowiedzi.
- Ogranicz każdego użytkownika. Pozwól na jedno żądanie na użytkownika co kilka sekund.
- Trzymaj krótką historię. Wysyłaj ostatnie 10 wiadomości, a nie całą historię kanału.
- Używaj szybkiej trasy.
auto:fastukłada modele według szybkości. Użytkownicy czatu czekają krócej. - Kończ z uprzejmym komunikatem. Gdy wszystkie klucze są na limicie, poproś użytkownika, aby spróbował później.
Te darmowe modele mają dziś najszybszy zmierzony czas odpowiedzi. Wiele z nich ma wysokie limity żądań:
| Model | Za darmo w | Kontekst | Darmowe limity (najlepsza oferta) | Narzędzia | Wizja |
|---|---|---|---|---|---|
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 więcej | 262K | 30 żądań/min 250 żądań/dzień 70,000 tokenów/min ~6M | Tak | Tak |
| GPT-OSS 20B | Api.Airforce, Cloudflare Workers AI, Groq +4 więcej | 131K | 30 żądań/min 1,000 żądań/dzień 8,000 tokenów/min 200,000 tokenów/dzień ~6M | Tak | Nie |
| Nemotron 3.5 Lightning | ElectronHub, Gizmo, Kilo Gateway +2 więcej | 1M | 20 żądań/min 50 żądań/dzień 50 req/day account-wide (1,000 after a $10 purchase) | Tak | Nie |
| GPT-OSS 120B | Cloudflare Workers AI, ElectronHub, Groq +1 więcej | 131K | 30 żądań/min 1,000 żądań/dzień 8,000 tokenów/min 200,000 tokenów/dzień ~6M | Tak | Nie |
| GPT-OSS 20B (via Groq) | DreamPrompting | 131K | 100 żądań/min 5,000 żądań/dzień 500,000 tokenów/dzień 500K tokens/day · 5,000 req/day | Nie | Nie |
| GPT-OSS Safeguard 20B | Groq | 131K | 30 żądań/min 1,000 żądań/dzień 8,000 tokenów/min 200,000 tokenów/dzień ~6M | Tak | Nie |
| Groq Compound Mini | DreamPrompting | 131K | 100 żądań/min 5,000 żądań/dzień 500,000 tokenów/dzień 500K tokens/day · 5,000 req/day | Nie | Nie |
| Gemini 3.5 Flash Lite | ElectronHub, Google AI Studio | 1M | 15 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| Step 3.7 Flash | ElectronHub | 256K | $0.25/week shared recurring credit | Tak | Tak |
| Gemini 3.1 Flash-Lite | DreamPrompting, Google AI Studio | 1M | 100 żądań/min 5,000 żądań/dzień 500,000 tokenów/dzień 500K tokens/day · 5,000 req/day | Tak | Tak |
Pokazano 10 z 215 pasujących darmowych modeli. Zobacz wszystkie modele.
Dane na żywo z katalogu FreeLLMAPI (wersja 2026.11.19, sprawdzono 2026-11-19). Darmowe limity często się zmieniają. Katalog jest sprawdzany codziennie.
Wspólny kod: wywołanie modelu
Oba boty używają tego samego modułu. Trzyma krótką historię dla każdego czatu, wysyła jeden identyfikator sesji na czat i obsługuje limity szybkości. Najpierw zainstaluj FreeLLMAPI i skopiuj ujednolicony klucz ze strony Keys w panelu.
Instalacja
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 [""]Nagłówek X-Session-Id trzyma jeden czat na jednym modelu przez 30 minut. Bot wtedy zachowuje ten sam styl w rozmowie. Jeśli ten model osiągnie swój limit, router przechodzi do innego modelu, który dostaje tę samą historię.
Historia i przerwy są trzymane w pamięci. Giną po restarcie bota. Jeśli bot ma pamiętać długie rozmowy, zapisuj historię w bazie danych, na przykład SQLite lub Redis.
Bot Discord z discord.py
- Otwórz Discord Developer Portal i utwórz aplikację. Dodaj bota i skopiuj jego token.
- Na karcie bota przejdź do Privileged Gateway Intents. Włącz Message Content.
- Zaproś bota na swój serwer z zakresem
boti uprawnieniem Send Messages. - Ustaw token w zmiennej środowiskowej
DISCORD_TOKENi uruchom skrypt.
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"])Bot Telegram z python-telegram-bot
- W Telegramie otwórz @BotFather i wyślij
/newbot. Skopiuj token. - Ustaw token w zmiennej środowiskowej
TELEGRAM_TOKEN. - Uruchom skrypt. Wyślij wiadomość do swojego bota.
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()Status pisania w Telegramie utrzymuje się przez 5 sekund lub krócej. Przy wolnych modelach wyślij akcję czatu ponownie podczas długich żądań. Kod używa python-telegram-bot w wersji 22, która jest w pełni asynchroniczna.
Gotowi agenci botów
Jeśli nie chcesz pisać bota, dwaj agenci mogą odpowiadać na Discordzie i Telegramie i używać FreeLLMAPI jako modelu. FreeLLMAPI ma polecenie konfiguracji dla każdego z nich. Każde polecenie obsługuje --dry-run i najpierw tworzy kopię zapasową konfiguracji.
| Agent | Polecenie konfiguracji | Co zapisuje |
|---|---|---|
| OpenClaw | npx freellmapi setup-openclaw --url http://localhost:3001 --api-key <unified-key> | Dostawca freellmapi w ~/.openclaw/openclaw.json, domyślny model freellmapi/auto |
| Hermes Agent | npx freellmapi setup-hermes --url http://localhost:3001 --api-key <unified-key> | Własny blok modelu w ~/.hermes/config.yaml |
Działająca brama OpenClaw lub Hermes wymaga restartu po poleceniu konfiguracji.
Uruchom bota i FreeLLMAPI na tym samym komputerze lub serwerze. Bot wtedy łączy się z bramą pod localhost, a port bramy pozostaje zamknięty dla internetu. Do obu wystarczy mały serwer albo Raspberry Pi.
Rozwiązywanie problemów
| Problem | Przyczyna | Rozwiązanie |
|---|---|---|
| Bot Discord odczytuje puste wiadomości | Intent Message Content jest wyłączony | Włącz go w portalu i w intents.message_content |
| Bot odpowiada na własne wiadomości | Brak sprawdzenia autorów-botów | Zakończ funkcję, gdy message.author.bot jest prawdziwe |
| Błąd Discord 50035 przy długich odpowiedziach | Wiadomość ma więcej niż 2000 znaków | Podziel odpowiedź, jak w kodzie powyżej |
| "All free models are busy" wieczorem | Wszystkie klucze w łańcuchu są na dziennym limicie | Dodaj klucze od kolejnych dostawców. Wiele dziennych limitów resetuje się o północy UTC. |
| Wolne odpowiedzi | Wolny model albo długa historia | Użyj auto:fast i trzymaj 10 wiadomości lub mniej |
Connection refused z bota | Bot działa w Dockerze i używa localhost | Użyj host.docker.internal albo wspólnej sieci Docker |
Najczęstsze pytania
Czy istnieje darmowe API AI dla bota Discord?
Tak. Kilku dostawców ma darmowe poziomy, które działają z pakietem Python openai. FreeLLMAPI łączy je za jednym kluczem, więc ruchliwy bot może korzystać z limitów wielu dostawców.
Czy mogę zrobić darmowego bota AI na Telegramie?
Tak. Użyj python-telegram-bot dla bota i darmowego API zgodnego z OpenAI do odpowiedzi. Kod na tej stronie jest kompletny.
Jak sprawić, żeby mój bot AI nie trafiał w limity szybkości?
Odpowiadaj tylko na wzmianki lub polecenia, ogranicz każdego użytkownika do jednego żądania co kilka sekund, trzymaj krótką historię i dodaj klucze od kolejnych dostawców.
Dlaczego mój bot Discord dostaje puste treści wiadomości?
Intent Message Content jest wyłączony. Włącz go w Developer Portal na karcie bota i ustaw intents.message_content = True w kodzie.
Co się dzieje, gdy wszystkie darmowe modele są na limicie?
FreeLLMAPI zwraca błąd 429 z nagłówkiem Retry-After. Kod bota go łapie i prosi użytkownika, aby spróbował później.
Powiązane poradniki
- Darmowe API LLM w Pythonie
- Darmowe API LLM: limity żądań
- Darmowe bazowe URL-e API zgodne z OpenAI
- Darmowe API LLM dla agentów AI
- Darmowe API LLM bez karty kredytowej
Źródła
- discord.py docs: quickstart (sprawdzono 20 November 2026)
- discord.py docs: privileged intents (sprawdzono 20 November 2026)
- Discord developer docs: message resource (2000 character content limit) (sprawdzono 20 November 2026)
- python-telegram-bot v22 docs: echobot example (sprawdzono 20 November 2026)
- Telegram Bot API: sendMessage and sendChatAction (sprawdzono 20 November 2026)
- FreeLLMAPI docs: clients (OpenClaw, Hermes Agent, context handoff) (sprawdzono 20 November 2026)