VI ▾
nofilterai.top
NoFilter AI
Lấy khóa API

Bot Discord AI không bộ lọc: Xây dựng bằng Python

API AI girlfriend cung cấp giao diện chuyên dụng cho các ứng dụng trò chuyện mô phỏng các tương tác lãng mạn hoặc giống như người bạn đồng hành bằng các mô hình ngôn ngữ lớn. Hướng dẫn này so sánh các phương pháp kỹ thuật, tập trung vào các mô hình không kiểm duyệt xử lý ngữ cảnh đóng vai mà không có từ chối nội dung tiêu chuẩn.

Minh họa đẳng hướng các bong bóng tin nhắn chảy từ robot vào các bảng tin, đại diện cho bot Discord

Bạn đang xây dựng gì

Một bot như thế này là bot Discord thông thường, câu trả lời đến từ mô hình ngôn ngữ không từ chối các yêu cầu người lớn hợp pháp. Bot lắng nghe các lượt mention hoặc lệnh slash, gửi đoạn hội thoại đến endpoint chat-completions và đăng lại câu trả lời vào kênh. Không có gì thay đổi ở phía Discord. Sự khác biệt duy nhất so với hướng dẫn điển hình là nguồn gốc của văn bản.

API này tương thích với OpenAI, nên bạn không cần một client đặc biệt. Bất kỳ SDK OpenAI nào cũng hoạt động sau khi bạn thay đổi base URL và khóa. Model ID là uncensored. Đây là một mô hình trọng số mở duy nhất do một nhà cung cấp độc lập vận hành, được tinh chỉnh để trả lời mà không từ chối nội dung cho mục đích người trưởng thành hợp pháp. Nó chỉ xử lý văn bản, nên bot sẽ trò chuyện, viết truyện, chạy game văn bản và nhập vai nhân vật, nhưng không tạo hình ảnh hoặc âm thanh.

Một quy tắc luôn cố định bất kể bạn cấu hình bot thế nào: không có nội dung tình dục liên quan đến người chưa thành niên. Ngoài ra, Discord có các điều khoản và hướng dẫn cộng đồng riêng, và chúng áp dụng cho bot và máy chủ của bạn. Bạn nên đặt các bot chủ đề người lớn vào các kênh giới hạn độ tuổi và thông báo cho người dùng mục đích của bot.

Trước khi bắt đầu

Bạn cần bốn thứ: tài khoản Discord, Python 3.10 trở lên, khóa API và máy chủ nơi bạn có quyền thêm bot.

  1. Bạn mở cổng developer Discord, tạo ứng dụng, thêm người dùng bot và sao chép token của nó. Bạn hãy coi token đó như mật khẩu.
  2. Trên trang bot, bạn bật intent Message Content. Không có nó, bot của bạn nhận được tin nhắn với văn bản rỗng.
  3. Bạn mời bot vào máy chủ của mình với scope bot và quyền đọc cũng như gửi tin nhắn.
  4. Tạo một khóa API trên trang khóa API. Người dùng mới có thể nhận $0,50 tín dụng dùng thử miễn phí chỉ với một cú nhấp chuột sau khi đăng ký. Tín dụng này có hiệu lực trong 7 ngày và dùng để kiểm tra mọi tính năng bên dưới.

Bạn cài đặt hai thư viện:

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

Bạn giữ cả hai giá trị trong biến môi trường hoặc trình quản lý bí mật. Không bao giờ dán chúng vào tệp đưa lên kho lưu trữ công khai.

Bot tối giản

Phiên bản đầu tiên trả lời bất cứ khi nào ai đó đề cập đến bot. Bạn dùng client OpenAI không đồng bộ để vòng lặp sự kiện Discord không bị chặn trong khi mô hình đang viết.

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"])

Hai chi tiết quan trọng ở đây. Discord từ chối tin nhắn dài hơn 2.000 ký tự, nên mã vừa yêu cầu câu trả lời ngắn trong system prompt vừa cắt văn bản ở mức 1.900 làm lớp bảo vệ. Và max_tokens là tùy chọn trên API này, nhưng việc đặt nó sẽ ngăn câu trả lời chạy mất kiểm soát làm tốn nhiều chi phí hơn bạn dự tính.

Thêm bộ nhớ theo kênh

Một bot không có bộ nhớ sẽ cảm thấy lỗi sau hai tin nhắn. Giải pháp là giữ một danh sách ngắn các lượt hội thoại gần đây cho mỗi kênh và gửi cùng mọi yêu cầu. API không có trạng thái, nên lịch sử hoàn toàn do bạn quản lý.

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

Việc thêm tiền tố tên hiển thị cho mỗi dòng người dùng giúp mô hình phân biệt người nói trong kênh đông đúc. Một deque với maxlen sẽ tự động loại bỏ các lượt cũ nhất. Mười sáu lượt là điểm khởi đầu hợp lý. Cửa sổ ngữ cảnh là 100.000 token, nên bạn có thể giữ nhiều hơn, nhưng mỗi lượt thêm vào đều được tính phí là đầu vào trên mọi yêu cầu sau. Bộ nhớ dài hơn là quyết định sản phẩm, không phải giới hạn kỹ thuật.

Nhân vật chạy dài hạn

Nếu một nhân vật phải ghi nhớ sự thật trong nhiều tuần, bạn lưu một bản tóm tắt ngắn theo kênh vào tệp hoặc cơ sở dữ liệu và thêm vào system prompt. Bạn yêu cầu mô hình tự làm mới bản tóm tắt sau mỗi khoảng 30 lượt. Điều này giữ prompt nhỏ trong khi nhân vật vẫn nhớ tên, các trò đùa lặp lại và các điểm cốt truyện.

Giữ trong giới hạn tốc độ

Khóa đầy đủ cho phép 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút. Khóa dùng thử cho phép 2 yêu cầu đồng thời và 60 mỗi phút. Một máy chủ yên tĩnh sẽ không bao giờ chạm đến các con số đó, nhưng một kênh phổ biến có thể kích hoạt nhiều lượt mention trong cùng một giây.

Biện pháp bảo vệ đơn giản nhất là một semaphore giới hạn các lệnh gọi đồng thời dưới giới hạn đồng thời, cộng với việc thử lại cho lỗi 429 thỉnh thoảng xảy ra. API báo hiệu sự cố bằng HTTP 429 và mã lỗi: rate_limited nghĩa là quá nhiều yêu cầu mỗi phút, concurrency nghĩa là quá nhiều yêu cầu cùng lúc. Khi quá tải tạm thời, API cũng gửi 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."

Nếu bạn truyền phát câu trả lời và chỉnh sửa tin nhắn Discord khi token đến, bạn nhớ rằng một yêu cầu truyền phát giữ slot đồng thời của nó cho đến khi luồng kết thúc. Truyền phát cảm thấy nhanh hơn, nhưng Discord giới hạn tần suất bạn có thể chỉnh sửa tin nhắn, nên bạn hãy cập nhật văn bản mỗi khoảng một giây thay vì trên mỗi token. Đối với hầu hết các bot, câu trả lời không truyền phát đơn giản kèm chỉ báo đang nhập là đơn giản hơn và hoạt động tốt.

Lệnh slash, nhân vật và quy tắc máy chủ

Mention (đề cập) là cách nhanh nhất để bắt đầu, nhưng lệnh slash mang lại giao diện sạch hơn cho người dùng. Với discord.app_commands, bạn có thể thêm /persona để chuyển system prompt, /reset để xóa lịch sử kênh và /summary để in bản tóm tắt đã lưu. Mỗi lệnh chỉ chỉnh sửa từ điển các prompt và lịch sử hiển thị ở trên.

Một vài thói quen thực tế giúp máy chủ khỏe mạnh:

  • Bạn chỉ chạy các bot chủ đề người lớn trong các kênh được đánh dấu giới hạn độ tuổi và thông báo rõ trong chủ đề kênh.
  • Bạn đặt bản tóm tắt nhân vật và các ranh giới vào system prompt và giữ nó ngắn. Mô hình tuân thủ bản tóm tắt rõ ràng 150 từ tốt hơn sách quy tắc dài.
  • Bạn ghi lại ID yêu cầu. Mọi phản hồi đều có tiêu đề X-Request-Id, giúp ích khi bạn cần theo dõi một câu trả lời kỳ lạ đơn lẻ.
  • Bạn thêm quy tắc cứng trong mã của mình để từ chối bất kỳ yêu cầu nào biến người chưa thành niên thành đối tượng tình dục, mặc dù mô hình cũng bị ràng buộc bởi quy tắc đó. API sẽ không phục vụ nó, và bot của bạn cũng không nên thử.

Các prompt gửi đến API không được dùng để huấn luyện, điều đáng nói trong quy tắc máy chủ nếu thành viên chat về các vấn đề cá nhân. Bot của bạn cũng lưu trữ bất cứ thứ gì bạn đưa vào lịch sử, nên bạn quyết định giữ chúng trong bao lâu và thông báo cho mọi người.

Chi phí vận hành

Giá là $0,15 cho mỗi 1M token đầu vào và $0,50 cho mỗi 1M token đầu ra, từ tín dụng trả trước không có gói đăng ký. Các yêu cầu bị lỗi hoặc bị từ chối không bị tính phí và tín dụng không bao giờ hết hạn. Đây là một lượt chat thực tế: 16 lượt lịch sử cộng với system prompt tạo thành khoảng 1.500 token đầu vào, và câu trả lời là khoảng 300 token.

PhầnTokenTỷ lệChi phí
Đầu vào1.500$0,15 cho 1 triệu$0,000225
Đầu ra300$0,50 cho 1 triệu$0,000150
Một câu trả lời$0,000375

Một nghìn câu trả lời tốn $0,375. Mười nghìn câu tốn $3,75. Một khoản nạp tiền $20, mức nhỏ nhất, đủ cho hơn 53.000 câu trả lời ở mức giá đó. Các khoản nạp tiền dao động từ $20 đến $500 theo bội số nguyên của đô la, với mức thưởng thêm 5% từ $50, 10% từ $100 và 15% từ $200. Trang web này chỉ chấp nhận tiền mã hóa: USDT trên TRC20 hoặc USDC trên Base. Xem trang bảng giá để biết chi tiết.

Đòn bẩy lớn nhất đối với chi phí là độ dài lịch sử. Nếu bạn nhân đôi số lượt giữ lại, token đầu vào cũng tăng gấp đôi. Bạn hãy giới hạn chúng và theo dõi tiêu đề phản hồi X-Balance-USD, tiêu đề này báo số dư còn lại của bạn sau mỗi lệnh gọi. Bạn có thể ghi lại nó và có bot đăng cảnh báo trong kênh quản trị khi số dư giảm dưới ngưỡng.

Khắc phục sự cố

Bot trực tuyến nhưng không bao giờ trả lời: nguyên nhân gần như luôn là thiếu intent Message Content. Bạn hãy bật nó trong cổng developer và cả trong mã nguồn, như đã hiển thị ở trên.

Bạn thấy lỗi 429 khi tải cao: hãy giảm semaphore, kiểm tra mã lỗi nào được trả về, và giảm tốc độ gửi. Nếu mã là rate_limited, bạn đang gửi quá nhiều yêu cầu mỗi phút. Nếu là concurrency, quá nhiều yêu cầu đang được xử lý cùng lúc.

Câu trả lời cảm thấy nhàm chán: hãy tăng temperature về gần 1.0, thêm hai hoặc ba dòng ví dụ về lời thoại của nhân vật vào system prompt, và thử một frequency_penalty nhỏ để ngăn lặp lại cụm từ. Các tham số này được chuyển tiếp trực tiếp đến mô hình.

Câu trả lời bị cắt ngang: giới hạn 2.000 ký tự của Discord là nguyên nhân thường gặp. Bạn hãy chia các câu trả lời dài thành nhiều tin nhắn, hoặc yêu cầu ngắn gọn hơn. Để tìm hiểu sâu hơn về các tùy chọn yêu cầu, hãy đọc hướng dẫn bắt đầu nhanh API, và nếu bạn đang xây dựng bot theo nhân vật, trang API bạn đồng hành AI sẽ trình bày chi tiết hơn về thiết kế persona.

Hỏi đáp

Bạn có cần thư viện đặc biệt cho bot Discord không kiểm duyệt không?

Không. Bạn hãy dùng discord.py (hoặc discord.js) cho Discord và SDK OpenAI tiêu chuẩn cho mô hình. Chỉ có base URL, khóa và model ID uncensored là thay đổi.

Bot có thể tạo ảnh hoặc phản hồi giọng nói không?

Không. API chỉ hỗ trợ văn bản, không có tạo ảnh, âm thanh, video hay embeddings.

Có bao nhiêu người dùng có thể trò chuyện với bot cùng lúc?

Một khóa API đầy đủ cho phép 8 yêu cầu đồng thời và 300 yêu cầu mỗi phút. Bạn hãy xếp hàng các yêu cầu bổ sung trong bot của mình và thử lại khi nhận HTTP 429.

Có cách nào dùng thử miễn phí không?

Có. Sau khi đăng ký, bạn có thể nhận $0,50 tín dụng dùng thử miễn phí bằng một cú nhấp chuột trên trang khóa API. Tín dụng này có hiệu lực trong 7 ngày, một lần cho mỗi người.

Khóa của bạn chỉ cách một biểu mẫu

Tạo tài khoản, sao chép khóa, thay đổi base URL. Đó là toàn bộ thiết lập.

Lấy khóa API