IT ▾

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

Unfiltered AI

API LLM grezza, senza censura, pensata per gli sviluppatori.

Unfiltered AIOttieni la chiave API

Unfiltered AI per il dialogo degli NPC di gioco e la narrativa interattiva

Mantieni l'autorità di gioco nel motore: archivia lo stato di ogni NPC, convalida le chiamate di strumento proposte e preserva le transizioni narrative consentite. Questa guida applica quelle regole al dialogo generato e mostra come stimare i costi in token.

Unfiltered AI per il dialogo degli NPC di gioco e la narrativa interattiva

Punti chiave

  • Fornitori di inferenza dedicati come Unfiltered AI offrono un comportamento senza censura coerente su un singolo modello, evitando la casualità del routing degli aggregatori.
  • Gli aggregatori come OpenRouter forniscono accesso a più modelli ma possono variare nel modo in cui applicano rigorosamente i filtri sui contenuti a seconda della versione specifica del modello.
  • Unfiltered AI utilizza un modello a pesi aperti su hardware dedicato con una finestra di contesto di 100.000 token, al prezzo di $0,15/$0,50 per milione di token.
  • Per una coerenza rigorosa nei contenuti per adulti o nel roleplay, un'API LLM dedicata senza censura elimina la necessità di complesse tecniche di prompt engineering per aggirare i filtri generici.

Il ciclo di gioco, descritto a parole

Tieni a mente questo diagramma. Una riga del giocatore entra in engine. Il motore compone un prompt da tre parti: istruzioni fisse, lo stato corrente dell'NPC e il dialogo recente. Il prompt viene inviato al modello. Il modello risponde con text, con chiamate di strumenti, o con entrambi. Il testo va allo schermo. Le chiamate di strumenti tornano al motore, che le convalida, modifica lo stato e restituisce una stringa di risultato breve in modo che il modello possa completare la frase. Poi il ciclo attende il giocatore.

La proprietà importante è che il motore è l'unica fonte di verità. Il modello propone; il motore decide. Se il modello dice che un personaggio consegna una chiave ma non effettua mai la chiamata allo strumento, la chiave rimane nell'inventario. Questa separazione è ciò che rende il dialogo generato sicuro da integrare in un gioco con regole. Tutto quanto segue ne deriva.

Tutte le richieste utilizzano l'endpoint standard chat-completions a https://api.unfilteredaiapi.com/v1 con l'ID del modello uncensored. Gli strumenti utilizzano il formato di chiamata di funzioni di OpenAI, quindi lo stesso codice funziona con le librerie client ufficiali.

Ambito e nota per adulti

La narrativa interattiva per un pubblico maturo è un utilizzo legittimo. Il servizio non rifiuta contenuti adulti legali, temi oscuri o soggetti controversi nella narrativa. È destinato a maggiorenni di età superiore ai 18 anni e il tuo gioco dovrebbe dirlo sulla sua pagina dello store e limitare l'accesso di conseguenza.

Una riga è fissa: i contenuti sessuali che coinvolgono minori sono sempre bloccati con un 403, sia nella narrativa che nel roleplay. Progetta esplicitamente per questo. Assegna a ogni personaggio un'età adulta nel record di stato e fai in modo che il motore gestisca un 403 con grazia terminando lo scambio invece di riprovare.

Stato NPC strutturato

Le descrizioni dei personaggi a forma libera si allontanano. Un record strutturato compatto no. Tienilo piccolo, inseriscilo nel messaggio di sistema a ogni turno e etichettalo come autorevole in modo che il modello lo tratti come fatto piuttosto che come suggerimento.

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

Ogni campo guadagna il suo posto. mood e trust dirigono il tono. inventory delimita ciò che può essere dato. knows limita ciò che l'NPC può rivelare, quindi i giocatori non possono estrarre punti trama che il personaggio non ha motivo di detenere. will_never è un breve elenco di rifiuti rigidi che danno alla personaggio una spina dorsale. A circa 120 token, l'intero record costa quasi nulla per turno.

Chiamate di funzioni per le azioni di gioco

Gli strumenti trasformano la prosa in modifiche allo stato. I tre seguenti coprono la maggior parte delle meccaniche guidate dal dialogo: spostare la fiducia, trasferire un elemento e presentare scelte. Nota che apply_tool limita la fiducia e rifiuta gli elementi che l'NPC non possiede; la convalida risiede nel codice.

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

Due dettagli meritano attenzione. In primo luogo, i round di chiamata agli strumenti sono limitati a quattro, quindi un modello confuso non può andare in loop all'infinito. In secondo luogo, ogni chiamata di strumento riceve un messaggio tool corrispondente con lo stesso tool_call_id; ometterlo rende la richiesta successiva non valida. Le stringhe di risultato sono brevi e fattuali, il che permette al modello di riconoscere ciò che è accaduto senza inventare conseguenze.

Ramificazioni senza perdere la trama

Lascia che il motore gestisca il grafo della storia e che il modello gestisca le frasi. Un nodo elenca chi parla tra gli NPC, quale gate deve essere superato e dove porta ogni scelta. Quando il modello chiama offer_choices, mapphi ogni opzione a una chiave di nodo; il testo libero non corrispondente torna al nodo corrente.

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

Questo mantiene la narrativa raggiungibile e testabile. Puoi attraversare il grafico senza una singola chiamata API, verificare che ogni next esista e confermare che i nodi protetti richiedono fatti che il giocatore può effettivamente scoprire. Il modello fornisce varietà all'interno di ogni nodo, non la struttura che lo circonda.

  • I gate leggono il record di stato: soglie di fiducia, elementi posseduti, fatti noti.
  • Gli effetti lo modificano: oro, fiducia, flag.
  • I fallback mantengono il giocatore in posizione quando l'input è ambiguo.

Memoria durante una lunga sessione di gioco

Un NPC incontrato dieci ore fa dovrebbe ancora ricordare un insulto. Non ripetere dieci ore di dialogo. Memorizza un riassunto di due frasi per ogni NPC, aggiornalo alla fine di una conversazione e aggiungilo allo stato come campo memories. Le meccaniche di riassunto e di budgeting sono trattate in l'articolo sulla memoria da 100k, e lo stesso ritaglio si applica al dialogo rotante di ogni NPC.

Se servi un gioco nel browser, instrada lo stream attraverso il tuo server come in l'articolo FastAPI in modo che la chiave non raggiunga mai il client.

Testare gli NPC come testi il codice

Il dialogo da un modello è probabilistico, ma le regole che lo circondano non lo sono, ed è lì che appartengono i test. Salva il record di stato precedente come brannoch.json, quindi scrivi controlli contro il motore piuttosto che contro la prosa.

  1. Test di convalida degli strumenti. Chiama direttamente apply_tool con un oggetto che l'NPC non possiede, un delta di fiducia di 99 e argomenti non validi. Lo stato deve rimanere legale in ogni caso.
  2. Test del grafico. Carica ogni nodo, conferma che ogni bersaglio next esiste e percorri un percorso dal primo nodo a ogni fine senza chiamare l'API affatto.
  3. Test di ripetizione. Registra una conversazione reale una volta, incluse chiamate di strumenti e risultati, quindi riproduci i messaggi degli strumenti contro il motore per verificare che lo stato finale corrisponda a ciò che ti aspetti.
  4. Test di carico prolungato. Esegui un giocatore scriptato attraverso cinquanta righe a una temperatura bassa e verifica che l'NPC non consegni mai un oggetto che non possiede e non superi mai i limiti di fiducia.

Abbassa la temperatura a circa 0,3 per quelle esecuzioni, poi torna a 0,8 per il gioco. Men sorprese durante i test significano che un errore punta al tuo codice, non al rumore di campionamento. Quando compare un bug nel gioco live, aggiungi lo scambio colpevole all'insieme di riproduzione in modo che non possa tornare inosservato.

Un'ultima abitudine: mantieni la voce del personaggio in un breve paragrafo per NPC e le regole nel record di stato. La voce può essere sintonizzata liberamente dagli scrittori; le regole vengono modificate solo con una revisione del codice. Mescolarle in un unico blob è il modo in cui la riscrittura della personalità di un NPC sblocca accidentalmente un elemento.

Calcolo dei costi, con assunzioni dichiarate

I prezzi sono $0,15 per milione di token di input e $0,50 per milione di token di output. Le cifre seguenti sono assunzioni per la pianificazione, non misurazioni. Supponi che una riga di NPC costi: istruzioni di sistema e stato 350 token, dialogo recente 1.000 token, definizioni di strumento 250 token, per un totale di 1.600 token di input; risposta 100 token di output.

ElementoCalcoloCosto
Input per riga1.600 × $0,15 / 1M$0,0004
Output per riga100 × $0,50 / 1M$0,0001
Una rigasomma$0,0005
Una sessione, 60 righe60 × $0,0005$0,03
10.000 sessioni10.000 × $0,03$300

Un round trip di chiamata di strumento aggiunge un'altra richiesta: circa 1.700 token di input più 40 di output, circa $0,00047. Se una riga su tre innesca una chiamata di strumento, aggiungi un terzo di quella alla media. Anche i controlli del tetto sono importanti: a 300 richieste al minuto per chiave, una singola chiave supporta circa 300 righe di NPC al minuto tra tutti i giocatori concorrenti, quindi i grandi lanci richiedono code. I tassi sono riassunti nella pagina dei prezzi.

Domande e risposte

L'API supporta la chiamata di funzioni per le azioni di gioco?

Sì. I tool sono accettati nel formato OpenAI, quindi dichiari le funzioni, ricevi le chiamate di tool e invii i risultati indietro come messaggi di tool.

Quanto costa una conversazione NPC?

Dipende dai tuoi prompt. Con l'assunzione di 1.600 token di input e 100 di output per riga, una riga costa circa $0,0005 ai prezzi pubblicati.

I personaggi del mio gioco possono essere minorenni nelle scene sessuali?

No. I contenuti sessuali che coinvolgono minorenni sono sempre bloccati con un 403, anche nella narrativa. Il servizio è destinato a maggiorenni di età superiore ai 18 anni.

Come faccio a impedire che l'NPC riveli i segreti della trama?

Elenca ciò che sa e ciò che non farà mai nel record di stato, ed enforcement delle modifiche a oggetti e flag nel tuo codice.

La tua chiave è a un modulo di distanza

Crea un account, copia la chiave, modifica il base URL. È tutta la configurazione.

Ottieni la chiave APILeggi la documentazione