AI API ya bure kwa bot ya Discord au Telegram
Bot ya gumzo hutuma ombi moja la modeli kwa kila ujumbe. Kwenye seva yenye shughuli nyingi, tabaka moja la bure hufikia kikomo chake ndani ya dakika chache. Mwongozo huu unaunganisha bot ya Discord na bot ya Telegram kwenye FreeLLMAPI. FreeLLMAPI inakusanya tabaka 45 za bure za watoa huduma nyuma ya ufunguo mmoja unaoendana na OpenAI, na huhamia kwa mtoa huduma anayefuata kizuizi kinaposimamisha ombi. Msimbo ni wa Python na ni kamili.
Msimbo, majina ya modeli na lebo za katalogi ya moja kwa moja zinaonyeshwa kwa Kiingereza.
Panga kwa vikomo kwanza
Tabaka za bure zina vikomo vya maombi kwa dakika na kwa siku. Bot kwenye seva yenye watumiaji 200 hai inaweza kutuma maelfu ya maombi kwa siku. Failover husambaza maombi haya kwenye funguo zako zote, lakini jumla bado ni sawa na jumla ya vikomo vya bure.
- Jibu pale tu unapoulizwa. Kwenye Discord, jibu mentions pekee. Kwenye vikundi vya Telegram, jibu amri au replies pekee.
- Weka kikomo kwa kila mtumiaji. Ruhusu ombi moja kwa kila mtumiaji kila sekunde chache.
- Weka historia fupi. Tuma ujumbe 10 wa mwisho, si historia kamili ya channel.
- Tumia njia ya haraka.
auto:fasthupanga modeli kwa kasi. Watumiaji wa gumzo husubiri kidogo. - Shindwa kwa adabu. Funguo zote zikifika kikomo, mwambie mtumiaji ajaribu tena baadaye.
Modeli hizi za bure zina kasi ya juu zaidi iliyopimwa leo. Nyingi kati yake zina vikomo vya juu vya maombi:
| Modeli | Bure kwenye | Muktadha | Vikomo vya bure (ofa bora) | Zana | Uoni |
|---|---|---|---|---|---|
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3 zaidi | 262K | 30 maombi/dakika 250 maombi/siku 70,000 tokeni/dakika ~6M | Ndiyo | Ndiyo |
| GPT-OSS 20B | Api.Airforce, Cloudflare Workers AI, Groq +4 zaidi | 131K | 30 maombi/dakika 1,000 maombi/siku 8,000 tokeni/dakika 200,000 tokeni/siku ~6M | Ndiyo | Hapana |
| Nemotron 3.5 Lightning | ElectronHub, Gizmo, Kilo Gateway +2 zaidi | 1M | 20 maombi/dakika 50 maombi/siku 50 req/day account-wide (1,000 after a $10 purchase) | Ndiyo | Hapana |
| GPT-OSS 120B | Cloudflare Workers AI, ElectronHub, Groq +1 zaidi | 131K | 30 maombi/dakika 1,000 maombi/siku 8,000 tokeni/dakika 200,000 tokeni/siku ~6M | Ndiyo | Hapana |
| GPT-OSS 20B (via Groq) | DreamPrompting | 131K | 100 maombi/dakika 5,000 maombi/siku 500,000 tokeni/siku 500K tokens/day · 5,000 req/day | Hapana | Hapana |
| GPT-OSS Safeguard 20B | Groq | 131K | 30 maombi/dakika 1,000 maombi/siku 8,000 tokeni/dakika 200,000 tokeni/siku ~6M | Ndiyo | Hapana |
| Groq Compound Mini | DreamPrompting | 131K | 100 maombi/dakika 5,000 maombi/siku 500,000 tokeni/siku 500K tokens/day · 5,000 req/day | Hapana | Hapana |
| Gemini 3.5 Flash Lite | ElectronHub, Google AI Studio | 1M | 15 maombi/dakika 20 maombi/siku 250,000 tokeni/dakika ~3M | Ndiyo | Ndiyo |
| Step 3.7 Flash | ElectronHub | 256K | $0.25/week shared recurring credit | Ndiyo | Ndiyo |
| Gemini 3.1 Flash-Lite | DreamPrompting, Google AI Studio | 1M | 100 maombi/dakika 5,000 maombi/siku 500,000 tokeni/siku 500K tokens/day · 5,000 req/day | Ndiyo | Ndiyo |
Inaonyesha 10 kati ya 215 modeli za bure zinazolingana. Tazama modeli zote.
Data ya moja kwa moja kutoka katalogi ya FreeLLMAPI (toleo 2026.11.19, imekaguliwa 2026-11-19). Vikomo vya bure hubadilika mara kwa mara. Katalogi hukaguliwa kila siku.
Msimbo wa pamoja: mwito wa modeli
Bot zote mbili hutumia moduli ile ile. Moduli hii huweka historia fupi kwa kila gumzo, hutuma kitambulisho kimoja cha kikao kwa kila gumzo na kushughulikia vikomo vya kasi. Sakinisha FreeLLMAPI kwanza kisha nakili ufunguo wa umoja kutoka ukurasa wa Keys wa dashibodi.
Sakinisha
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 [""]Kichwa cha X-Session-Id huweka gumzo moja kwenye modeli moja kwa dakika 30. Bot kisha hudumisha mtindo uleule katika mazungumzo. Modeli hiyo ikifika kwenye kikomo chake, kipanga njia huhamia modeli nyingine, ambayo hupokea historia ile ile.
Historia na muda wa kupumzika huhifadhiwa kwenye kumbukumbu ya programu. Hupotea bot inapoanzishwa upya. Kwa bot inayopaswa kukumbuka mazungumzo marefu, hifadhi historia kwenye hifadhidata kama SQLite au Redis.
Bot ya Discord kwa discord.py
- Fungua Discord Developer Portal kisha utengeneze application. Ongeza bot na unakili token yake.
- Kwenye kichupo cha bot, nenda kwenye Privileged Gateway Intents. Washa Message Content.
- Mwalike bot kwenye seva yako kwa wigo wa
botna ruhusa ya Send Messages. - Weka token kwenye kigeu cha mazingira cha
DISCORD_TOKENkisha endesha hati.
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 ya Telegram kwa python-telegram-bot
- Kwenye Telegram, fungua @BotFather kisha utume
/newbot. Nakili token. - Weka token kwenye kigeu cha mazingira cha
TELEGRAM_TOKEN. - Endesha hati. Tuma ujumbe kwa bot yako.
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()Hali ya kuandika kwenye Telegram hudumu sekunde 5 au chini. Kwa modeli polepole, tuma tena kitendo cha gumzo wakati wa maombi marefu. Msimbo unatumia python-telegram-bot toleo la 22, ambalo ni async kikamilifu.
Mawakala wa bot walio tayari
Ukipendelea kutoandika bot, mawakala wawili wanaweza kujibu kwenye Discord na Telegram na kutumia FreeLLMAPI kama modeli yao. FreeLLMAPI ina amri ya usanidi kwa kila mmoja. Kila amri inaunga mkono --dry-run na hutengeneza nakala ya akiba ya mipangilio kwanza.
| Wakala | Amri ya usanidi | Kinachoandikwa |
|---|---|---|
| OpenClaw | npx freellmapi setup-openclaw --url http://localhost:3001 --api-key <unified-key> | Mtoa huduma freellmapi kwenye ~/.openclaw/openclaw.json, modeli chaguo-msingi freellmapi/auto |
| Hermes Agent | npx freellmapi setup-hermes --url http://localhost:3001 --api-key <unified-key> | Kizuizi cha modeli maalum kwenye ~/.hermes/config.yaml |
Lango la OpenClaw au Hermes linaloendelea kufanya kazi linahitaji kuanzishwa upya baada ya amri ya usanidi.
Endesha bot na FreeLLMAPI kwenye kompyuta au seva ile ile. Kisha bot inafikia lango kwenye localhost, na port ya lango inabaki imefungwa kwa mtandao. Seva ndogo au Raspberry Pi inatosha kwa yote mawili.
Utatuzi wa matatizo
| Tatizo | Sababu | Suluhisho |
|---|---|---|
| Bot ya Discord inasoma ujumbe tupu | Intent ya Message Content imezimwa | Iwashe kwenye portal na kwenye intents.message_content |
| Bot inajibu ujumbe wake yenyewe | Hakuna ukaguzi wa waandishi wa bot | Rudi nyuma wakati message.author.bot ni true |
| Discord error 50035 kwenye majibu marefu | Ujumbe una herufi zaidi ya 2000 | Gawanya jibu, kama kwenye msimbo ulio hapo juu |
| Ujumbe "All free models are busy" jioni | Funguo zote kwenye mnyororo zimefika kwenye kikomo chao cha kila siku | Ongeza funguo kutoka kwa watoa huduma zaidi. Vikomo vingi vya kila siku huwekwa upya saa sita usiku UTC. |
| Majibu polepole | Modeli polepole au historia ndefu | Tumia auto:fast na weka ujumbe 10 au chini |
Connection refused kutoka kwa bot | Bot inaendeshwa kwenye Docker na inatumia localhost | Tumia host.docker.internal au mtandao wa pamoja wa Docker |
Maswali yanayoulizwa mara kwa mara
Je, kuna AI API ya bure kwa bot ya Discord?
Ndiyo. Watoa huduma kadhaa wana tabaka za bure zinazofanya kazi na kifurushi cha Python cha openai. FreeLLMAPI huziunganisha nyuma ya ufunguo mmoja, kwa hiyo bot yenye shughuli nyingi inaweza kutumia vikomo vya watoa huduma wengi.
Je, ninaweza kutengeneza bot ya AI ya Telegram bila malipo?
Ndiyo. Tumia python-telegram-bot kwa bot na API ya bure inayoendana na OpenAI kwa majibu. Msimbo kwenye ukurasa huu ni kamili.
Ninawezaje kuzuia bot yangu ya AI isifikie vikomo vya kasi?
Jibu mentions au amri pekee, weka kikomo cha ombi moja kwa kila mtumiaji kila sekunde chache, weka historia fupi na ongeza funguo kutoka kwa watoa huduma zaidi.
Kwa nini bot yangu ya Discord inapata maudhui ya ujumbe tupu?
Intent ya Message Content imezimwa. Iwashe kwenye Developer Portal kwenye kichupo cha bot, kisha weka intents.message_content = True kwenye msimbo.
Nini hutokea modeli zote za bure zikifika kwenye kikomo chake?
FreeLLMAPI hurudisha hitilafu 429 yenye kichwa cha Retry-After. Msimbo wa bot unaishika na kumwambia mtumiaji ajaribu tena baadaye.
Miongozo inayohusiana
- LLM API ya bure kwa Python
- Mipaka ya kiwango cha API ya LLM bure
- Base URL za free API zinazooana na OpenAI
- API ya LLM bure kwa wakala wa AI
- LLM API ya bure bila kadi ya mkopo
Vyanzo
- discord.py docs: quickstart (imekaguliwa 20 November 2026)
- discord.py docs: privileged intents (imekaguliwa 20 November 2026)
- Discord developer docs: message resource (2000 character content limit) (imekaguliwa 20 November 2026)
- python-telegram-bot v22 docs: echobot example (imekaguliwa 20 November 2026)
- Telegram Bot API: sendMessage and sendChatAction (imekaguliwa 20 November 2026)
- FreeLLMAPI docs: clients (OpenClaw, Hermes Agent, context handoff) (imekaguliwa 20 November 2026)