API AI percuma untuk bot Discord atau Telegram
Bot sembang menghantar satu permintaan model bagi setiap mesej. Dalam pelayan yang sibuk, satu peringkat percuma mencapai hadnya dalam beberapa minit. Panduan ini menyambungkan bot Discord dan bot Telegram kepada FreeLLMAPI. FreeLLMAPI menghimpunkan 45 peringkat pembekal percuma di belakang satu kunci yang serasi dengan OpenAI dan beralih kepada pembekal seterusnya apabila had menghentikan permintaan. Kod ialah Python dan lengkap.
Kod, nama model dan label katalog langsung dipaparkan dalam bahasa Inggeris.
Rancang untuk had dahulu
Peringkat percuma mengehadkan permintaan seminit dan sehari. Bot dalam pelayan dengan 200 pengguna aktif boleh menghantar beribu permintaan sehari. Failover menyebarkan permintaan ini merentas semua kunci anda, tetapi jumlahnya tetap jumlah had percuma.
- Jawab hanya apabila diminta. Dalam Discord, jawab sebutan sahaja. Dalam kumpulan Telegram, jawab arahan atau balasan sahaja.
- Hadkan setiap pengguna. Benarkan satu permintaan bagi setiap pengguna setiap beberapa saat.
- Kekalkan sejarah yang pendek. Hantar 10 mesej terakhir, bukan keseluruhan sejarah saluran.
- Guna laluan pantas.
auto:fastmenyusun model mengikut kelajuan. Pengguna sembang menunggu lebih singkat. - Gagal dengan sopan. Apabila setiap kunci telah mencapai had, beritahu pengguna supaya mencuba lagi kemudian.
Model percuma ini mempunyai kelajuan yang diukur paling pantas hari ini. Ramai daripadanya mempunyai had permintaan yang tinggi:
| Model | Percuma pada | Konteks | Had percuma (tawaran terbaik) | Alat | Penglihatan |
|---|---|---|---|---|---|
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 lagi | 262K | 30 permintaan/minit 250 permintaan/hari 70,000 token/minit ~6M | Ya | Ya |
| GPT-OSS 20B | Api.Airforce, Cloudflare Workers AI, Groq +4 lagi | 131K | 30 permintaan/minit 1,000 permintaan/hari 8,000 token/minit 200,000 token/hari ~6M | Ya | Tidak |
| Nemotron 3.5 Lightning | ElectronHub, Gizmo, Kilo Gateway +2 lagi | 1M | 20 permintaan/minit 50 permintaan/hari 50 req/day account-wide (1,000 after a $10 purchase) | Ya | Tidak |
| GPT-OSS 120B | Cloudflare Workers AI, ElectronHub, Groq +1 lagi | 131K | 30 permintaan/minit 1,000 permintaan/hari 8,000 token/minit 200,000 token/hari ~6M | Ya | Tidak |
| GPT-OSS 20B (via Groq) | DreamPrompting | 131K | 100 permintaan/minit 5,000 permintaan/hari 500,000 token/hari 500K tokens/day · 5,000 req/day | Tidak | Tidak |
| GPT-OSS Safeguard 20B | Groq | 131K | 30 permintaan/minit 1,000 permintaan/hari 8,000 token/minit 200,000 token/hari ~6M | Ya | Tidak |
| Groq Compound Mini | DreamPrompting | 131K | 100 permintaan/minit 5,000 permintaan/hari 500,000 token/hari 500K tokens/day · 5,000 req/day | Tidak | Tidak |
| Gemini 3.5 Flash Lite | ElectronHub, Google AI Studio | 1M | 15 permintaan/minit 20 permintaan/hari 250,000 token/minit ~3M | Ya | Ya |
| Step 3.7 Flash | ElectronHub | 256K | $0.25/week shared recurring credit | Ya | Ya |
| Gemini 3.1 Flash-Lite | DreamPrompting, Google AI Studio | 1M | 100 permintaan/minit 5,000 permintaan/hari 500,000 token/hari 500K tokens/day · 5,000 req/day | Ya | Ya |
Memaparkan 10 daripada 215 model percuma yang sepadan. Lihat semua model.
Data langsung daripada katalog FreeLLMAPI (versi 2026.11.19, disemak 2026-11-19). Had percuma kerap berubah. Katalog disemak setiap hari.
Kod kongsi: panggilan model
Kedua-dua bot menggunakan modul yang sama. Ia mengekalkan sejarah pendek bagi setiap sembang, menghantar satu ID sesi bagi setiap sembang dan mengendalikan had kadar. Pasang FreeLLMAPI dahulu dan salin kunci bersatu daripada halaman Keys papan pemuka.
Pasang
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 [""]Pengepala X-Session-Id mengekalkan satu sembang pada satu model selama 30 minit. Bot kemudian mengekalkan gaya yang sama dalam satu perbualan. Jika model itu mencapai had, penghala beralih kepada model lain, yang menerima sejarah yang sama.
Sejarah dan tempoh rehat disimpan dalam memori. Ia hilang apabila bot dimulakan semula. Untuk bot yang mesti mengingati perbualan panjang, simpan sejarah dalam pangkalan data seperti SQLite atau Redis.
Bot Discord dengan discord.py
- Buka Discord Developer Portal dan cipta aplikasi. Tambah bot dan salin tokennya.
- Pada tab bot, pergi ke Privileged Gateway Intents. Hidupkan Message Content.
- Jemput bot ke pelayan anda dengan skop
botdan kebenaran Send Messages. - Tetapkan token dalam pembolehubah persekitaran
DISCORD_TOKENdan jalankan skrip.
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 dengan python-telegram-bot
- Dalam Telegram, buka @BotFather dan hantar
/newbot. Salin tokennya. - Tetapkan token dalam pembolehubah persekitaran
TELEGRAM_TOKEN. - Jalankan skrip. Hantar mesej kepada bot anda.
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 menaip dalam Telegram kekal selama 5 saat atau kurang. Untuk model yang perlahan, hantar tindakan sembang sekali lagi semasa permintaan panjang. Kod ini menggunakan python-telegram-bot versi 22, yang sepenuhnya async.
Ejen bot siap sedia
Jika anda tidak mahu menulis bot, dua ejen boleh menjawab di Discord dan Telegram dan menggunakan FreeLLMAPI sebagai model mereka. FreeLLMAPI mempunyai arahan persediaan untuk setiap satu. Setiap arahan menyokong --dry-run dan membuat sandaran konfigurasi dahulu.
| Ejen | Arahan persediaan | Apa yang ditulisnya |
|---|---|---|
| OpenClaw | npx freellmapi setup-openclaw --url http://localhost:3001 --api-key <unified-key> | Pembekal freellmapi dalam ~/.openclaw/openclaw.json, model lalai freellmapi/auto |
| Hermes Agent | npx freellmapi setup-hermes --url http://localhost:3001 --api-key <unified-key> | Blok model tersuai dalam ~/.hermes/config.yaml |
Gerbang OpenClaw atau Hermes yang sedang berjalan memerlukan mula semula selepas arahan persediaan.
Jalankan bot dan FreeLLMAPI pada komputer atau pelayan yang sama. Bot kemudian mencapai gerbang pada localhost, dan port gerbang kekal tertutup kepada internet. Pelayan kecil atau Raspberry Pi sudah memadai untuk kedua-duanya.
Penyelesaian masalah
| Masalah | Punca | Penyelesaian |
|---|---|---|
| Bot Discord membaca mesej kosong | Intent Message Content dimatikan | Hidupkannya dalam portal dan dalam intents.message_content |
| Bot menjawab mesejnya sendiri | Tiada semakan untuk pengarang bot | Kembali apabila message.author.bot bernilai benar |
| Ralat Discord 50035 pada jawapan panjang | Mesej lebih panjang daripada 2000 aksara | Pecahkan jawapan, seperti dalam kod di atas |
| "Semua model percuma sibuk" pada waktu malam | Semua kunci dalam rantai telah mencapai had harian | Tambah kunci daripada lebih banyak pembekal. Banyak had harian ditetapkan semula pada tengah malam UTC. |
| Jawapan perlahan | Model yang perlahan atau sejarah yang panjang | Guna auto:fast dan kekalkan 10 mesej atau kurang |
Connection refused daripada bot | Bot berjalan dalam Docker dan guna localhost | Guna host.docker.internal atau rangkaian Docker yang dikongsi |
Soalan lazim
Adakah terdapat API AI percuma untuk bot Discord?
Ada. Beberapa pembekal mempunyai peringkat percuma yang berfungsi dengan pakej Python openai. FreeLLMAPI menggabungkannya di belakang satu kunci, jadi bot yang sibuk boleh menggunakan had banyak pembekal.
Bolehkah saya buat bot Telegram AI percuma?
Boleh. Guna python-telegram-bot untuk bot dan API percuma yang serasi dengan OpenAI untuk jawapan. Kod pada halaman ini lengkap.
Bagaimana saya menghentikan bot AI saya daripada mencapai had kadar?
Jawab sebutan atau arahan sahaja, hadkan setiap pengguna kepada satu permintaan setiap beberapa saat, kekalkan sejarah yang pendek dan tambah kunci daripada lebih banyak pembekal.
Mengapa bot Discord saya mendapat kandungan mesej yang kosong?
Intent Message Content dimatikan. Hidupkannya dalam Developer Portal pada tab bot, dan tetapkan intents.message_content = True dalam kod.
Apa yang berlaku apabila semua model percuma telah mencapai had?
FreeLLMAPI memulangkan ralat 429 dengan pengepala Retry-After. Kod bot menangkapnya dan memberitahu pengguna supaya mencuba lagi kemudian.
Panduan berkaitan
- API LLM percuma dalam Python
- Had kadar Free LLM API
- Base URL API percuma yang serasi dengan OpenAI
- Free LLM API untuk ejen AI
- API LLM percuma tanpa kad kredit
Sumber
- discord.py docs: quickstart (disemak 20 November 2026)
- discord.py docs: privileged intents (disemak 20 November 2026)
- Discord developer docs: message resource (2000 character content limit) (disemak 20 November 2026)
- python-telegram-bot v22 docs: echobot example (disemak 20 November 2026)
- Telegram Bot API: sendMessage and sendChatAction (disemak 20 November 2026)
- FreeLLMAPI docs: clients (OpenClaw, Hermes Agent, context handoff) (disemak 20 November 2026)