Discord 또는 Telegram 봇용 무료 AI API
채팅 봇은 메시지마다 모델 요청을 하나씩 보냅니다. 활발한 서버에서는 무료 티어 하나가 몇 분 만에 한도에 도달합니다. 이 가이드는 Discord 봇과 Telegram 봇을 FreeLLMAPI에 연결합니다. FreeLLMAPI는 45개의 무료 제공업체 티어를 OpenAI 호환 키 하나 뒤에 묶고, 한도 때문에 요청이 중단되면 다음 제공업체로 넘어갑니다. 코드는 Python이며 완전합니다.
코드, 모델 이름, 실시간 카탈로그 레이블은 영어로 표시합니다.
먼저 한도를 계획하세요
무료 티어는 분당 및 일일 요청 수를 제한합니다. 활성 사용자 200명이 있는 서버의 봇은 하루에 요청을 수천 건 보낼 수 있습니다. 대체는 이 요청을 모든 키에 나누지만, 전체 합계는 여전히 무료 한도의 합입니다.
- 요청받았을 때만 답하세요. Discord에서는 멘션에만 답하세요. Telegram 그룹에서는 명령이나 답장에만 답하세요.
- 사용자마다 제한하세요. 사용자당 몇 초에 한 번의 요청만 허용하세요.
- 기록을 짧게 유지하세요. 채널 전체 기록이 아니라 마지막 메시지 10개만 보내세요.
- 빠른 경로를 사용하세요.
auto:fast는 모델을 속도 순으로 순위를 매깁니다. 채팅 사용자는 덜 기다립니다. - 실패를 친절하게 처리하세요. 모든 키가 한도에 도달하면 사용자에게 나중에 다시 시도하라고 알리세요.
다음 무료 모델은 오늘 측정된 속도가 가장 빠릅니다. 이 중 다수는 요청 한도가 높습니다:
| 모델 | 무료 제공 | 컨텍스트 | 무료 한도 (가장 좋은 조건) | 도구 | 비전 |
|---|---|---|---|---|---|
| Qwen3.8 27B | BlazeAPI, ElectronHub, Gizmo +3개 더 | 262K | 30 요청/분 250 요청/일 70,000 토큰/분 ~6M | 예 | 예 |
| GPT-OSS 20B | Api.Airforce, Cloudflare Workers AI, Groq +4개 더 | 131K | 30 요청/분 1,000 요청/일 8,000 토큰/분 200,000 토큰/일 ~6M | 예 | 아니요 |
| Nemotron 3.5 Lightning | ElectronHub, Gizmo, Kilo Gateway +2개 더 | 1M | 20 요청/분 50 요청/일 50 req/day account-wide (1,000 after a $10 purchase) | 예 | 아니요 |
| GPT-OSS 120B | Cloudflare Workers AI, ElectronHub, Groq +1개 더 | 131K | 30 요청/분 1,000 요청/일 8,000 토큰/분 200,000 토큰/일 ~6M | 예 | 아니요 |
| GPT-OSS 20B (via Groq) | DreamPrompting | 131K | 100 요청/분 5,000 요청/일 500,000 토큰/일 500K tokens/day · 5,000 req/day | 아니요 | 아니요 |
| GPT-OSS Safeguard 20B | Groq | 131K | 30 요청/분 1,000 요청/일 8,000 토큰/분 200,000 토큰/일 ~6M | 예 | 아니요 |
| Groq Compound Mini | DreamPrompting | 131K | 100 요청/분 5,000 요청/일 500,000 토큰/일 500K tokens/day · 5,000 req/day | 아니요 | 아니요 |
| Gemini 3.5 Flash Lite | ElectronHub, Google AI Studio | 1M | 15 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Step 3.7 Flash | ElectronHub | 256K | $0.25/week shared recurring credit | 예 | 예 |
| Gemini 3.1 Flash-Lite | DreamPrompting, Google AI Studio | 1M | 100 요청/분 5,000 요청/일 500,000 토큰/일 500K tokens/day · 5,000 req/day | 예 | 예 |
일치하는 무료 모델 215개 중 10개를 표시합니다. 모든 모델 보기.
FreeLLMAPI 카탈로그의 실시간 데이터입니다 (버전 2026.11.19, 2026-11-19 확인). 무료 한도는 자주 바뀝니다. 카탈로그는 매일 확인합니다.
공통 코드: 모델 호출
두 봇은 같은 모듈을 사용합니다. 이 모듈은 채팅마다 짧은 기록을 유지하고, 채팅마다 세션 ID 하나를 보내며, 한도를 처리합니다. 먼저 FreeLLMAPI를 설치하고 대시보드의 Keys 페이지에서 통합 키를 복사하세요.
설치
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 헤더는 한 채팅을 30분 동안 한 모델에 유지합니다. 그러면 봇은 대화 안에서 같은 스타일을 유지합니다. 그 모델이 한도에 도달하면 라우터는 다른 모델로 넘어가고, 그 모델도 같은 기록을 받습니다.
기록과 쿨다운은 메모리에 보관됩니다. 봇을 재시작하면 사라집니다. 긴 대화를 기억해야 하는 봇은 SQLite나 Redis 같은 데이터베이스에 기록을 저장하세요.
discord.py로 만든 Discord 봇
- Discord 개발자 포털을 열고 애플리케이션을 만드세요. 봇을 추가하고 토큰을 복사하세요.
- Bot 탭에서 Privileged Gateway Intents로 이동하세요. Message Content를 켜세요.
bot범위와 Send Messages 권한으로 서버에 봇을 초대하세요.DISCORD_TOKEN환경 변수에 토큰을 설정하고 스크립트를 실행하세요.
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으로 만든 Telegram 봇
- 텔레그램에서 @BotFather를 열고
/newbot을 보내세요. 토큰을 복사하세요. TELEGRAM_TOKEN환경 변수에 토큰을 설정하세요.- 스크립트를 실행하세요. 봇에게 메시지를 보내세요.
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의 입력 중 상태는 5초 이하로 유지됩니다. 느린 모델의 경우, 긴 요청 중에 채팅 동작을 다시 보내세요. 이 코드는 완전히 비동기인 python-telegram-bot 버전 22를 사용합니다.
바로 사용할 수 있는 봇 에이전트
봇을 직접 쓰고 싶지 않다면, 두 에이전트가 Discord와 Telegram에서 답할 수 있고 FreeLLMAPI를 모델로 사용할 수 있습니다. FreeLLMAPI는 각 에이전트마다 설정 명령을 제공합니다. 각 명령은 --dry-run을 지원하며, 먼저 설정의 백업을 만듭니다.
| 에이전트 | 설정 명령 | 작성하는 내용 |
|---|---|---|
| OpenClaw | npx freellmapi setup-openclaw --url http://localhost:3001 --api-key <unified-key> | freellmapi 제공업체를 ~/.openclaw/openclaw.json에 추가하고, 기본 모델은 freellmapi/auto로 설정 |
| Hermes Agent | npx freellmapi setup-hermes --url http://localhost:3001 --api-key <unified-key> | ~/.hermes/config.yaml의 사용자 지정 모델 블록 |
OpenClaw 또는 Hermes 게이트웨이가 실행 중이면 설정 명령 후에 재시작해야 합니다.
봇과 FreeLLMAPI를 같은 컴퓨터나 서버에서 실행하세요. 그러면 봇은 localhost로 게이트웨이에 접근하고, 게이트웨이 포트는 인터넷에 닫힌 상태로 유지됩니다. 작은 서버나 Raspberry Pi면 둘 다 실행하기에 충분합니다.
문제 해결
| 문제 | 원인 | 해결 방법 |
|---|---|---|
| Discord 봇이 빈 메시지를 읽음 | Message Content 인텐트가 꺼져 있음 | 포털과 intents.message_content에서 켜세요 |
| 봇이 자신의 메시지에 답함 | 봇 작성자를 확인하지 않음 | message.author.bot이 참이면 반환하세요 |
| 긴 답변에서 Discord 오류 50035 | 메시지가 2000자를 넘음 | 위 코드처럼 답변을 나누세요 |
| 저녁에 "모든 무료 모델이 사용 중" 메시지 표시 | 체인의 모든 키가 일일 한도에 도달함 | 더 많은 제공업체의 키를 추가하세요. 많은 일일 한도는 UTC 자정에 재설정됩니다. |
| 느린 답변 | 느린 모델이거나 기록이 김 | auto:fast를 사용하고 메시지를 10개 이하로 유지하세요 |
봇에서 Connection refused | 봇이 Docker에서 실행되고 localhost를 사용함 | host.docker.internal 또는 공유 Docker 네트워크를 사용하세요 |
자주 묻는 질문
Discord 봇용 무료 AI API가 있나요?
네. 여러 제공업체가 openai Python 패키지와 함께 작동하는 무료 티어를 제공합니다. FreeLLMAPI는 이들을 키 하나 뒤에 묶으므로, 활발한 봇은 여러 제공업체의 한도를 쓸 수 있습니다.
무료 AI Telegram 봇을 만들 수 있나요?
네. 봇에는 python-telegram-bot을, 답변에는 OpenAI 호환 무료 API를 사용하세요. 이 페이지의 코드는 완전합니다.
AI 봇이 요청 한도에 걸리지 않게 하려면 어떻게 하나요?
멘션이나 명령에만 답하고, 사용자마다 몇 초에 한 번의 요청만 허용하고, 기록을 짧게 유지하고, 더 많은 제공업체의 키를 추가하세요.
Discord 봇이 빈 메시지 내용을 받는 이유는 무엇인가요?
Message Content 인텐트가 꺼져 있습니다. 개발자 포털의 Bot 탭에서 켜고, 코드에서 intents.message_content = True로 설정하세요.
모든 무료 모델이 한도에 도달하면 어떻게 되나요?
FreeLLMAPI는 Retry-After 헤더와 함께 오류 429를 반환합니다. 봇 코드는 이를 잡아 사용자에게 나중에 다시 시도하라고 알립니다.
관련 가이드
- Python에서 무료 LLM API
- 무료 LLM API 속도 제한
- 무료 OpenAI 호환 API Base URL
- AI 에이전트용 무료 LLM API
- 카드 없이 쓸 수 있는 무료 LLM API
출처
- discord.py docs: quickstart (20 November 2026 확인)
- discord.py docs: privileged intents (20 November 2026 확인)
- Discord developer docs: message resource (2000 character content limit) (20 November 2026 확인)
- python-telegram-bot v22 docs: echobot example (20 November 2026 확인)
- Telegram Bot API: sendMessage and sendChatAction (20 November 2026 확인)
- FreeLLMAPI docs: clients (OpenClaw, Hermes Agent, context handoff) (20 November 2026 확인)