Kostenlose KI-API für einen Discord- oder Telegram-Bot
Ein Chat-Bot sendet für jede Nachricht eine Modellanfrage. Auf einem belebten Server erreicht eine kostenlose Stufe ihr Limit in wenigen Minuten. Diese Anleitung verbindet einen Discord-Bot und einen Telegram-Bot mit FreeLLMAPI. FreeLLMAPI bündelt 45 kostenlose Anbieter-Stufen hinter einem OpenAI-kompatiblen Schlüssel und wechselt zum nächsten Anbieter, wenn ein Limit eine Anfrage stoppt. Der Code ist Python und vollständig.
Code, Modellnamen und Bezeichnungen aus dem Live-Katalog werden auf Englisch angezeigt.
Planen Sie zuerst die Limits
Kostenlose Stufen begrenzen Anfragen pro Minute und pro Tag. Ein Bot auf einem Server mit 200 aktiven Nutzern kann Tausende Anfragen pro Tag senden. Das Failover verteilt diese Anfragen auf alle Ihre Schlüssel, aber die Summe ist weiterhin die Summe der kostenlosen Limits.
- Antworten Sie nur auf Anfragen. In Discord antworten Sie nur auf Erwähnungen. In Telegram-Gruppen antworten Sie nur auf Befehle oder Antworten.
- Begrenzen Sie jeden Benutzer. Erlauben Sie eine Anfrage pro Benutzer alle paar Sekunden.
- Halten Sie den Verlauf kurz. Senden Sie die letzten 10 Nachrichten, nicht den gesamten Kanalverlauf.
- Verwenden Sie eine schnelle Route.
auto:fastordnet Modelle nach Geschwindigkeit. Chat-Nutzer warten weniger. - Reagieren Sie freundlich auf Fehler. Wenn alle Schlüssel ihr Limit erreicht haben, bitten Sie den Benutzer, es später erneut zu versuchen.
Diese kostenlosen Modelle haben heute die schnellste gemessene Geschwindigkeit. Viele davon haben hohe Anfragelimits:
| Modell | Kostenlos bei | Kontext | Kostenlose Limits (bestes Angebot) | Tools | Bildverarbeitung |
|---|---|---|---|---|---|
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 weitere | 262K | 30 Anfragen/Min. 250 Anfragen/Tag 70,000 Token/Min. ~6M | Ja | Ja |
| GPT-OSS 20B | Api.Airforce, Cloudflare Workers AI, Groq +4 weitere | 131K | 30 Anfragen/Min. 1,000 Anfragen/Tag 8,000 Token/Min. 200,000 Token/Tag ~6M | Ja | Nein |
| Nemotron 3.5 Lightning | ElectronHub, Gizmo, Kilo Gateway +2 weitere | 1M | 20 Anfragen/Min. 50 Anfragen/Tag 50 req/day account-wide (1,000 after a $10 purchase) | Ja | Nein |
| GPT-OSS 120B | Cloudflare Workers AI, ElectronHub, Groq +1 weitere | 131K | 30 Anfragen/Min. 1,000 Anfragen/Tag 8,000 Token/Min. 200,000 Token/Tag ~6M | Ja | Nein |
| GPT-OSS 20B (via Groq) | DreamPrompting | 131K | 100 Anfragen/Min. 5,000 Anfragen/Tag 500,000 Token/Tag 500K tokens/day · 5,000 req/day | Nein | Nein |
| GPT-OSS Safeguard 20B | Groq | 131K | 30 Anfragen/Min. 1,000 Anfragen/Tag 8,000 Token/Min. 200,000 Token/Tag ~6M | Ja | Nein |
| Groq Compound Mini | DreamPrompting | 131K | 100 Anfragen/Min. 5,000 Anfragen/Tag 500,000 Token/Tag 500K tokens/day · 5,000 req/day | Nein | Nein |
| Gemini 3.5 Flash Lite | ElectronHub, Google AI Studio | 1M | 15 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| Step 3.7 Flash | ElectronHub | 256K | $0.25/week shared recurring credit | Ja | Ja |
| Gemini 3.1 Flash-Lite | DreamPrompting, Google AI Studio | 1M | 100 Anfragen/Min. 5,000 Anfragen/Tag 500,000 Token/Tag 500K tokens/day · 5,000 req/day | Ja | Ja |
Es werden 10 von 215 passenden kostenlosen Modellen angezeigt. Alle Modelle ansehen.
Live-Daten aus dem FreeLLMAPI-Katalog (Version 2026.11.19, geprüft 2026-11-19). Kostenlose Limits ändern sich oft. Der Katalog wird jeden Tag geprüft.
Gemeinsamer Code: der Modellaufruf
Beide Bots verwenden dasselbe Modul. Es behält einen kurzen Verlauf für jeden Chat, sendet eine Sitzungs-ID pro Chat und behandelt Rate-Limits. Installieren Sie zuerst FreeLLMAPI und kopieren Sie den einheitlichen Schlüssel von der Seite Keys im Dashboard.
Installation
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 [""]Der Header X-Session-Id hält einen Chat 30 Minuten lang bei einem Modell. Der Bot behält dann den gleichen Stil in einem Gespräch bei. Wenn dieses Modell sein Limit erreicht, wechselt der Router zu einem anderen Modell, das denselben Verlauf erhält.
Verlauf und Sperrzeiten werden im Speicher gehalten. Sie gehen verloren, wenn der Bot neu startet. Für einen Bot, der lange Gespräche behalten muss, speichern Sie den Verlauf in einer Datenbank wie SQLite oder Redis.
Discord-Bot mit discord.py
- Öffnen Sie das Discord Developer Portal und erstellen Sie eine Anwendung. Fügen Sie einen Bot hinzu und kopieren Sie sein Token.
- Gehen Sie im Reiter Bot zu Privileged Gateway Intents. Aktivieren Sie Message Content.
- Laden Sie den Bot mit dem Scope
botund der Berechtigung Send Messages auf Ihren Server ein. - Legen Sie das Token in der Umgebungsvariable
DISCORD_TOKENfest und starten Sie das Skript.
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-Bot mit python-telegram-bot
- Öffnen Sie in Telegram @BotFather und senden Sie
/newbot. Kopieren Sie das Token. - Legen Sie das Token in der Umgebungsvariable
TELEGRAM_TOKENfest. - Starten Sie das Skript. Senden Sie dann eine Nachricht an Ihren Bot.
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()Der Schreibstatus in Telegram bleibt 5 Sekunden oder weniger. Bei langsamen Modellen senden Sie die Chat-Aktion während langer Anfragen erneut. Der Code verwendet python-telegram-bot in Version 22, die vollständig asynchron ist.
Fertige Bot-Agenten
Wenn Sie keinen Bot schreiben möchten, können zwei Agenten auf Discord und Telegram antworten und FreeLLMAPI als Modell verwenden. FreeLLMAPI hat für jeden einen Setup-Befehl. Jeder Befehl unterstützt --dry-run und erstellt vorher eine Sicherung der Konfiguration.
| Agent | Setup-Befehl | Was er schreibt |
|---|---|---|
| OpenClaw | npx freellmapi setup-openclaw --url http://localhost:3001 --api-key <unified-key> | Ein Anbieter freellmapi in ~/.openclaw/openclaw.json, Standardmodell freellmapi/auto |
| Hermes Agent | npx freellmapi setup-hermes --url http://localhost:3001 --api-key <unified-key> | Ein eigener Modellblock in ~/.hermes/config.yaml |
Ein laufendes OpenClaw- oder Hermes-Gateway braucht nach dem Setup-Befehl einen Neustart.
Betreiben Sie den Bot und FreeLLMAPI auf demselben Computer oder Server. Der Bot erreicht das Gateway dann über localhost, und der Gateway-Port bleibt für das Internet geschlossen. Ein kleiner Server oder ein Raspberry Pi reicht für beides.
Fehlerbehebung
| Problem | Ursache | Lösung |
|---|---|---|
| Der Discord-Bot liest leere Nachrichten | Der Intent Message Content ist ausgeschaltet | Aktivieren Sie ihn im Portal und in intents.message_content |
| Der Bot antwortet auf seine eigenen Nachrichten | Es gibt keine Prüfung auf Bot-Autoren | Beenden Sie die Verarbeitung, wenn message.author.bot wahr ist |
| Discord-Fehler 50035 bei langen Antworten | Die Nachricht ist länger als 2000 Zeichen | Teilen Sie die Antwort auf, wie im Code oben |
| „All free models are busy“ am Abend | Alle Schlüssel in der Kette haben ihr Tageslimit erreicht | Fügen Sie Schlüssel von weiteren Anbietern hinzu. Viele Tageslimits werden um Mitternacht UTC zurückgesetzt. |
| Langsame Antworten | Ein langsames Modell oder ein langer Verlauf | Verwenden Sie auto:fast und behalten Sie 10 Nachrichten oder weniger |
Connection refused vom Bot | Der Bot läuft in Docker und verwendet localhost | Verwenden Sie host.docker.internal oder ein gemeinsames Docker-Netzwerk |
Häufig gestellte Fragen
Gibt es eine kostenlose KI-API für einen Discord-Bot?
Ja. Mehrere Anbieter haben kostenlose Stufen, die mit dem Python-Paket openai funktionieren. FreeLLMAPI kombiniert sie hinter einem Schlüssel, daher kann ein belebter Bot die Limits vieler Anbieter nutzen.
Kann ich einen kostenlosen KI-Telegram-Bot bauen?
Ja. Verwenden Sie python-telegram-bot für den Bot und eine OpenAI-kompatible kostenlose API für die Antworten. Der Code auf dieser Seite ist vollständig.
Wie verhindere ich, dass mein KI-Bot Rate-Limits erreicht?
Antworten Sie nur auf Erwähnungen oder Befehle, begrenzen Sie jeden Benutzer auf eine Anfrage alle paar Sekunden, halten Sie den Verlauf kurz und fügen Sie Schlüssel von weiteren Anbietern hinzu.
Warum erhält mein Discord-Bot leeren Nachrichteninhalt?
Der Intent Message Content ist ausgeschaltet. Aktivieren Sie ihn im Developer Portal auf dem Reiter Bot und setzen Sie im Code intents.message_content = True.
Was passiert, wenn alle kostenlosen Modelle ihr Limit erreicht haben?
FreeLLMAPI gibt den Fehler 429 mit einem Header Retry-After zurück. Der Bot-Code fängt ihn ab und bittet den Benutzer, es später erneut zu versuchen.
Verwandte Anleitungen
- Kostenlose LLM-API in Python
- Rate-Limits kostenloser LLM-APIs
- Kostenlose OpenAI-kompatible API-Base-URLs
- Kostenlose LLM-API für KI-Agenten
- Kostenlose LLM-API ohne Kreditkarte
Quellen
- discord.py docs: quickstart (geprüft 20 November 2026)
- discord.py docs: privileged intents (geprüft 20 November 2026)
- Discord developer docs: message resource (2000 character content limit) (geprüft 20 November 2026)
- python-telegram-bot v22 docs: echobot example (geprüft 20 November 2026)
- Telegram Bot API: sendMessage and sendChatAction (geprüft 20 November 2026)
- FreeLLMAPI docs: clients (OpenClaw, Hermes Agent, context handoff) (geprüft 20 November 2026)