KO ▾
nofilterai.top
NoFilter AI
API 키 받기

무검열 AI 디스코드 봇: 파이썬으로 만들기

AI 여자친구 API는 대규모 언어 모델을 사용하여 로맨틱하거나 동반자 같은 상호작용을 시뮬레이션하는 채팅 애플리케이션을 위한 전용 인터페이스를 제공합니다. 이 가이드는 표준 콘텐츠 거부 없이 역할극 컨텍스트를 처리하는 무검열 모델에 초점을 맞춰 기술적 접근 방식을 비교합니다.

로봇에서 메시지 패널로 이어지는 채팅 풍선들의 등각 일러스트레이션. 디스코드 봇을 나타냅니다.

구축할 것

이러한 봇은 합법적인 성인 요청을 거부하지 않는 언어 모델에서 응답이 나오는 일반 디스코드 봇입니다. 봇은 멘션이나 슬래시 명령어를 감지하고 대화를 chat-completions 엔드포인트로 보내며 답변을 채널에 게시합니다. 디스코드 측에서는 아무것도 변경되지 않습니다. 일반적인 튜토리얼과의 유일한 차이는 텍스트의 출처입니다.

이 API는 OpenAI 호환이므로 특수 클라이언트가 필요하지 않습니다. 베이스 URL과 키만 변경하면 모든 OpenAI SDK가 작동합니다. 모델 ID는 uncensored입니다. 이 모델은 독립적인 제공업체에서 운영하는 단일 오픈 웨이트 모델로, 합법적인 성인 사용자를 위해 콘텐츠 거부 없이 답변하도록 조정되었습니다. 텍스트만 지원하므로 봇은 채팅, 소설 작성, 텍스트 게임 실행, 캐릭터 연기 등을 할 수 있지만 이미지나 오디오는 생성하지 않습니다.

봇을 어떻게 구성하든 변하지 않는 규칙이 하나 있습니다. 미성년자가 관련된 성적 콘텐츠는 허용되지 않습니다. 그 외에도 Discord에는 자체 약관과 커뮤니티 가이드라인이 있으며, 이는 봇과 서버 모두에 적용됩니다. 성인 테마의 봇은 연령 제한 채널에 배치하고, 사용자에게 봇의 용도를 안내하는 것이 좋습니다.

시작하기 전

다음 네 가지가 필요합니다: 디스코드 계정, Python 3.10 이상, API 키, 그리고 봇을 추가할 권한이 있는 서버.

  1. 디스코드 개발자 포털을 열고 애플리케이션을 생성한 다음 봇 사용자를 추가하고 토큰을 복사하세요. 해당 토큰은 비밀번호처럼 취급하세요.
  2. 봇 페이지에서 메시지 콘텐츠 인텐트를 활성화하세요. 활성화하지 않으면 봇이 빈 텍스트가 있는 메시지를 받습니다.
  3. bot 범위와 메시지 읽기 및 보내기 권한으로 봇을 서버에 초대하세요.
  4. API 키 페이지에서 API 키를 생성하세요. 신규 사용자는 가입 후 한 번의 클릭으로 무료 체험 크레딧 $0.50을 받을 수 있습니다. 이 크레딧은 7일 동안 유효하며 아래 모든 항목의 첫 테스트에 사용할 수 있습니다.

두 라이브러리를 설치하세요:

pip install discord.py openai
export DISCORD_TOKEN="your-discord-bot-token"
export NOFILTER_API_KEY="your-api-key"

두 값 모두 환경 변수나 시크릿 관리자에 보관하세요. 공개 저장소에 업로드되는 파일에 직접 붙여넣지 마세요.

최소 구성 봇

첫 번째 버전은 누군가가 봇을 멘션할 때마다 응답합니다. 비동기 OpenAI 클라이언트를 사용하므로 모델이 응답하는 동안 디스코드 이벤트 루프가 차단되지 않습니다.

import os
import discord
from openai import AsyncOpenAI

ai = AsyncOpenAI(
    base_url="https://api.nofilterai.top/v1",
    api_key=os.environ["NOFILTER_API_KEY"],
)

intents = discord.Intents.default()
intents.message_content = True
bot = discord.Client(intents=intents)

SYSTEM = (
    "You are a witty companion in a Discord server for adults. "
    "Stay in character, keep replies under 1500 characters."
)

@bot.event
async def on_message(message: discord.Message):
    if message.author.bot or bot.user not in message.mentions:
        return
    text = message.clean_content.replace(f"@{bot.user.name}", "").strip()
    async with message.channel.typing():
        resp = await ai.chat.completions.create(
            model="uncensored",
            messages=[
                {"role": "system", "content": SYSTEM},
                {"role": "user", "content": text},
            ],
            temperature=0.9,
            max_tokens=500,
        )
    await message.reply(resp.choices[0].message.content[:1900])

bot.run(os.environ["DISCORD_TOKEN"])

여기서 두 가지 세부 사항이 중요합니다. 디스코드는 2,000자보다 긴 메시지를 거부하므로 코드는 시스템 프롬프트에서 짧은 응답을 요청하고 안전망으로 텍스트를 1,900자로 자릅니다. 그리고 max_tokens은 이 API에서 선택 사항이지만 설정하면 계획된 비용보다 더 많은 비용이 드는 응답을 방지할 수 있습니다.

채널별 메모리 추가

메모리가 없는 봇은 두 번의 메시지 후에 깨진 것처럼 느껴집니다. 해결책은 채널별로 최근 턴의 짧은 목록을 유지하고 모든 요청과 함께 보내는 것입니다. API는 상태가 없으므로 기록은 전적으로 직접 관리해야 합니다.

from collections import defaultdict, deque

MAX_TURNS = 16
history = defaultdict(lambda: deque(maxlen=MAX_TURNS))

async def reply_with_memory(message, text):
    h = history[message.channel.id]
    h.append({"role": "user", "content": f"{message.author.display_name}: {text}"})
    resp = await ai.chat.completions.create(
        model="uncensored",
        messages=[{"role": "system", "content": SYSTEM}, *h],
        temperature=0.9,
        max_tokens=500,
    )
    answer = resp.choices[0].message.content
    h.append({"role": "assistant", "content": answer})
    return answer

각 사용자 입력 앞에 표시 이름을 붙이면 모델이 혼잡한 채널에서 화자를 구분할 수 있습니다. maxlen이 설정된 deque는 가장 오래된 턴을 자동으로 삭제합니다. 16턴이 적절한 시작점입니다. 컨텍스트 창은 100,000 토큰이므로 훨씬 더 많은 턴을 유지할 수 있지만, 추가된 모든 턴은 이후 모든 요청에서 입력 토큰으로 과금됩니다. 더 긴 기억력은 기술적 한계가 아닌 제품 결정 사항입니다.

긴 시간 동안 지속되는 캐릭터

캐릭터가 수주 동안 사실을 기억해야 한다면 채널당 짧은 요약을 파일이나 데이터베이스에 저장하고 시스템 프롬프트에 추가하세요. 모델 자체에게 약 30턴마다 요약을 갱신하도록 요청하세요. 이렇게 하면 프롬프트는 작게 유지되면서 캐릭터는 여전히 이름, 계속 이어지는 농담 및 줄거리를 기억합니다.

속도 제한 내에 머물기

전체 키는 동시 요청 8개와 분당 요청 300개를 허용합니다. 체험 키는 동시 요청 2개와 분당 60개를 허용합니다. 단일 조용한 서버라면 이러한 수치를 결코 도달하지 않겠지만, 인기 있는 채널에서는 같은 초 내에 여러 멘션이 발생할 수 있습니다.

가장 간단한 보호 방법은 동시 호출을 동시성 제한 아래로 제한하는 세마포어와 간헐적인 429 오류에 대한 재시도입니다. API는 HTTP 429 및 오류 코드로 문제를 알립니다. rate_limited은 분당 요청 수가 많음을, concurrency은 동시에 너무 많은 요청이 발생했음을 의미합니다. 일시적인 과부하 시 Retry-After: 5도 전송합니다.

import asyncio
from openai import RateLimitError

gate = asyncio.Semaphore(6)

async def ask(messages):
    async with gate:
        for attempt in range(4):
            try:
                r = await ai.chat.completions.create(
                    model="uncensored", messages=messages, max_tokens=500
                )
                return r.choices[0].message.content
            except RateLimitError:
                await asyncio.sleep(5 * (attempt + 1))
    return "I am busy right now, try again in a moment."

토큰이 도착할 때마다 디스코드 메시지를 편집하면서 응답을 스트리밍하는 경우, 스트리밍된 요청이 스트림이 끝날 때까지 동시성 슬롯을 보유한다는 점을 기억하세요. 스트리밍은 더 빠르게 느껴지지만 디스코드는 메시지 편집 빈도에 제한이 있으므로 매 토큰마다 업데이트하는 대신 약 1초마다 텍스트를 업데이트하세요. 대부분의 봇에게는 일반 비스트리밍 응답과 타이핑 표시가 더 간단하고 잘 작동합니다.

슬래시 명령어, 페르소나 및 서버 규칙

멘션이 시작하는 가장 빠른 방법이지만 슬래시 명령어는 사용자에게 더 깔끔한 인터페이스를 제공합니다. discord.app_commands를 사용하면 시스템 프롬프트를 전환하기 위해 /persona, 채널 기록을 지우기 위해 /reset, 저장된 요약을 출력하기 위해 /summary을 추가할 수 있습니다. 각 명령어는 위에서 표시된 프롬프트 및 기록 딕셔너리만 편집합니다.

서버를 건강하게 유지하기 위한 몇 가지 실용적인 습관:

  • 연령 제한으로 표시된 채널에서만 성인 테마 봇을 실행하고 채널 주제에 그렇게 명시하세요.
  • 캐릭터 소개와 경계를 시스템 프롬프트에 넣고 짧게 유지하세요. 모델은 긴 규칙집보다 명확한 150단어 소개를 더 잘 따릅니다.
  • 요청 ID를 로깅하세요. 모든 응답에는 X-Request-Id 헤더가 포함되어 있어 이상한 응답 하나를 추적할 때 도움이 됩니다.
  • 모델도 해당 규칙에 구속되지만, 봇 자체 코드에 미성년자를 성적으로 묘사하는 요청을 거부하는 강력한 규칙을 추가하세요. API는 이를 제공하지 않으며 봇도 시도하지 않아야 합니다.

API로 전송된 프롬프트는 학습에 사용되지 않습니다. 이는 멤버들이 사적인 것에 대해 채팅하는 경우 서버 규칙에 명시할 가치가 있습니다. 봇은 기록에 넣은 모든 것을 저장하므로 보관 기간을 결정하고 사람들에게 알려야 합니다.

실행 비용

가격은 선불 크레딧에서 1M 입력 토큰당 $0.15, 1M 출력 토큰당 $0.50입니다. 구독이 없습니다. 실패하거나 거부된 요청에는 요금이 청구되지 않으며 크레딧은 만료되지 않습니다. 현실적인 채팅 턴은 다음과 같습니다: 16턴의 기록과 시스템 프롬프트는 약 1,500 입력 토큰에 해당하며 응답은 약 300 토큰입니다.

파트토큰요금비용
입력1,500100만 개당 $0.15$0.000225
출력300100만 개당 $0.50$0.000150
응답 메시지 하나$0.000375

응답 메시지 1,000개당 $0.375가 발생합니다. 10,000개당 $3.75입니다. 최소 금액인 $20 충전으로는 그 크기로 53,000개 이상의 응답 메시지를 처리할 수 있습니다. 충전 금액은 $20부터 $500까지 달러 단위로 제공되며, $50부터 5%, $100부터 10%, $200부터 15%의 보너스가 제공됩니다. 이 사이트는 암호화폐만 받습니다: TRC20의 USDT 또는 Base의 USDC. 자세한 내용은 가격 책정 페이지를 참조하세요.

비용에 가장 큰 영향을 미치는 요소는 기록 길이입니다. 유지할 턴 수를 두 배로 늘리면 입력 토큰도 대략 두 배가 됩니다. 턴 수를 제한하고 X-Balance-USD 응답 헤더를 확인하세요. 이 헤더는 각 호출 후 남은 잔액을 보고합니다. 이를 로그로 남기고 봇이 임계값 아래로 떨어지면 관리자 채널에 경고 메시지를 게시하도록 설정할 수 있습니다.

문제 해결

봇은 온라인이지만 응답하지 않습니다: 이는 거의 항상 메시지 콘텐츠 인텐트 문제입니다. 개발자 포털과 코드 모두에서 이를 활성화하세요(위 참조).

부하 상태에서 429 오류가 발생합니다: 세마포어 값을 낮추고 반환된 오류 코드를 확인한 후 백오프하세요. 코드가 rate_limited인 경우 분당 요청 수가 너무 많습니다. 코드가 concurrency인 경우 동시에 너무 많은 요청이 발생했습니다.

응답이 밋밋하게 느껴집니다: temperature을 1.0에 가깝게 높이고 시스템 프롬프트에 캐릭터의 말투 예시 줄을 두세 개 추가하며, 반복된 구문을 방지하기 위해 작은 frequency_penalty을 시도하세요. 이러한 매개변수는 모델에 전달됩니다.

응답이 잘립니다: Discord의 2,000자 제한이 일반적인 이유입니다. 긴 답변을 여러 메시지로 나누거나 더 짧은 답변을 요청하세요. 요청 옵션에 대해 더 자세히 알고 싶다면 API 빠른 시작을 읽고, 캐릭터 중심의 봇을 구축 중이라면 AI 동반자 API 페이지에서 페르소나 설계에 대해 더 자세히 알아보세요.

질문과 답변

무검열 디스코드 봇에 특별한 라이브러리가 필요한가요?

아니요. Discord에는 discord.py(또는 discord.js)를 사용하고 모델에는 일반 OpenAI SDK를 사용하세요. 변경되는 것은 베이스 URL, 키 및 모델 ID uncensored뿐입니다.

봇이 이미지나 음성 응답을 생성할 수 있나요?

아니요. 이 API는 텍스트 전용이며, 이미지, 오디오, 비디오 생성 및 임베딩 기능이 없습니다.

동시에 몇 명의 사용자가 봇과 채팅할 수 있나요?

전체 키는 동시 요청 8개와 분당 요청 300개를 허용합니다. 봇에서 추가 요청을 대기열에 넣고 HTTP 429 응답 시 재시도하세요.

무료로 테스트할 수 있는 방법이 있나요?

네. 가입 후 API 키 페이지에서 한 번의 클릭으로 $0.50의 무료 체험 크레딧을 청구할 수 있습니다. 유효 기간은 7일이며, 1인당 1회 한도입니다.

키는 양식 하나만 작성하면 받을 수 있습니다

계정을 생성하고 키를 복사한 후 베이스 URL을 변경하세요. 설정은 이것으로 끝입니다.

API 키 받기