DE ▾

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

Unfiltered AI

Rohes, unzensiertes LLM-API für Entwickler.

Unfiltered AIAPI-Schlüssel erhalten

Unfiltered AI für NPC-Dialoge und interaktive Fiktion in Spielen

Behalte die Spielautorität in der Engine: Speichere den Zustand jedes NPCs, validiere vorgeschlagene Tool-Aufrufe und erhalte die erlaubten Story-Übergänge. Diese Anleitung wendet diese Regeln auf generierte Dialoge an und zeigt, wie man Token-Kosten abschätzt.

Unfiltered AI für NPC-Dialoge und interaktive Fiktion in Spielen

Wichtige Punkte

  • Dedizierte Inference-Anbieter wie Unfiltered AI bieten konsistentes unzensiertes Verhalten auf einem einzelnen Modell und vermeiden die Zufälligkeit von Aggregator-Routings.
  • Aggregatoren wie OpenRouter bieten Zugriff auf mehrere Modelle, können sich jedoch darin unterscheiden, wie streng sie Inhaltsfilter je nach spezifischer Modellversion anwenden.
  • Unfiltered AI verwendet ein Open-Weight-Modell auf dedizierter Hardware mit einem 100k-Kontextfenster, priced at $0,15/$0,50 pro Million Token.
  • Für strikte NSFW- oder Rollenspiel-Konsistenz eliminiert eine dedizierte unzensierte LLM-API die Notwendigkeit komplexer Prompt-Engineering-Methoden, um generische Filter zu umgehen.

Die Spielschleife, als Text dargestellt

Behalte diese Diagrammstruktur im Kopf. Eine Spielerzeile gelangt in die engine. Die Engine setzt einen Prompt aus drei Teilen zusammen: feste Anweisungen, der aktuelle Status des NPCs und der letzte Dialog. Der Prompt geht an das Modell. Das Modell antwortet mit text, mit Function Calls oder mit beidem. Text geht an den Bildschirm. Function Calls gehen zurück an die Engine, die sie validiert, den Status ändert und eine kurze Ergebniszeichenfolge zurückgibt, damit das Modell seinen Satz beenden kann. Dann wartet die Schleife auf den Spieler.

Die wichtige Eigenschaft ist, dass die Engine die einzige Quelle der Wahrheit ist. Das Modell schlägt vor; die Engine entscheidet. Wenn das Modell sagt, dass ein Charakter einen Schlüssel übergibt, aber keinen Tool Call ausführt, bleibt der Schlüssel im Inventar. Diese Trennung macht generierte Dialoge sicher für die Integration in ein Spiel mit Regeln. Alles Weitere ergibt sich daraus.

Alle Anfragen verwenden den Standard-Chat-Completions-Endpunkt unter https://api.unfilteredaiapi.com/v1 mit der Modell-ID uncensored. Tools verwenden das OpenAI-Funktion-Calling-Format, sodass derselbe Code mit den offiziellen Client-Bibliotheken funktioniert.

Umfang und ein Hinweis für Erwachsene

Interaktive Fiktion für ein erwachsenes Publikum ist eine legitime Nutzung. Der Dienst lehnt legale Erwachseneninhalte, dunkle Themen oder kontroverse Themen in der Fiktion nicht ab. Er ist für Erwachsene ab 18 Jahren gedacht, und dein Spiel sollte dies auf seiner Store-Seite angeben und den Zugang entsprechend beschränken.

Eine Zeile ist fest: Sexueller Inhalt mit Minderjährigen wird immer mit einem 403er blockiert, sowohl in der Fiktion als auch im Rollenspiel. Plane dies explizit. Gib jedem Charakter im Status ein Erwachsenenalter, und lass deine Engine einen 403er graceful abfangen, indem sie die Unterhaltung beendet, anstatt es erneut zu versuchen.

Strukturierter NPC-Status

Freiform-Charakterbeschreibungen driften ab. Ein kompakter strukturierter Status nicht. Halte ihn klein, setze ihn in die Systemnachricht bei jedem Durchlauf und kennzeichne ihn als autoritativ, damit das Modell ihn als Tatsache und nicht als Vorschlag behandelt.

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

Jedes Feld hat seinen Platz. mood und trust steuern den Ton. inventory begrenzt, was ausgegeben werden kann. knows begrenzt, was der NPC preisgeben kann, damit Spieler keine Handlungspunkte extrahieren können, die der Charakter nicht kennen sollte. will_never ist eine kurze Liste harter Ablehnungen, die dem Charakter eine Struktur gibt. Bei etwa 120 Token kostet der gesamte Status pro Durchlauf fast nichts.

Function Calling für Spielaktionen

Tools verwandeln Prosa in Statusänderungen. Die folgenden drei decken die meisten dialoggetriebenen Mechaniken ab: Vertrauensänderung, Item-Transfer und Auswahlmöglichkeiten. Beachte, dass apply_tool das Vertrauen begrenzt und Items ablehnt, die der NPC nicht hält; die Validierung liegt im Code.

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

Zwei Details sind erwähnenswert. Erstens sind Tool-Call-Runden auf vier begrenzt, damit ein verwirrtes Modell nicht endlos loopen kann. Zweitens erhält jeder Tool Call eine passende tool-Nachricht mit derselben tool_call_id; lass sie weg, und die nächste Anfrage ist fehlerhaft. Die Ergebniszeichenfolgen sind kurz und faktisch, was dem Modell ermöglicht, das Geschehene anzuerkennen, ohne Konsequenzen zu erfinden.

Verzweigungen ohne Plotverlust

Lass die Engine den Story-Graphen besitzen und das Modell die Sätze. Ein Knoten listet auf, welcher NPC spricht, welches Gate passiert werden muss und wohin jede Wahl führt. Wenn das Modell offer_choices aufruft, ordnest du jede Option einem Knotenschlüssel zu; nicht übereinstimmender Freitext fällt auf den aktuellen Knoten zurück.

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

Dies hält die Erzählung erreichbar und testbar. Du kannst den Graphen durchgehen, ohne eine einzige API-Anfrage zu stellen, prüfen, dass jeder next existiert, und bestätigen, dass gated Nodes Fakten erfordern, die der Spieler tatsächlich entdecken kann. Das Modell liefert Variation innerhalb jedes Knotens, nicht die Struktur darum herum.

  • Gates lesen den Status: Vertrauensschwellen, gehaltene Items, bekannte Fakten.
  • Effekte ändern ihn: Gold, Vertrauen, Flags.
  • Fallbacks halten den Spieler an seinem Platz, wenn die Eingabe mehrdeutig ist.

Gedächtnis über ein langes Spiel hinweg

Ein NPC, den du vor zehn Stunden getroffen hast, sollte sich noch an eine Beleidigung erinnern. Spiele nicht zehn Stunden Dialog ab. Speichere einen Zweisatz-Zusammenfassung pro NPC, aktualisiere ihn, wenn ein Gespräch endet, und füge ihn dem Status als memories-Feld hinzu. Die Mechaniken zum Zusammenfassen und Budgetieren werden in dem 100k-Gedächtnis-Artikel behandelt, und das gleiche Beschneiden gilt für den laufenden Dialog jedes NPCs.

Wenn du ein Browser-Spiel anbietest, leite den Stream über deinen eigenen Server weiter, wie in dem FastAPI-Artikel beschrieben, damit der Schlüssel nie den Client erreicht.

NPCs testen wie Code

Dialoge von einem Modell sind probabilistisch, aber die Regeln darum herum nicht, und genau dort gehören Tests hin. Speichere den Status von früher als brannoch.json und schreibe Tests gegen die Engine, nicht gegen die Prosa.

  1. Tool-Validierungstests. Rufe apply_tool direkt mit einem Item auf, das der NPC nicht hält, einem Vertrauensdelta von 99 und fehlerhaften Argumenten. Der Status muss in jedem Fall legal bleiben.
  2. Graph-Tests. Lade jeden Knoten, bestätige, dass jedes next-Ziel existiert, und gehe einen Pfad vom ersten Knoten zu jedem Ende, ohne die API aufzurufen.
  3. Replay-Tests. Zeichne ein echtes Gespräch einmal auf, einschließlich Tool Calls und Ergebnissen, und spiele die Tool-Nachrichten gegen die Engine ab, um zu prüfen, ob der Endstatus mit deinen Erwartungen übereinstimmt.
  4. Soak-Tests. Führe einen skriptgesteuerten Spieler bei niedriger Temperatur durch fünfzig Zeilen und stelle sicher, dass der NPC niemals einen Gegenstand ausgibt, den er nicht besitzt, und die Vertrauensgrenzen niemals überschreitet.

Setze die Temperatur für diese Tests auf etwa 0.3 und wechsle dann für das Spiel auf 0.8. Weniger Überraschungen beim Testen bedeuten, dass ein Fehler auf deinen Code und nicht auf Sampling-Rauschen zurückzuführen ist. Wenn ein Bug im Live-Spiel auftritt, füge die problematische Unterhaltung zur Replay-Datenbank hinzu, damit sie nicht unbemerkt wiederkehrt.

Eine letzte Gewohnheit: Halte die Charakterstimme in einem kurzen Absatz pro NPC und die Regeln im Status. Die Stimme kann von Autoren frei angepasst werden; Regeln werden nur mit einem Code-Review geändert. Sie in einem einzelnen Blob zu mischen, ist der Grund, warum das Umschreiben der Persönlichkeit eines NPCs versehentlich ein Item freischaltet.

Kostenberechnung mit angegebenen Annahmen

Die Preise liegen bei 0,25 US-Dollar pro Million Input-Token und 1,00 US-Dollar pro Million Output-Token. Die folgenden Zahlen sind Annahmen für die Planung, keine Messwerte. Nimm an, dass eine NPC-Zeile kostet: Systemanweisungen und Status 350 Token, letzter Dialog 1.000 Token, Tool-Definitionen 250 Token, also 1.600 Input-Token; Antwort 100 Output-Token.

ArtikelBerechnungKosten
Input pro Zeile1.600 × 0,15 $ / 1 Mio.$0,0004
Ausgabe pro Zeile100 x 0,50 US-Dollar / 1M$0,0001
Eine ZeileSumme$0,0005
Eine Sitzung, 60 Zeilen60 x 0,0005 US-Dollar$0,03
10.000 Sitzungen10.000 x 0,03 US-Dollar$300

Eine Tool-Aufruf-Rundreise fügt eine weitere Anfrage hinzu: etwa 1.700 Input-Token plus 40 Output-Token, ca. 0,00047 US-Dollar. Wenn jede dritte Zeile ein Tool auslöst, addiere ein Drittel dieses Betrags zum Durchschnitt. Obergrenzen-Checks sind ebenfalls wichtig: Bei 300 Anfragen pro Minute pro Schlüssel unterstützt ein einzelner Schlüssel etwa 300 NPC-Zeilen pro Minute über alle gleichzeitigen Spieler hinweg, daher benötigen große Releases eine Warteschlange. Die Raten sind auf der Preisübersichtsseite zusammengefasst.

Fragen und Antworten

Unterstützt die API Function Calling für Spielaktionen?

Ja. Tools werden im OpenAI-Format akzeptiert, sodass du Funktionen deklarierst, Tool-Calls erhältst und Ergebnisse als Tool-Nachrichten zurücksendest.

Wie viel kostet eine NPC-Konversation?

Das hängt von deinen Prompts ab. Bei angenommenen 1.600 Input-Token und 100 Output-Token pro Zeile kostet eine Zeile bei den veröffentlichten Preisen etwa 0,0005 $.

Können Charaktere in meinem Spiel Minderjährige in Sexszenen sein?

Nein. Sexueller Inhalt, der Minderjährige betrifft, wird immer mit einem 403-Status blockiert, auch in der Fiktion. Der Service ist für Erwachsene ab 18 Jahren.

Wie verhindere ich, dass NPCs Plot-Geheimnisse verraten?

Liste in der State-Aufzeichnung auf, was es weiß, und was es niemals tun wird, und erzwinge Änderungen an Items und Flags in deinem eigenen Code.

Dein Schlüssel ist nur ein Formular entfernt

Erstelle ein Konto, kopiere den Schlüssel und ändere die Base URL. Das ist die gesamte Einrichtung.

API-Schlüssel erhaltenLies die Dokumentation