홈 / 가이드 / Discord 또는 Telegram 봇용 무료 AI API

Discord 또는 Telegram 봇용 무료 AI API

채팅 봇은 메시지마다 모델 요청을 하나씩 보냅니다. 활발한 서버에서는 무료 티어 하나가 몇 분 만에 한도에 도달합니다. 이 가이드는 Discord 봇과 Telegram 봇을 FreeLLMAPI에 연결합니다. FreeLLMAPI는 45개의 무료 제공업체 티어를 OpenAI 호환 키 하나 뒤에 묶고, 한도 때문에 요청이 중단되면 다음 제공업체로 넘어갑니다. 코드는 Python이며 완전합니다.

코드, 모델 이름, 실시간 카탈로그 레이블은 영어로 표시합니다.

먼저 한도를 계획하세요

무료 티어는 분당 및 일일 요청 수를 제한합니다. 활성 사용자 200명이 있는 서버의 봇은 하루에 요청을 수천 건 보낼 수 있습니다. 대체는 이 요청을 모든 키에 나누지만, 전체 합계는 여전히 무료 한도의 합입니다.

  • 요청받았을 때만 답하세요. Discord에서는 멘션에만 답하세요. Telegram 그룹에서는 명령이나 답장에만 답하세요.
  • 사용자마다 제한하세요. 사용자당 몇 초에 한 번의 요청만 허용하세요.
  • 기록을 짧게 유지하세요. 채널 전체 기록이 아니라 마지막 메시지 10개만 보내세요.
  • 빠른 경로를 사용하세요. auto:fast는 모델을 속도 순으로 순위를 매깁니다. 채팅 사용자는 덜 기다립니다.
  • 실패를 친절하게 처리하세요. 모든 키가 한도에 도달하면 사용자에게 나중에 다시 시도하라고 알리세요.
개인정보: 봇은 사용자 메시지를 응답하는 제공업체에 보냅니다. 일부 무료 티어는 프롬프트를 모델 개선에 사용할 수 있습니다. 사용자에게 AI 서비스가 메시지를 읽는다고 알리세요. 어떤 무료 LLM API가 데이터로 학습하는지를 읽고, 허용하지 않는 제공업체는 체인에서 제거하세요.

다음 무료 모델은 오늘 측정된 속도가 가장 빠릅니다. 이 중 다수는 요청 한도가 높습니다:

빠른 무료 채팅 모델
모델무료 제공컨텍스트무료 한도 (가장 좋은 조건)도구비전
Qwen3.8 27BBlazeAPI, ElectronHub, Gizmo +3개 더262K30 요청/분
250 요청/일
70,000 토큰/분
~6M
예예
GPT-OSS 20BApi.Airforce, Cloudflare Workers AI, Groq +4개 더131K30 요청/분
1,000 요청/일
8,000 토큰/분
200,000 토큰/일
~6M
예아니요
Nemotron 3.5 LightningElectronHub, Gizmo, Kilo Gateway +2개 더1M20 요청/분
50 요청/일
50 req/day account-wide (1,000 after a $10 purchase)
예아니요
GPT-OSS 120BCloudflare Workers AI, ElectronHub, Groq +1개 더131K30 요청/분
1,000 요청/일
8,000 토큰/분
200,000 토큰/일
~6M
예아니요
GPT-OSS 20B (via Groq)DreamPrompting131K100 요청/분
5,000 요청/일
500,000 토큰/일
500K tokens/day · 5,000 req/day
아니요아니요
GPT-OSS Safeguard 20BGroq131K30 요청/분
1,000 요청/일
8,000 토큰/분
200,000 토큰/일
~6M
예아니요
Groq Compound MiniDreamPrompting131K100 요청/분
5,000 요청/일
500,000 토큰/일
500K tokens/day · 5,000 req/day
아니요아니요
Gemini 3.5 Flash LiteElectronHub, Google AI Studio1M15 요청/분
20 요청/일
250,000 토큰/분
~3M
예예
Step 3.7 FlashElectronHub256K$0.25/week shared recurring credit예예
Gemini 3.1 Flash-LiteDreamPrompting, Google AI Studio1M100 요청/분
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 봇

  1. Discord 개발자 포털을 열고 애플리케이션을 만드세요. 봇을 추가하고 토큰을 복사하세요.
  2. Bot 탭에서 Privileged Gateway Intents로 이동하세요. Message Content를 켜세요.
  3. bot 범위와 Send Messages 권한으로 서버에 봇을 초대하세요.
  4. 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 봇

  1. 텔레그램에서 @BotFather를 열고 /newbot을 보내세요. 토큰을 복사하세요.
  2. TELEGRAM_TOKEN 환경 변수에 토큰을 설정하세요.
  3. 스크립트를 실행하세요. 봇에게 메시지를 보내세요.

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을 지원하며, 먼저 설정의 백업을 만듭니다.

에이전트설정 명령작성하는 내용
OpenClawnpx freellmapi setup-openclaw --url http://localhost:3001 --api-key <unified-key>freellmapi 제공업체를 ~/.openclaw/openclaw.json에 추가하고, 기본 모델은 freellmapi/auto로 설정
Hermes Agentnpx 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 네트워크를 사용하세요
하나의 키로 이 모델을 모두 사용하십시오. FreeLLMAPI는 오픈 소스이며 직접 호스팅하는 라우터입니다. 이 모든 무료 제공 서비스를 하나의 OpenAI 호환 엔드포인트로 묶고, 요청 한도에 걸리면 다른 모델로 자동 전환합니다. 카탈로그 보기 또는 바로 시작.

자주 묻는 질문

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를 반환합니다. 봇 코드는 이를 잡아 사용자에게 나중에 다시 시도하라고 알립니다.

관련 가이드

출처

전체 가이드 · 무료 모델 전체 보기