Ana sayfa / Rehberler / Discord veya Telegram botu için ücretsiz AI API

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.
Gizlilik: bot, kullanıcı mesajlarını yanıt veren sağlayıcıya gönderir. Bazı ücretsiz katmanlar istemleri modellerini geliştirmek için kullanabilir. Kullanıcılarınıza bir AI hizmetinin mesajlarını okuduğunu söyleyin. hangi ücretsiz LLM API'leri verilerinizle eğitim yapar sayfasını okuyun ve kabul etmediğiniz sağlayıcıları zincirinizden çıkarın.

Bu ücretsiz modeller bugün ölçülen en hızlı hıza sahiptir. Birçoğu yüksek istek limitine sahiptir:

Hızlı ücretsiz sohbet modelleri
ModelÜcretsiz olduğu yerBağlamÜcretsiz limitler (en iyi teklif)AraçlarGörsel girdi
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo +3 tane daha262K30 istek/dk
250 istek/gün
70,000 jeton/dk
~6M
EvetEvet
GPT-OSS 20BApi.Airforce, Cloudflare Workers AI, Groq +4 tane daha131K30 istek/dk
1,000 istek/gün
8,000 jeton/dk
200,000 jeton/gün
~6M
EvetHayır
Nemotron 3.5 LightningElectronHub, Gizmo, Kilo Gateway +2 tane daha1M20 istek/dk
50 istek/gün
50 req/day account-wide (1,000 after a $10 purchase)
EvetHayır
GPT-OSS 120BCloudflare Workers AI, ElectronHub, Groq +1 tane daha131K30 istek/dk
1,000 istek/gün
8,000 jeton/dk
200,000 jeton/gün
~6M
EvetHayır
GPT-OSS 20B (via Groq)DreamPrompting131K100 istek/dk
5,000 istek/gün
500,000 jeton/gün
500K tokens/day · 5,000 req/day
HayırHayır
GPT-OSS Safeguard 20BGroq131K30 istek/dk
1,000 istek/gün
8,000 jeton/dk
200,000 jeton/gün
~6M
EvetHayır
Groq Compound MiniDreamPrompting131K100 istek/dk
5,000 istek/gün
500,000 jeton/gün
500K tokens/day · 5,000 req/day
HayırHayır
Gemini 3.5 Flash LiteElectronHub, Google AI Studio1M15 istek/dk
20 istek/gün
250,000 jeton/dk
~3M
EvetEvet
Step 3.7 FlashElectronHub256K$0.25/week shared recurring creditEvetEvet
Gemini 3.1 Flash-LiteDreamPrompting, Google AI Studio1M100 istek/dk
5,000 istek/gün
500,000 jeton/gün
500K tokens/day · 5,000 req/day
EvetEvet

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

  1. Discord Developer Portal'ı açın ve bir uygulama oluşturun. Bir bot ekleyin ve token'ını kopyalayın.
  2. Bot sekmesinde Privileged Gateway Intents bölümüne gidin. Message Content seçeneğini açın.
  3. Botu, bot kapsamı ve Send Messages izniyle sunucunuza davet edin.
  4. Token'ı DISCORD_TOKEN ortam 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

  1. Telegram'da @BotFather hesabını açın ve /newbot gönderin. Token'ı kopyalayın.
  2. Token'ı TELEGRAM_TOKEN ortam değişkenine koyun.
  3. 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.

AjanKurulum komutuYazdığı
OpenClawnpx 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 Agentnpx 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

SorunNedenÇözüm
Discord botu boş mesajları okuyorMessage Content intent'i kapalıPortalda ve intents.message_content içinde açın
Bot kendi mesajlarına yanıt veriyorBot yazarları için bir kontrol yokmessage.author.bot doğruysa geri dönün
Uzun yanıtlarda Discord hatası 50035Mesaj 2000 karakterden uzunYanıtı bölün, yukarıdaki koddaki gibi
Akşamleyin "Tüm ücretsiz modeller meşgul"Zincirdeki tüm anahtarlar günlük limitindeDaha 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ıtlarYavaş bir model veya uzun bir geçmişauto:fast kullanın ve 10 mesaj veya daha az tutun
Bottan Connection refusedBot Docker içinde çalışıyor ve localhost kullanıyorhost.docker.internal veya ortak bir Docker ağı kullanın
Bunların hepsini tek bir anahtarla kullanın. FreeLLMAPI, açık kaynaklı ve kendi sunucunuzda çalışan bir yönlendiricidir. Tüm bu ücretsiz katmanları tek bir OpenAI uyumlu uç noktanın arkasında toplar ve bir sağlayıcı hız limitine takıldığında otomatik olarak başka birine geçer. Kataloğa göz atın veya canlı olarak incele.

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

Kaynaklar

Tüm rehberler · Tüm ücretsiz modelleri incele