API AI gratis untuk bot Discord atau Telegram
Bot chat mengirim satu permintaan model untuk setiap pesan. Di server yang ramai, satu paket gratis mencapai batasnya dalam hitungan menit. Panduan ini menghubungkan bot Discord dan bot Telegram ke FreeLLMAPI. FreeLLMAPI menggabungkan 45 paket gratis dari penyedia di balik satu kunci yang kompatibel dengan OpenAI, dan berpindah ke penyedia berikutnya saat batas menghentikan sebuah permintaan. Kodenya menggunakan Python dan lengkap.
Kode, nama model, dan label katalog langsung ditampilkan dalam bahasa Inggris.
Rencanakan batasnya terlebih dahulu
Paket gratis membatasi permintaan per menit dan per hari. Bot di server dengan 200 pengguna aktif dapat mengirim ribuan permintaan per hari. Failover menyebarkan permintaan ini ke semua kunci Anda, tetapi totalnya tetap sama dengan jumlah batas gratis.
- Jawab hanya saat diminta. Di Discord, jawab hanya mention. Di grup Telegram, jawab hanya perintah atau balasan.
- Batasi setiap pengguna. Izinkan satu permintaan per pengguna setiap beberapa detik.
- Jaga riwayat tetap pendek. Kirim 10 pesan terakhir, bukan seluruh riwayat channel.
- Gunakan rute cepat.
auto:fastmengurutkan model berdasarkan kecepatan. Pengguna chat menunggu lebih sedikit. - Gagal dengan sopan. Saat semua kunci mencapai batasnya, beri tahu pengguna untuk mencoba lagi nanti.
Model gratis berikut memiliki kecepatan terukur tercepat saat ini. Banyak di antaranya memiliki batas permintaan yang tinggi:
| Model | Gratis di | Konteks | Batas gratis (penawaran terbaik) | Alat | Pemrosesan gambar |
|---|---|---|---|---|---|
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 lagi | 262K | 30 permintaan/menit 250 permintaan/hari 70,000 token/menit ~6M | Ya | Ya |
| GPT-OSS 20B | Api.Airforce, Cloudflare Workers AI, Groq +4 lagi | 131K | 30 permintaan/menit 1,000 permintaan/hari 8,000 token/menit 200,000 token/hari ~6M | Ya | Tidak |
| Nemotron 3.5 Lightning | ElectronHub, Gizmo, Kilo Gateway +2 lagi | 1M | 20 permintaan/menit 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/menit 1,000 permintaan/hari 8,000 token/menit 200,000 token/hari ~6M | Ya | Tidak |
| GPT-OSS 20B (via Groq) | DreamPrompting | 131K | 100 permintaan/menit 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/menit 1,000 permintaan/hari 8,000 token/menit 200,000 token/hari ~6M | Ya | Tidak |
| Groq Compound Mini | DreamPrompting | 131K | 100 permintaan/menit 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/menit 20 permintaan/hari 250,000 token/menit ~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/menit 5,000 permintaan/hari 500,000 token/hari 500K tokens/day · 5,000 req/day | Ya | Ya |
Menampilkan 10 dari 215 model gratis yang cocok. Lihat semua model.
Data langsung dari katalog FreeLLMAPI (versi 2026.11.19, diperiksa 2026-11-19). Batas gratis sering berubah. Katalog diperiksa setiap hari.
Kode bersama: panggilan model
Kedua bot memakai modul yang sama. Modul ini menyimpan riwayat pendek untuk setiap chat, mengirim satu ID sesi untuk setiap chat, dan menangani batas permintaan. Pasang FreeLLMAPI terlebih dahulu dan salin kunci terpadu dari halaman Keys di dasbor.
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 [""]Header X-Session-Id menjaga satu chat tetap pada satu model selama 30 menit. Bot kemudian menjaga gaya yang sama dalam sebuah percakapan. Jika model itu mencapai batasnya, router berpindah ke model lain, yang menerima riwayat yang sama.
Riwayat dan cooldown disimpan di memori. Keduanya hilang saat bot dimulai ulang. Untuk bot yang harus mengingat percakapan panjang, simpan riwayat di basis data seperti SQLite atau Redis.
Bot Discord dengan discord.py
- Buka Discord Developer Portal dan buat aplikasi. Tambahkan bot dan salin tokennya.
- Di tab bot, buka Privileged Gateway Intents. Aktifkan Message Content.
- Undang bot ke server Anda dengan scope
botdan izin Send Messages. - Atur token di variabel lingkungan
DISCORD_TOKEN, lalu 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
- Di Telegram, buka @BotFather dan kirim
/newbot. Salin tokennya. - Atur token di variabel lingkungan
TELEGRAM_TOKEN. - Jalankan skrip. Kirim pesan ke 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 mengetik di Telegram bertahan 5 detik atau kurang. Untuk model yang lambat, kirim ulang aksi chat selama permintaan panjang. Kode ini memakai python-telegram-bot versi 22, yang sepenuhnya async.
Agent bot siap pakai
Jika Anda tidak ingin menulis bot, dua agent dapat menjawab di Discord dan Telegram dan memakai FreeLLMAPI sebagai model mereka. FreeLLMAPI memiliki perintah pengaturan untuk masing-masing. Setiap perintah mendukung --dry-run dan membuat cadangan konfigurasi terlebih dahulu.
| Agent | Perintah pengaturan | Yang ditulis |
|---|---|---|
| OpenClaw | npx freellmapi setup-openclaw --url http://localhost:3001 --api-key <unified-key> | Penyedia freellmapi di ~/.openclaw/openclaw.json, model default freellmapi/auto |
| Hermes Agent | npx freellmapi setup-hermes --url http://localhost:3001 --api-key <unified-key> | Blok model kustom di ~/.hermes/config.yaml |
Gateway OpenClaw atau Hermes yang sedang berjalan perlu dimulai ulang setelah perintah pengaturan.
Jalankan bot dan FreeLLMAPI di komputer atau server yang sama. Dengan begitu, bot mencapai gateway di localhost, dan port gateway tetap tertutup dari internet. Server kecil atau Raspberry Pi sudah cukup untuk keduanya.
Pemecahan masalah
| Masalah | Penyebab | Solusi |
|---|---|---|
| Bot Discord membaca pesan kosong | Intent Message Content nonaktif | Aktifkan di portal dan di intents.message_content |
| Bot menjawab pesannya sendiri | Tidak ada pemeriksaan untuk author bot | Keluar dari fungsi saat message.author.bot bernilai true |
| Error Discord 50035 pada jawaban panjang | Pesan lebih panjang dari 2000 karakter | Pisahkan jawaban, seperti pada kode di atas |
| "All free models are busy" di malam hari | Semua kunci dalam rantai mencapai batas hariannya | Tambahkan kunci dari lebih banyak penyedia. Banyak batas harian direset pada tengah malam UTC. |
| Jawaban lambat | Model yang lambat atau riwayat yang panjang | Gunakan auto:fast dan simpan 10 pesan atau kurang |
Connection refused dari bot | Bot berjalan di Docker dan memakai localhost | Gunakan host.docker.internal atau jaringan Docker bersama |
Pertanyaan yang sering diajukan
Apakah ada API AI gratis untuk bot Discord?
Ya. Beberapa penyedia memiliki paket gratis yang berfungsi dengan paket Python openai. FreeLLMAPI menggabungkannya di balik satu kunci, sehingga bot yang ramai dapat memakai batas dari banyak penyedia.
Dapatkah saya membuat bot Telegram AI gratis?
Dapat. Gunakan python-telegram-bot untuk bot dan API gratis yang kompatibel dengan OpenAI untuk jawabannya. Kode di halaman ini lengkap.
Bagaimana cara mencegah bot AI saya mencapai batas permintaan?
Jawab hanya mention atau perintah, batasi setiap pengguna menjadi satu permintaan setiap beberapa detik, jaga riwayat tetap pendek, dan tambahkan kunci dari lebih banyak penyedia.
Mengapa bot Discord saya mendapat isi pesan yang kosong?
Intent Message Content nonaktif. Aktifkan di Developer Portal pada tab bot, dan atur intents.message_content = True di kode.
Apa yang terjadi saat semua model gratis mencapai batasnya?
FreeLLMAPI mengembalikan error 429 dengan header Retry-After. Kode bot menangkapnya dan memberi tahu pengguna untuk mencoba lagi nanti.
Panduan terkait
- API LLM gratis di Python
- Batas rate limit API LLM gratis
- Base URL free API kompatibel OpenAI
- API LLM gratis untuk agen AI
- API LLM gratis tanpa kartu kredit
Sumber
- discord.py docs: quickstart (diperiksa 20 November 2026)
- discord.py docs: privileged intents (diperiksa 20 November 2026)
- Discord developer docs: message resource (2000 character content limit) (diperiksa 20 November 2026)
- python-telegram-bot v22 docs: echobot example (diperiksa 20 November 2026)
- Telegram Bot API: sendMessage and sendChatAction (diperiksa 20 November 2026)
- FreeLLMAPI docs: clients (OpenClaw, Hermes Agent, context handoff) (diperiksa 20 November 2026)