Discord veya Telegram botu için ücretsiz AI API
Bir sohbet botu, her mesaj için bir model isteği gönderir. Yoğun bir sunucuda, tek bir ücretsiz katman birkaç dakika içinde limitine ulaşır. Bu kılavuz bir Discord botunu ve bir Telegram botunu FreeLLMAPI'ye bağlar. FreeLLMAPI, tek bir OpenAI uyumlu anahtarın arkasında 45 ücretsiz sağlayıcı katmanını birleştirir ve bir limit isteği durdurduğunda bir sonraki sağlayıcıya geçer. Kod Python'dır ve eksiksizdir.
Kod, model adları ve canlı katalog etiketleri İngilizce gösterilir.
Önce limitler için plan yapın
Ücretsiz katmanlar, istekleri dakika ve gün başına sınırlar. 200 aktif kullanıcısı olan bir sunucudaki bot, günde binlerce istek gönderebilir. Yedekleme bu istekleri tüm anahtarlarınıza dağıtır, ama toplam yine ücretsiz limitlerin toplamıdır.
- Yalnızca istendiğinde yanıtlayın. Discord'da yalnızca mention'lara yanıt verin. Telegram gruplarında yalnızca komutlara veya yanıtlara yanıt verin.
- Her kullanıcıyı sınırlayın. Her kullanıcı için birkaç saniyede bir istek izin verin.
- Geçmişi kısa tutun. Kanalın tüm geçmişini değil, son 10 mesajı gönderin.
- Hızlı bir rota kullanın.
auto:fast, modelleri hıza göre sıralar. Sohbet kullanıcıları daha az bekler. - Nazikçe başarısız olun. Tüm anahtarlar limitindeyken kullanıcıya daha sonra tekrar denemesini söyleyin.
Bu ücretsiz modeller bugün ölçülen en hızlı hıza sahiptir. Birçoğu yüksek istek limitine sahiptir:
| Model | Ücretsiz olduğu yer | Bağlam | Ücretsiz limitler (en iyi teklif) | Araçlar | Görsel girdi |
|---|---|---|---|---|---|
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 tane daha | 262K | 30 istek/dk 250 istek/gün 70,000 jeton/dk ~6M | Evet | Evet |
| GPT-OSS 20B | Api.Airforce, Cloudflare Workers AI, Groq +4 tane daha | 131K | 30 istek/dk 1,000 istek/gün 8,000 jeton/dk 200,000 jeton/gün ~6M | Evet | Hayır |
| Nemotron 3.5 Lightning | ElectronHub, Gizmo, Kilo Gateway +2 tane daha | 1M | 20 istek/dk 50 istek/gün 50 req/day account-wide (1,000 after a $10 purchase) | Evet | Hayır |
| GPT-OSS 120B | Cloudflare Workers AI, ElectronHub, Groq +1 tane daha | 131K | 30 istek/dk 1,000 istek/gün 8,000 jeton/dk 200,000 jeton/gün ~6M | Evet | Hayır |
| GPT-OSS 20B (via Groq) | DreamPrompting | 131K | 100 istek/dk 5,000 istek/gün 500,000 jeton/gün 500K tokens/day · 5,000 req/day | Hayır | Hayır |
| GPT-OSS Safeguard 20B | Groq | 131K | 30 istek/dk 1,000 istek/gün 8,000 jeton/dk 200,000 jeton/gün ~6M | Evet | Hayır |
| Groq Compound Mini | DreamPrompting | 131K | 100 istek/dk 5,000 istek/gün 500,000 jeton/gün 500K tokens/day · 5,000 req/day | Hayır | Hayır |
| Gemini 3.5 Flash Lite | ElectronHub, Google AI Studio | 1M | 15 istek/dk 20 istek/gün 250,000 jeton/dk ~3M | Evet | Evet |
| Step 3.7 Flash | ElectronHub | 256K | $0.25/week shared recurring credit | Evet | Evet |
| Gemini 3.1 Flash-Lite | DreamPrompting, Google AI Studio | 1M | 100 istek/dk 5,000 istek/gün 500,000 jeton/gün 500K tokens/day · 5,000 req/day | Evet | Evet |
215 eşleşen ücretsiz modelden 10 tanesi gösteriliyor. Tüm modelleri gör.
Canlı veriler FreeLLMAPI kataloğundan alınır (sürüm 2026.11.19, 2026-11-19 tarihinde kontrol edildi). Ücretsiz limitler sık değişir. Katalog her gün kontrol edilir.
Ortak kod: model çağrısı
İki bot da aynı modülü kullanır. Her sohbet için kısa bir geçmiş tutar, her sohbet için bir oturum kimliği gönderir ve hız limitlerini yönetir. Önce FreeLLMAPI'yi kurun ve panodaki Keys sayfasından birleşik anahtarı kopyalayın.
Kurulum
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 üstbilgisi, bir sohbeti 30 dakika boyunca tek bir modelde tutar. Bot, bir konuşmada aynı üslubu korur. Bu model limitine ulaşırsa yönlendirici, aynı geçmişi alan başka bir modele geçer.
Geçmiş ve bekleme süreleri bellekte tutulur. Bot yeniden başlatıldığında kaybolurlar. Uzun konuşmaları hatırlaması gereken bir bot için geçmişi SQLite veya Redis gibi bir veritabanında saklayın.
discord.py ile Discord botu
- Discord Developer Portal'ı açın ve bir uygulama oluşturun. Bir bot ekleyin ve token'ını kopyalayın.
- Bot sekmesinde Privileged Gateway Intents bölümüne gidin. Message Content seçeneğini açın.
- Botu,
botkapsamı ve Send Messages izniyle sunucunuza davet edin. - Token'ı
DISCORD_TOKENortam değişkenine koyun ve betiği çalıştırın.
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"])python-telegram-bot ile Telegram botu
- Telegram'da @BotFather hesabını açın ve
/newbotgönderin. Token'ı kopyalayın. - Token'ı
TELEGRAM_TOKENortam değişkenine koyun. - Betiği çalıştırın. Botunuza bir mesaj gönderin.
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'daki yazıyor durumu 5 saniye veya daha az kalır. Yavaş modeller için uzun isteklerde sohbet eylemini yeniden gönderin. Kod, tamamen asenkron olan python-telegram-bot 22 sürümünü kullanır.
Hazır bot ajanları
Bot yazmak istemiyorsanız, Discord ve Telegram'da yanıt verebilen ve modeli olarak FreeLLMAPI'yi kullanan iki ajan vardır. FreeLLMAPI, her biri için bir kurulum komutuna sahiptir. Her komut --dry-run destekler ve önce yapılandırmanın bir yedeğini alır.
| Ajan | Kurulum komutu | Yazdığı |
|---|---|---|
| OpenClaw | npx freellmapi setup-openclaw --url http://localhost:3001 --api-key <unified-key> | Bir freellmapi sağlayıcısı, ~/.openclaw/openclaw.json içinde, varsayılan model freellmapi/auto |
| Hermes Agent | npx freellmapi setup-hermes --url http://localhost:3001 --api-key <unified-key> | ~/.hermes/config.yaml içinde özel bir model bloğu |
Çalışan bir OpenClaw veya Hermes ağ geçidi, kurulum komutundan sonra yeniden başlatılmalıdır.
Botu ve FreeLLMAPI'yi aynı bilgisayarda veya sunucuda çalıştırın. Bot, ağ geçidine localhost üzerinden ulaşır ve ağ geçidi bağlantı noktası internete kapalı kalır. İkisi için küçük bir sunucu veya bir Raspberry Pi yeterlidir.
Sorun giderme
| Sorun | Neden | Çözüm |
|---|---|---|
| Discord botu boş mesajları okuyor | Message Content intent'i kapalı | Portalda ve intents.message_content içinde açın |
| Bot kendi mesajlarına yanıt veriyor | Bot yazarları için bir kontrol yok | message.author.bot doğruysa geri dönün |
| Uzun yanıtlarda Discord hatası 50035 | Mesaj 2000 karakterden uzun | Yanıtı bölün, yukarıdaki koddaki gibi |
| Akşamleyin "Tüm ücretsiz modeller meşgul" | Zincirdeki tüm anahtarlar günlük limitinde | Daha fazla sağlayıcıdan anahtar ekleyin. Birçok günlük limit UTC'ye göre gece yarısı sıfırlanır. |
| Yavaş yanıtlar | Yavaş bir model veya uzun bir geçmiş | auto:fast kullanın ve 10 mesaj veya daha az tutun |
Bottan Connection refused | Bot Docker içinde çalışıyor ve localhost kullanıyor | host.docker.internal veya ortak bir Docker ağı kullanın |
Sık sorulan sorular
Discord botu için ücretsiz bir AI API'si var mı?
Evet. Birkaç sağlayıcının, openai Python paketiyle çalışan ücretsiz katmanları vardır. FreeLLMAPI bunları tek bir anahtar arkasında birleştirir, bu yüzden yoğun bir bot birçok sağlayıcının limitlerini kullanabilir.
Ücretsiz bir AI Telegram botu yapabilir miyim?
Evet. Bot için python-telegram-bot, yanıtlar için OpenAI uyumlu ücretsiz bir API kullanın. Bu sayfadaki kod eksiksizdir.
AI botumun hız limitlerine takılmasını nasıl önlerim?
Yalnızca mention'lara veya komutlara yanıt verin, her kullanıcıyı birkaç saniyede bir istekle sınırlayın, geçmişi kısa tutun ve daha fazla sağlayıcıdan anahtar ekleyin.
Discord botum neden boş mesaj içeriği alıyor?
Message Content intent'i kapalıdır. Geliştirici Portalında bot sekmesinden açın ve kodda intents.message_content = True ayarlayın.
Tüm ücretsiz modeller limitindeyken ne olur?
FreeLLMAPI, bir Retry-After üstbilgisiyle birlikte 429 hatası döndürür. Bot kodu bunu yakalar ve kullanıcıya daha sonra tekrar denemesini söyler.
İlgili rehberler
- Python ile ücretsiz LLM API
- Ücretsiz LLM API hız sınırları
- Ücretsiz OpenAI uyumlu API base URL'leri
- AI ajanları için ücretsiz LLM API
- Kredi kartı olmadan ücretsiz LLM API
Kaynaklar
- discord.py docs: quickstart (20 November 2026 tarihinde kontrol edildi)
- discord.py docs: privileged intents (20 November 2026 tarihinde kontrol edildi)
- Discord developer docs: message resource (2000 character content limit) (20 November 2026 tarihinde kontrol edildi)
- python-telegram-bot v22 docs: echobot example (20 November 2026 tarihinde kontrol edildi)
- Telegram Bot API: sendMessage and sendChatAction (20 November 2026 tarihinde kontrol edildi)
- FreeLLMAPI docs: clients (OpenClaw, Hermes Agent, context handoff) (20 November 2026 tarihinde kontrol edildi)