VI ▾

unfilteredaiapi.comhttps://api.unfilteredaiapi.com/v1

Unfiltered AI

API LLM thô, không kiểm duyệt dành cho nhà phát triển.

Unfiltered AILấy khóa API

Unfiltered AI cho hội thoại NPC game và truyện tương tác

Giữ quyền kiểm soát trò chơi trong engine: lưu trữ trạng thái của từng NPC, xác thực các lệnh gọi công cụ được đề xuất và bảo toàn các chuyển đổi cốt truyện được phép. Hướng dẫn này áp dụng các quy tắc đó vào lời thoại được tạo và chỉ cách ước tính chi phí token.

Unfiltered AI cho hội thoại NPC game và truyện tương tác

Điểm chính

  • Các nhà cung cấp suy luận chuyên dụng như Unfiltered AI cung cấp hành vi không kiểm duyệt ổn định trên một mô hình duy nhất, tránh được tính ngẫu nhiên của việc định tuyến qua bộ tổng hợp.
  • Các bộ tổng hợp như OpenRouter cung cấp quyền truy cập vào nhiều mô hình nhưng có thể khác nhau về mức độ nghiêm ngặt khi áp dụng bộ lọc nội dung tùy thuộc vào phiên bản mô hình cụ thể.
  • Unfiltered AI sử dụng mô hình trọng số mở trên phần cứng chuyên dụng với cửa sổ ngữ cảnh 100k token, giá $0,15/$0,50 cho mỗi triệu token.
  • Đối với tính nhất quán NSFW hoặc nhập vai nghiêm ngặt, một API LLM không kiểm duyệt chuyên dụng loại bỏ nhu cầu kỹ thuật prompt phức tạp để vượt qua bộ lọc chung.

Vòng lặp game, mô tả bằng lời

Hãy giữ sơ đồ này trong đầu bạn. Một dòng người chơi đi vào engine. Engine soạn một prompt từ ba phần: hướng dẫn cố định, bản ghi trạng thái hiện tại của NPC và hội thoại gần đây. Prompt được gửi đến mô hình. Mô hình trả lời bằng text, với gọi hàm, hoặc với cả hai. Văn bản hiển thị trên màn hình. Các lệnh gọi hàm quay lại engine, nơi chúng được xác thực, làm thay đổi bản ghi trạng thái và trả về một chuỗi kết quả ngắn để mô hình có thể hoàn thành câu của mình. Sau đó, vòng lặp chờ người chơi.

Thuộc tính quan trọng là engine là nguồn sự thật duy nhất. Mô hình đề xuất; engine quyết định. Nếu mô hình nói một nhân vật trao chìa khóa nhưng không bao giờ gọi hàm, chìa khóa vẫn nằm trong kho đồ. Sự tách biệt này là thứ khiến hội thoại được tạo ra an toàn khi kết nối vào một game có quy tắc. Mọi thứ bên dưới đều bắt nguồn từ nó.

Tất cả yêu cầu sử dụng endpoint chat-completions tiêu chuẩn tại https://api.unfilteredaiapi.com/v1 với id mô hình uncensored. Công cụ sử dụng định dạng gọi hàm OpenAI, nên cùng mã hoạt động với các thư viện khách chính thức.

Phạm vi và lưu ý dành cho người trưởng thành

Truyện tương tác cho khán giả trưởng thành là một mục đích sử dụng hợp lệ. Dịch vụ không từ chối nội dung người trưởng thành hợp pháp, chủ đề tối hoặc gây tranh cãi trong truyện. Nó dành cho người từ 18 tuổi trở lên, và game của bạn nên nói điều đó trên trang cửa hàng và kiểm soát truy cập tương ứng.

Một dòng cố định: nội dung tình dục liên quan đến trẻ vị thành niên luôn bị chặn bằng mã 403, trong cả truyện và nhập vai. Thiết kế cho điều đó một cách rõ ràng. Gán cho mọi nhân vật tuổi trưởng thành trong bản ghi trạng thái, và làm cho engine xử lý mã 403 một cách duyên dáng bằng cách kết thúc cuộc trao đổi thay vì thử lại.

Trạng thái NPC có cấu trúc

Mô tả nhân vật tự do bị trôi dạt. Một bản ghi có cấu trúc gọn gàng thì không. Giữ nó nhỏ, đặt nó trong tin nhắn hệ thống trên mỗi lượt, và gắn nhãn là có thẩm quyền để mô hình coi nó là sự thật thay vì gợi ý.

{
  "name": "Brannoch",
  "role": "ferry smuggler",
  "mood": "wary",
  "trust": 1,
  "inventory": ["brass key", "flask of rum"],
  "knows": ["the harbourmaster takes bribes", "a tunnel runs under the salt warehouse"],
  "will_never": ["name his employer", "leave the dock before dawn"],
  "location": "Gull Quay, pre-dawn"
}

Mỗi trường đều xứng đáng có vị trí của nó. mood và trust điều chỉnh giọng điệu. inventory giới hạn những gì có thể được trao. knows giới hạn những gì NPC có thể tiết lộ, vì vậy người chơi không thể trích xuất các điểm cốt truyện mà nhân vật không có lý do để giữ. will_never là một danh sách ngắn các từ chối cứng nhắc giúp nhân vật có cốt cách. Với khoảng 120 token, toàn bộ bản ghi này tốn gần như không đáng kể mỗi lượt.

Gọi hàm cho hành động trong game

Công cụ chuyển văn bản thành thay đổi trạng thái. Ba công cụ dưới đây bao gồm hầu hết các cơ chế dựa trên hội thoại: thay đổi độ tin cậy, chuyển một món đồ và đưa ra các lựa chọn. Lưu ý rằng apply_tool giới hạn độ tin cậy và từ chối các món đồ mà NPC không sở hữu; việc xác thực nằm trong mã.

import json
import os
from openai import OpenAI

client = OpenAI(base_url="https://api.unfilteredaiapi.com/v1", api_key=os.environ["API_KEY"])

TOOLS = [
    {"type": "function", "function": {
        "name": "adjust_trust",
        "description": "Change how much this NPC trusts the player after what was just said.",
        "parameters": {"type": "object", "properties": {
            "delta": {"type": "integer", "minimum": -2, "maximum": 2},
            "reason": {"type": "string"}},
            "required": ["delta"]}}},
    {"type": "function", "function": {
        "name": "give_item",
        "description": "Hand an item from the NPC's inventory to the player.",
        "parameters": {"type": "object", "properties": {
            "item": {"type": "string"}}, "required": ["item"]}}},
    {"type": "function", "function": {
        "name": "offer_choices",
        "description": "Present up to three short dialogue options for the player to pick from.",
        "parameters": {"type": "object", "properties": {
            "choices": {"type": "array", "items": {"type": "string"}, "maxItems": 3}},
            "required": ["choices"]}}},
]

def apply_tool(name, args, state, out):
    if name == "adjust_trust":
        state["trust"] = max(-3, min(5, state["trust"] + int(args.get("delta", 0))))
        return f"trust is now {state['trust']}"
    if name == "give_item":
        item = args.get("item")
        if item in state["inventory"]:
            state["inventory"].remove(item)
            out["items"].append(item)
            return f"gave {item}"
        return "refused: item not in inventory"          # the engine, not the model, decides
    if name == "offer_choices":
        out["choices"] = args.get("choices", [])[:3]
        return "choices shown"
    return "unknown tool"

def npc_turn(state, history, player_line):
    system = {"role": "system", "content": (
        "You voice one NPC in an adults-only interactive story. Stay in character, "
        "at most 80 words per reply, no narration of the player's actions. "
        "Use tools for anything that changes the game; never claim an item was given without calling give_item.\n"
        "NPC state (authoritative): " + json.dumps(state))}
    history.append({"role": "user", "content": player_line})
    out = {"text": "", "items": [], "choices": []}

    for _ in range(4):                                       # cap tool-call rounds
        r = client.chat.completions.create(
            model="uncensored", messages=[system] + history, tools=TOOLS,
            temperature=0.8, max_tokens=300)
        msg = r.choices[0].message
        entry = {"role": "assistant", "content": msg.content}
        if msg.tool_calls:
            entry["tool_calls"] = [{"id": c.id, "type": "function",
                "function": {"name": c.function.name, "arguments": c.function.arguments}}
                for c in msg.tool_calls]
        history.append(entry)
        if msg.content:
            out["text"] += msg.content
        if not msg.tool_calls:
            return out
        for c in msg.tool_calls:
            result = apply_tool(c.function.name, json.loads(c.function.arguments or "{}"), state, out)
            history.append({"role": "tool", "tool_call_id": c.id, "content": result})
    return out

state = json.loads(open("brannoch.json").read())
history = []
print(npc_turn(state, history, "I need to cross before sunrise. Name your price."))

Hai chi tiết đáng chú ý. Thứ nhất, các vòng gọi hàm được giới hạn ở bốn, vì vậy một mô hình bối rối không thể lặp lại mãi mãi. Thứ hai, mỗi lệnh gọi hàm đều có một tin nhắn tool tương ứng với cùng tool_call_id; bỏ qua nó và yêu cầu tiếp theo sẽ bị lỗi cú pháp. Các chuỗi kết quả ngắn gọn và mang tính thực tế, cho phép mô hình ghi nhận những gì đã xảy ra mà không cần bịa đặt hậu quả.

Phân nhánh mà không mất cốt truyện

Hãy để engine sở hữu đồ thị cốt truyện và để mô hình sở hữu các câu. Một nút liệt kê NPC nào nói, cổng nào phải vượt qua và mỗi lựa chọn dẫn đến đâu. Khi mô hình gọi offer_choices, bạn ánh sáng mỗi tùy chọn vào một khóa nút; văn bản tự do không khớp sẽ quay lại nút hiện tại.

{
  "id": "quay_negotiation",
  "npc": "brannoch",
  "gate": {"trust_at_least": 2},
  "on_choice": {
    "pay_double":   {"next": "crossing_fast", "set": {"gold": -40}},
    "threaten":     {"next": "quay_standoff", "trust_delta": -2},
    "ask_about_tunnel": {"next": "warehouse_tunnel", "requires_fact": "tunnel"}
  },
  "fallback": "quay_negotiation"
}

Điều này giữ cho cốt truyện có thể tiếp cận và kiểm tra được. Bạn có thể đi qua đồ thị mà không cần một cuộc gọi API nào, kiểm tra xem mỗi next tồn tại, và xác nhận rằng các nút được khóa yêu cầu các sự kiện mà người chơi thực sự có thể khám phá. Mô hình cung cấp sự đa dạng bên trong mỗi nút, không phải cấu trúc xung quanh nó.

  • Cổng đọc bản ghi trạng thái: ngưỡng lòng tin, vật phẩm đã nắm giữ, sự kiện đã biết.
  • Hiệu ứng sửa đổi nó: vàng, lòng tin, cờ.
  • Dự phòng giữ người chơi tại chỗ khi đầu vào không rõ ràng.

Bộ nhớ xuyên suốt quá trình chơi dài

Một NPC đã gặp mười giờ trước vẫn nên nhớ một lời sỉ nhục. Đừng phát lại mười giờ hội thoại. Lưu một bản tóm tắt hai câu cho mỗi NPC, cập nhật nó khi một cuộc hội thoại kết thúc và thêm nó vào bản ghi trạng thái dưới dạng trường memories. Cơ chế tóm tắt và ngân sách được đề cập trong bài viết về bộ nhớ 100k, và việc cắt giảm tương tự cũng áp dụng cho hội thoại trượt của mỗi NPC.

Nếu bạn phục vụ một trò chơi trình duyệt, hãy chuyển tiếp luồng thông qua máy chủ của riêng bạn như trong bài viết FastAPI để khóa không bao giờ đến được máy khách.

Kiểm tra NPC như cách bạn kiểm tra mã

Hội thoại từ một mô hình là xác suất, nhưng các quy tắc xung quanh nó thì không, và đó là nơi các bài kiểm tra thuộc về. Lưu bản ghi trạng thái từ trước đó dưới dạng brannoch.json, sau đó viết các kiểm tra chống lại engine thay vì chống lại văn bản.

  1. Kiểm tra xác thực công cụ. Gọi apply_tool trực tiếp với một món đồ mà NPC không sở hữu, một độ lệch độ tin cậy là 99 và các đối số bị lỗi. Trạng thái phải hợp pháp trong mọi trường hợp.
  2. Bài kiểm tra đồ thị. Tải mọi nút, xác nhận mỗi mục tiêu next tồn tại và đi qua một đường dẫn từ nút đầu tiên đến mỗi điểm kết thúc mà không cần gọi API.
  3. Kiểm tra phát lại. Ghi lại một cuộc hội thoại thực tế một lần, bao gồm các lệnh gọi hàm và kết quả, sau đó phát lại các tin nhắn công cụ đối với engine để kiểm tra xem trạng thái cuối cùng có khớp với những gì bạn mong đợi hay không.
  4. Kiểm tra tải ổn định. Chạy một người chơi kịch bản qua năm mươi dòng ở nhiệt độ thấp và khẳng định rằng NPC không bao giờ đưa ra một món đồ mà nó thiếu và không bao giờ vượt quá giới hạn độ tin cậy.

Giảm nhiệt độ xuống khoảng 0.3 cho những lần chạy đó, sau đó quay lại 0.8 để chơi. Ít bất ngờ hơn trong khi kiểm tra có nghĩa là một lỗi sẽ chỉ ra mã của bạn, không phải nhiễu lấy mẫu. Khi một lỗi xuất hiện trong trò chơi trực tiếp, hãy thêm cuộc trao đổi gây lỗi vào bộ phát lại để nó không thể quay lại mà không được chú ý.

Một thói quen cuối cùng: giữ giọng điệu nhân vật trong một đoạn văn ngắn cho mỗi NPC và các quy tắc trong bản ghi trạng thái. Giọng điệu có thể được tinh chỉnh tự do bởi các nhà văn; các quy tắc chỉ được thay đổi với một đánh giá mã. Trộn chúng trong một khối duy nhất là cách một bản viết lại tính cách của NPC vô tình mở khóa một món đồ.

Tính toán chi phí, với các giả định được nêu rõ

Giá là $0,15 cho mỗi triệu token đầu vào và $0,50 cho mỗi triệu token đầu ra. Các số liệu dưới đây là các giả định để lập kế hoạch, không phải là số đo. Giả sử một dòng NPC tốn: hướng dẫn hệ thống và trạng thái 350 token, hội thoại gần đây 1.000 token, định nghĩa công cụ 250 token, vì vậy 1.600 token đầu vào; phản hồi 100 token đầu ra.

MụcTính toánChi phí
Đầu vào mỗi dòng1.600 x $0,15 / 1M$0,0004
Đầu ra mỗi dòng100 x $0,50 / 1M$0,0001
Một dòngtổng$0,0005
Một phiên, 60 dòng60 x $0,0005$0,03
10.000 phiên10.000 x $0,03$300

Một vòng lặp gọi hàm thêm một yêu cầu khác: khoảng 1.700 token đầu vào cộng 40 token đầu ra, khoảng $0,00047. Nếu một trong ba dòng kích hoạt một công cụ, hãy thêm một phần ba số đó vào trung bình. Các kiểm tra trần cũng quan trọng: ở 300 yêu cầu mỗi phút trên mỗi khóa, một khóa duy nhất hỗ trợ khoảng 300 dòng NPC mỗi phút trên tất cả người chơi đồng thời, vì vậy các lần ra mắt lớn cần hàng đợi. Các tỷ lệ được tóm tắt trên trang giá cả.

Hỏi đáp

API có hỗ trợ gọi hàm cho các hành động trong game không?

Có. Các công cụ được chấp nhận theo định dạng OpenAI, vì vậy bạn khai báo các hàm, nhận lệnh gọi công cụ và gửi kết quả lại dưới dạng tin nhắn công cụ.

Một cuộc hội thoại NPC tốn bao nhiêu?

Nó phụ thuộc vào prompt của bạn. Với giả định 1.600 token đầu vào và 100 token đầu ra cho mỗi dòng, một dòng tốn khoảng $0,0005 theo mức giá công bố.

Các nhân vật trong game của tôi có thể là trẻ vị thành niên trong các cảnh tình dục không?

Không. Nội dung tình dục liên quan đến trẻ vị thành niên luôn bị chặn bằng mã 403, bao gồm cả trong truyện hư cấu. Dịch vụ dành cho người trưởng thành từ 18 tuổi trở lên.

Làm thế nào để ngăn NPC tiết lộ bí mật cốt truyện?

Liệt kê những gì nó biết và những gì nó sẽ không làm trong bản ghi trạng thái, và áp dụng các thay đổi về mục và cờ trong mã của bạn.

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 URL cơ sở. Đó là toàn bộ quá trình thiết lập.

Lấy khóa APIĐọc tài liệu