Laman utama / Panduan / API AI percuma untuk bot Discord atau Telegram

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:fast menyusun model mengikut kelajuan. Pengguna sembang menunggu lebih singkat.
  • Gagal dengan sopan. Apabila setiap kunci telah mencapai had, beritahu pengguna supaya mencuba lagi kemudian.
Privasi: bot menghantar mesej pengguna kepada pembekal yang menjawab. Sesetengah peringkat percuma boleh menggunakan prompt untuk menambah baik model mereka. Beritahu pengguna anda bahawa perkhidmatan AI membaca mesej mereka. Baca API LLM percuma yang melatih data anda dan buang pembekal daripada rantai anda yang tidak anda terima.

Model percuma ini mempunyai kelajuan yang diukur paling pantas hari ini. Ramai daripadanya mempunyai had permintaan yang tinggi:

Model sembang percuma yang pantas
ModelPercuma padaKonteksHad percuma (tawaran terbaik)AlatPenglihatan
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo +3 lagi262K30 permintaan/minit
250 permintaan/hari
70,000 token/minit
~6M
YaYa
GPT-OSS 20BApi.Airforce, Cloudflare Workers AI, Groq +4 lagi131K30 permintaan/minit
1,000 permintaan/hari
8,000 token/minit
200,000 token/hari
~6M
YaTidak
Nemotron 3.5 LightningElectronHub, Gizmo, Kilo Gateway +2 lagi1M20 permintaan/minit
50 permintaan/hari
50 req/day account-wide (1,000 after a $10 purchase)
YaTidak
GPT-OSS 120BCloudflare Workers AI, ElectronHub, Groq +1 lagi131K30 permintaan/minit
1,000 permintaan/hari
8,000 token/minit
200,000 token/hari
~6M
YaTidak
GPT-OSS 20B (via Groq)DreamPrompting131K100 permintaan/minit
5,000 permintaan/hari
500,000 token/hari
500K tokens/day · 5,000 req/day
TidakTidak
GPT-OSS Safeguard 20BGroq131K30 permintaan/minit
1,000 permintaan/hari
8,000 token/minit
200,000 token/hari
~6M
YaTidak
Groq Compound MiniDreamPrompting131K100 permintaan/minit
5,000 permintaan/hari
500,000 token/hari
500K tokens/day · 5,000 req/day
TidakTidak
Gemini 3.5 Flash LiteElectronHub, Google AI Studio1M15 permintaan/minit
20 permintaan/hari
250,000 token/minit
~3M
YaYa
Step 3.7 FlashElectronHub256K$0.25/week shared recurring creditYaYa
Gemini 3.1 Flash-LiteDreamPrompting, Google AI Studio1M100 permintaan/minit
5,000 permintaan/hari
500,000 token/hari
500K tokens/day · 5,000 req/day
YaYa

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

  1. Buka Discord Developer Portal dan cipta aplikasi. Tambah bot dan salin tokennya.
  2. Pada tab bot, pergi ke Privileged Gateway Intents. Hidupkan Message Content.
  3. Jemput bot ke pelayan anda dengan skop bot dan kebenaran Send Messages.
  4. Tetapkan token dalam pembolehubah persekitaran DISCORD_TOKEN dan 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

  1. Dalam Telegram, buka @BotFather dan hantar /newbot. Salin tokennya.
  2. Tetapkan token dalam pembolehubah persekitaran TELEGRAM_TOKEN.
  3. 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.

EjenArahan persediaanApa yang ditulisnya
OpenClawnpx freellmapi setup-openclaw --url http://localhost:3001 --api-key <unified-key>Pembekal freellmapi dalam ~/.openclaw/openclaw.json, model lalai freellmapi/auto
Hermes Agentnpx 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

MasalahPuncaPenyelesaian
Bot Discord membaca mesej kosongIntent Message Content dimatikanHidupkannya dalam portal dan dalam intents.message_content
Bot menjawab mesejnya sendiriTiada semakan untuk pengarang botKembali apabila message.author.bot bernilai benar
Ralat Discord 50035 pada jawapan panjangMesej lebih panjang daripada 2000 aksaraPecahkan jawapan, seperti dalam kod di atas
"Semua model percuma sibuk" pada waktu malamSemua kunci dalam rantai telah mencapai had harianTambah kunci daripada lebih banyak pembekal. Banyak had harian ditetapkan semula pada tengah malam UTC.
Jawapan perlahanModel yang perlahan atau sejarah yang panjangGuna auto:fast dan kekalkan 10 mesej atau kurang
Connection refused daripada botBot berjalan dalam Docker dan guna localhostGuna host.docker.internal atau rangkaian Docker yang dikongsi
Guna setiap satu daripada ini melalui satu kunci. FreeLLMAPI ialah penghala sumber terbuka yang anda hoskan sendiri. Ia meletakkan semua peringkat percuma ini di belakang satu titik akhir serasi OpenAI dan beralih ke pembekal lain apabila had kadar dicapai. Layari katalog atau mula sekarang.

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

Sumber

Semua panduan · Lihat semua model percuma