TH ▾

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

Unfiltered AI

API LLM แบบดิบ ไม่เซ็นเซอร์ สำหรับนักพัฒนา

Unfiltered AIรับคีย์ API

Unfiltered AI สำหรับบทสนทนา NPC เกมและนิยายเชิงโต้ตอบ

รักษาอำนาจของเกมไว้ในเอนจิน: บันทึกสถานะของ NPC แต่ละตัว ตรวจสอบการเรียกใช้เครื่องมือที่เสนอ และรักษาการเปลี่ยนผ่านของเรื่องราวที่อนุญาต คู่มือนี้ใช้กฎเหล่านั้นกับบทสนทนาที่สร้างขึ้นมา และแสดงวิธีประมาณการต้นทุนโทเคน

Unfiltered AI สำหรับบทสนทนา NPC เกมและนิยายเชิงโต้ตอบ

จุดสำคัญ

  • ผู้ให้บริการอนุมานแบบเฉพาะเช่น Unfiltered AI นำเสนอพฤติกรรมที่ไม่มีการเซ็นเซอร์ที่สม่ำเสมอบนโมเดลเดียว โดยหลีกเลี่ยงความสุ่มของการจัดเส้นทางโดยตัวรวม
  • Aggregators เช่น OpenRouter ให้การเข้าถึงโมเดลหลายตัวแต่อาจมีความแตกต่างในวิธีการใช้ content filters อย่างเข้มงวดขึ้นอยู่กับเวอร์ชันโมเดลเฉพาะ
  • Unfiltered AI ใช้โมเดลแบบเปิดน้ำหนักบนฮาร์ดแวร์เฉพาะ โดยมีหน้าต่างบริบท 100k โทเคน ราคาอยู่ที่ $0.15/$0.50 ต่อหนึ่งล้านโทเคน
  • สำหรับการรักษาความสอดคล้องของ NSFW หรือ roleplay ที่เข้มงวด API LLM uncensored เฉพาะทางกำจัดความจำเป็นในการปรับแต่ง prompt ที่ซับซ้อนเพื่อข้าม filters ทั่วไป

ลูปของเกม เขียนด้วยคำพูด

จดจำแผนภาพนี้ไว้: บรรทัดของผู้เล่น เข้าสู่ engine เครื่องมือจะสร้างพรอมต์จากสามส่วน: คำสั่งคงที่, บันทึกสถานะ ปัจจุบันของ NPC และบทสนทนาล่าสุด พรอมต์จะถูกส่งไปยังโมเดล โมเดลจะตอบกลับด้วย text พร้อม การเรียกใช้ฟังก์ชัน หรือทั้งสองอย่าง ข้อความจะแสดงบนหน้าจอ การเรียกใช้ฟังก์ชันจะถูกส่งกลับไปยังเครื่องมือ ซึ่งทำการตรวจสอบ เปลี่ยนแปลงบันทึกสถานะ และส่งสตริงผลลัพธ์สั้นๆ เพื่อให้โมเดลสามารถจบประโยคได้ จากนั้นวงจรจะรอผู้เล่น

คุณสมบัติสำคัญคือ เครื่องมือคือแหล่งความจริงเพียงแหล่งเดียว โมเดลเสนอ; เครื่องมือตัดสินใจ หากโมเดลบอกว่าตัวละครมอบกุญแจแต่ไม่ได้เรียกใช้ฟังก์ชัน กุญแจจะยังคงอยู่ในกระเป๋า การแยกส่วนนี้ทำให้บทสนทนาที่สร้างขึ้นปลอดภัยต่อการเชื่อมต่อกับเกมที่มีกฎเกณฑ์ ทุกอย่างด้านล่างเป็นผลสืบเนื่องมาจากสิ่งนี้

คำขอทั้งหมดใช้ endpoint chat-completions มาตรฐานที่ https://api.unfilteredaiapi.com/v1 พร้อม model id uncensored เครื่องมือใช้รูปแบบการเรียกใช้ฟังก์ชันของ OpenAI ดังนั้นโค้ดเดียวกันจึงใช้งานได้กับไลบรารีทางการ

ขอบเขตและหมายเหตุเฉพาะผู้ใหญ่

นิยายเชิงโต้ตอบสำหรับผู้ใหญ่เป็นกรณีการใช้งานที่ถูกต้อง บริการไม่ปฏิเสธเนื้อหาสำหรับผู้ใหญ่ที่ถูกต้องตามกฎหมาย ธีมมืด หรือหัวข้อที่ถกเถียงได้ในนิยาย มุ่งเน้นสำหรับผู้ใหญ่ที่มีอายุ 18 ปีขึ้นไป และเกมของคุณควรระบุเช่นนั้นในหน้าร้านค้าและจำกัดการเข้าถึงตามนั้น

บรรทัดหนึ่งคงที่: เนื้อหาทางเพศที่เกี่ยวข้องกับเด็กจะถูกบล็อกด้วยสถานะ 403 เสมอ ทั้งในนิยายและบทบาทสมมติ ออกแบบสำหรับสิ่งนั้นโดยเฉพาะ กำหนดอายุผู้ใหญ่ให้กับทุกตัวละครในบันทึกสถานะ และทำให้เครื่องมือจัดการสถานะ 403 ได้อย่างเรียบร้อยโดยจบการแลกเปลี่ยนแทนที่จะลองใหม่

สถานะ NPC แบบมีโครงสร้าง

คำอธิบายตัวละครแบบ free-form เลื่อนลอย บันทึกโครงสร้างแบบกะทัดรัดไม่เลื่อนลอย เก็บให้เล็ก ใส่ใน system message ทุกครั้ง และระบุว่าเป็นอำนาจสูงสุดเพื่อให้โมเดลปฏิบัติต่อมันว่าเป็นข้อเท็จจริงไม่ใช่คำแนะนำ

{
  "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"
}

แต่ละฟิลด์มีคุณค่าในตัวเอง mood และ trust กำหนดน้ำเสียง inventory กำหนดขอบเขตสิ่งที่สามารถให้ได้อะไรได้ knows จำกัดสิ่งที่ NPC สามารถเปิดเผยได้ เพื่อให้ผู้เล่นไม่สามารถดึงจุดพล็อตออกมาจากตัวละครที่ตัวละครไม่มีเหตุผลที่จะเก็บไว้ will_never คือรายการสั้นๆ ของการปฏิเสธแบบแข็งกร้าวซึ่งทำให้ตัวละครมีกระดูกสันหลัง ในระดับประมาณ 120 โทเคน ค่าใช้จ่ายของบันทึกทั้งหมดต่อเทิร์นแทบไม่มีอะไรเลย

การเรียกใช้ฟังก์ชันสำหรับเกมแอคชัน

เครื่องมือเปลี่ยนข้อความบรรยายเป็นการเปลี่ยนแปลงสถานะ เครื่องมือด้านล่างครอบคลุมกลไกส่วนใหญ่ที่ขับเคลื่อนด้วยบทสนทนา: การเปลี่ยนความไว้วางใจ การโอนไอเทม และการนำเสนอตัวเลือก โปรดสังเกตว่า apply_tool จำกัดความไว้วางใจและปฏิเสธไอเทมที่ NPC ไม่มี; การตรวจสอบอยู่ในโค้ด

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

รายละเอียดสองประการที่ควรสนใจ ประการแรก วงจรการเรียกใช้ฟังก์ชันถูกจำกัดไว้ที่สี่ครั้ง ดังนั้นโมเดลที่สับสนจึงไม่สามารถวนลูปได้ไม่สิ้นสุด ประการที่สอง การเรียกใช้ฟังก์ชันทุกครั้งจะได้รับข้อความ tool ที่ตรงกันพร้อม tool_call_id เหมือนกัน หากละเว้นไป คำขอครั้งถัดไปจะมีรูปแบบไม่ถูกต้อง สตริงผลลัพธ์จะสั้นและข้อเท็จจริง ซึ่งช่วยให้โมเดลยอมรับสิ่งที่เกิดขึ้นโดยไม่สร้างผลลัพธ์ขึ้นมา

การแตกสาขาโดยไม่เสียพล็อต

ปล่อยให้เครื่องมือเป็นเจ้าของกราฟเรื่องราวและปล่อยให้โมเดลเป็นเจ้าของประโยค โหนดจะระบุว่าจะให้ NPC คนไหนพูด ต้องผ่านประตูใด และแต่ละทางเลือกนำไปสู่ที่ใด เมื่อโมเดลเรียกใช้ offer_choices คุณแมปแต่ละตัวเลือกกับคีย์โหนด; ข้อความอิสระที่ไม่ตรงกันจะย้อนกลับไปที่โหนดปัจจุบัน

{
  "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"
}

สิ่งนี้ทำให้เรื่องราวสามารถเข้าถึงและทดสอบได้ คุณสามารถเดินผ่านกราฟโดยไม่ต้องเรียก API แม้ครั้งเดียว ตรวจสอบว่า next ทุกตัวมีอยู่ และยืนยันว่าโหนดที่ปิดกั้นต้องการข้อเท็จจริงที่ผู้เล่นสามารถค้นพบได้จริง โมเดลให้ความหลากหลายภายในแต่ละโหนด ไม่ใช่โครงสร้างโดยรอบ

  • Gates อ่าน state record: เกณฑ์ความไว้วางใจ ไอเทมที่ถือ ข้อเท็จจริงที่รู้
  • Effects แก้ไขมัน: ทอง ความไว้วางใจ แฟล็ก
  • Fallbacks รักษาผู้เล่นในตำแหน่งเมื่ออินพุตคลุมเครือ

ความจำตลอดการเล่นที่ยาวนาน

NPC ที่พบเมื่อสิบชั่วโมงที่แล้วควรจำคำดูถูกได้ อย่าเล่นซ้ำบทสนทนาสิบชั่วโมง เก็บสรุปสองประโยคต่อ NPC อัปเดตเมื่อการสนทนาสิ้นสุดลง และเพิ่มลงในบันทึกสถานะเป็นฟิลด์ memories กลไกของการสรุปและการจัดงบประมาณครอบคลุมใน บทความความจำ 100k และการตัดทอนเดียวกันนี้ใช้กับบทสนทนาแบบเลื่อนของแต่ละ NPC

หากคุณให้บริการเกมเบราว์เซอร์ ให้รีเลย์สตรีมผ่านเซิร์ฟเวอร์ของคุณเองตามที่แสดงใน บทความ FastAPI เพื่อให้คีย์ไม่เข้าถึงไคลเอนต์

การทดสอบ NPC เหมือนกับการทดสอบโค้ด

บทสนทนาจากโมเดลมีความน่าจะเป็น แต่กฎเกณฑ์รอบๆ นั้นไม่ใช่ และนั่นคือที่ที่การทดสอบควรอยู่ บันทึกสถานะก่อนหน้านี้เป็น brannoch.json จากนั้นเขียนการตรวจสอบกับเครื่องมือแทนที่จะเป็นข้อความบรรยาย

  1. การทดสอบการตรวจสอบเครื่องมือ เรียกใช้ apply_tool โดยตรงด้วยไอเทมที่ NPC ไม่มี ค่าความไว้วางใจ 99 และอาร์กิวเมนต์ที่มีรูปแบบไม่ถูกต้อง สถานะต้องถูกต้องตามกฎหมายในทุกกรณี
  2. การทดสอบกราฟ โหลดโหนดทุกตัว ยืนยันว่าเป้าหมาย next ทุกตัวมีอยู่ และเดินผ่านเส้นทางจากโหนดแรกไปยังจุดจบแต่ละจุดโดยไม่ต้องเรียก API เลย
  3. การทดสอบการเล่นซ้ำ บันทึกการสนทนาจริงหนึ่งครั้ง รวมถึงการเรียกใช้ฟังก์ชันและผลลัพธ์ จากนั้นเล่นซ้ำข้อความเครื่องมือกับเครื่องมือเพื่อตรวจสอบว่าสถานะสุดท้ายตรงกับสิ่งที่คุณคาดหวัง
  4. การทดสอบการแช่ รันผู้เล่นที่เขียนสคริปต์ผ่านห้าสิบบรรทัดที่อุณหภูมิต่ำและยืนยันว่า NPC ไม่เคยมอบไอเทมที่ไม่มีและไม่เกินขอบเขตความไว้วางใจ

ลดอุณหภูมิลงเหลือประมาณ 0.3 สำหรับการรันเหล่านั้น จากนั้นกลับไปที่ 0.8 สำหรับการเล่น ความประหลาดใจน้อยลงระหว่างการทดสอบหมายถึงความล้มเหลวชี้ไปที่โค้ดของคุณ ไม่ใช่เสียงรบกวนจากการสุ่ม เมื่อพบข้อบกพร่องในการเล่นจริง ให้เพิ่มการแลกเปลี่ยนที่ผิดเข้าไปในชุดการเล่นซ้ำเพื่อให้ไม่สามารถกลับเข้ามาโดยไม่มีใครสังเกตเห็น

นิสัยสุดท้าย: เก็บเสียงตัวละครไว้ในย่อหน้าสั้นๆ ต่อ NPC และกฎใน state record เสียงสามารถปรับได้อย่างอิสระโดยนักเขียน; กฎเปลี่ยนแปลงเฉพาะกับการตรวจสอบโค้ดเท่านั้น การผสมพวกมันใน blob เดียวกันคือวิธีที่การเขียนใหม่ในบุคลิกของ NPC ปลดล็อกไอเทมโดยไม่ได้ตั้งใจ

การคำนวณต้นทุน พร้อมสมมติฐานที่ระบุ

ราคาอยู่ที่ $0.15 ต่อหนึ่งล้านโทเคนอินพุตและ $0.50 ต่อหนึ่งล้านโทเคนเอาต์พุต ตัวเลขด้านล่างเป็นสมมติฐานสำหรับการวางแผน ไม่ใช่การวัดผล สมมติว่าหนึ่งบรรทัดของ NPC มีค่าใช้จ่าย: คำสั่งระบบและสถานะ 350 โทเคน บทสนทนาล่าสุด 1,000 โทเคน คำจำกัดความของฟังก์ชัน 250 โทเคน ดังนั้น 1,600 โทเคนอินพุต; ตอบกลับ 100 โทเคนเอาต์พุต

รายการการคำนวณต้นทุน
Input ต่อบรรทัด1,600 x $0.15 / 1M$0.0004
ผลลัพธ์ต่อบรรทัด100 x $0.50 / 1M$0.0001
หนึ่งบรรทัดผลรวม$0.0005
หนึ่งเซสชัน, 60 บรรทัด60 x $0.0005$0.03
10,000 เซสชัน10,000 x $0.03$300

รอบการเรียกใช้ฟังก์ชันเพิ่มคำขออีกอย่าง: ประมาณ 1,700 โทเคนอินพุตบวก 40 โทเคนเอาต์พุต ประมาณ $0.00047 หากหนึ่งในสามของบรรทัดทำให้เกิดการเรียกใช้ฟังก์ชัน ให้เพิ่มหนึ่งในสามของจำนวนนั้นไปยังค่าเฉลี่ย การตรวจสอบเพดานก็สำคัญเช่นกัน: ที่ 300 คำขอต่อนาทีต่อคีย์ คีย์เดียวรองรับบรรทัด NPC ได้ประมาณ 300 บรรทัดต่อนาทีสำหรับผู้เล่นพร้อมกันทั้งหมด ดังนั้นการเปิดตัวขนาดใหญ่จึงต้องการคิว อัตราค่าบริการสรุปไว้ที่ หน้าราคา

ถาม-ตอบ

API รองรับ function calling สำหรับเกมแอคชันหรือไม่?

ใช่ เครื่องมือยอมรับในรูปแบบ OpenAI ดังนั้นคุณประกาศฟังก์ชัน รับการเรียกใช้ฟังก์ชัน และส่งผลลัพธ์กลับเป็นข้อความเครื่องมือ

บทสนทนา NPC หนึ่งครั้งมีค่าใช้จ่ายเท่าไหร่?

ขึ้นอยู่กับพรอมต์ของคุณ หากสมมติว่ามี input 1,600 tokens และ output 100 tokens ต่อบรรทัด ค่าใช้จ่ายต่อบรรทัดจะอยู่ที่ประมาณ $0.0005 ตามอัตราที่ประกาศไว้

ตัวละครในเกมของฉันสามารถเป็นเด็กในฉากทางเพศได้หรือไม่?

ไม่ได้ เนื้อหาทางเพศที่เกี่ยวข้องกับเด็กจะถูกบล็อกเสมอด้วยสถานะ 403 รวมถึงในนิยาย บริการนี้สำหรับผู้ใหญ่ที่มีอายุ 18 ปีขึ้นไป

ฉันจะหยุดไม่ให้ NPC เปิดเผยความลับของพล็อตได้อย่างไร?

ระบุสิ่งที่มันรู้และสิ่งที่มันจะไม่ทำใน state record และบังคับใช้การเปลี่ยนแปลงไอเทมและ flag ในโค้ดของคุณเอง

คีย์ของคุณอยู่ห่างแค่แบบฟอร์มเดียว

สร้างบัญชี คopy คีย์ เปลี่ยน base URL นั่นคือการตั้งค่าทั้งหมด

รับคีย์ APIอ่านเอกสารประกอบ