Unfiltered AI do dialogów NPC w grach i interaktywnej prozy
Pozostaw kontrolę nad grą w silniku: przechowuj stan każdego NPC, waliduj proponowane wywołania narzędzi i zachowaj dozwolone przejścia fabularne. Ten przewodnik stosuje te zasady do wygenerowanych dialogów i pokazuje, jak oszacować koszty tokenów.

ZaktualizowanoUnfiltered AI
Kluczowe punkty
- Dedykowani dostawcy inferencji, tacy jak Unfiltered AI, oferują spójne zachowanie bez cenzury na jednym modelu, unikając losowości routingu agregatorów.
- Agregatory, takie jak OpenRouter, zapewniają dostęp do wielu modeli, ale mogą różnić się pod względem ścisłości stosowania filtrów treści w zależności od konkretnej wersji modelu.
- Unfiltered AI używa modelu o otwartych wagach na dedykowanym sprzęcie z oknem kontekstu 100k tokenów, wycenionym na $0,15/$0,50 za milion tokenów.
- Dla ścisłej zgodności z NSFW lub rolą, dedykowane API LLM bez cenzury eliminuje potrzebę złożonego inżynierii promptów do omijania ogólnych filtrów.
Pętla gry opisana słowami
Zapamiętaj ten diagram. linia gracza wpada do engine. Silnik komponuje prompt z trzech części: stałych instrukcji, bieżącego rejestr stanu NPC oraz ostatniej rozmowy. Prompt trafia do modelu. Model odpowiada tekstem text, wywołaniami narzędzi lub jednym i drugim. Tekst trafia na ekran. Wywołania narzędzi wracają do silnika, który je waliduje, modyfikuje rejestr stanu i zwraca krótki ciąg wyników, aby model mógł dokończyć zdanie. Następnie pętla czeka na gracza.
Kluczową cechą jest to, że silnik jest jedynym źródłem prawdy. Model proponuje, silnik decyduje. Jeśli model stwierdzi, że postać przekazuje klucz, ale nie wywoła narzędzia, klucz pozostaje w ekwipunku. To rozdzielenie sprawia, że wygenerowana dialogowość jest bezpieczna do podpięcia pod grę z regułami. Wszystko poniżej z tego wynika.
Wszystkie zapytania używają standardowego endpointu chat-completions w https://api.unfilteredaiapi.com/v1 z identyfikatorem modelu uncensored. Narzędzia używają formatu wywoływania funkcji OpenAI, więc ten sam kod działa z oficjalnymi bibliotekami klienckimi.
Zakres i uwaga dla dorosłych
Interaktywna powieść dla dorosłych to uzasadniony przypadek użycia. Usługa nie odrzuca legalnej treści dla dorosłych, mrocznych motywów ani kontrowersyjnych tematów w fikcji. Jest przeznaczona dla osób pełnoletnich (18+), a Twoja gra powinna o tym informować na stronie sklepu i odpowiednio ograniczać dostęp.
Jedna linia jest stała: treści seksualne z udziałem małoletnich są zawsze blokowane kodem 403, zarówno w fikcji, jak i w roleplay. Zaprojektuj to wprost. Nadaj każdej postaci pełnoletni wiek w rejestrze stanu, a silnik powinien obsłużyć błąd 403 gracefulnie, kończąc wymianę zamiast ponawiać próbę.
Ustrukturyzowany stan NPC
Opisy postaci w formie swobodnej ulegają rozmyciu. Kompaktowy rekord ustrukturyzowany nie. Trzymaj go małym, umieszczaj w wiadomości systemowej przy każdej turze i oznacz jako autorytatywny, aby model traktował go jako fakt, a nie sugestię.
{
"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"
}Każde pole zasługuje na swoje miejsce. mood i trust sterują tonem. inventory ogranicza to, co można przekazać. knows ogranicza to, co NPC może ujawnić, więc gracze nie mogą wyciągnąć punktów fabularnych, których postać nie ma powodu trzymać. will_never to krótka lista twardych odmów, które nadają postaci charakter. Przy około 120 tokenach cały rejestr kosztuje niemal nic za turę.
Wywoływanie narzędzi do akcji w grze
Narzędzia zamieniają prozę w zmiany stanu. Poniższe trzy pokrywają większość mechanik napędzanych dialogiem: zmianę zaufania, transfer przedmiotu i prezentację wyborów. Zauważ, że apply_tool ogranicza zaufanie i odrzuca przedmioty, których NPC nie trzyma; walidacja jest w kodzie.
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."))Warte uwagi są dwa szczegóły. Po pierwsze, rundy wywołań narzędzi są ograniczone do czterech, więc zdezorientowany model nie może zapętlać się w nieskończoność. Po drugie, każde wywołanie narzędzia otrzymuje pasującą wiadomość tool z tym samym tool_call_id; pominięcie tego sprawi, że kolejne zapytanie będzie błędnie sformatowane. Ciągi wyników są krótkie i faktograficzne, co pozwala modelowi potwierdzić, co się stało, bez wynajdowania konsekwencji.
Gałęziowanie bez utraty fabuły
Pozwól silnikowi przejąć kontrolę nad grafem fabularnym, a modelowi nadzierać się nad zdaniami. Węzeł wskazuje, który NPC mówi, jaka brama musi zostać otwarta i gdzie prowadzi każdy wybór. Gdy model wywoła offer_choices, mapujesz każdą opcję na klucz węzła; niespójny tekst wolny wraca do bieżącego węzła.
{
"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"
}To sprawia, że narracja jest osiągalna i testowalna. Możesz przejść przez graf bez żadnego wywołania API, sprawdzić, czy każdy next istnieje, i potwierdzić, że węzły z bramą wymagają faktów, które gracz faktycznie może odkryć. Model dostarcza różnorodności wewnątrz każdego węzła, a nie struktury wokół niego.
- Bramy odczytują rekord stanu: progi zaufania, posiadane przedmioty, znane fakty.
- Efekty go modyfikują: złoto, zaufanie, flagi.
- Fallbacki utrzymują gracza w miejscu, gdy input jest niejednoznaczny.
Pamięć przez długą rozgrywkę
NPC poznany 10 godzin temu powinien pamiętać obrażenie. Nie odtwarzaj 10 godzin dialogów. Zapisz streszczenie w dwóch zdaniach dla każdego NPC, aktualizuj je po zakończeniu rozmowy i dodaj do rejestru stanu jako pole memories. Mechaniki podsumowywania i budżetowania opisano w artykule o pamięci 100k, a to samo przycinanie dotyczy toczącej się rozmowy każdego NPC.
Jeśli obsługujesz grę przeglądarkową, przekaż strumień przez własny serwer, jak w artykule FastAPI, aby klucz nigdy nie dotarł do klienta.
Testowanie NPC jak kodu
Dialogi z modelu są probabilistyczne, ale reguły wokół nich nie są, i tam należą testy. Zapisz rejestr stanu z poprzedniej sesji jako brannoch.json, a następnie napisz sprawdzenia względem silnika, a nie względem prozy.
- Testy walidacji narzędzi. Wywołaj
apply_toolbezpośrednio z przedmiotem, którego NPC nie trzyma, delta zaufania 99 i błędnie sformatowanymi argumentami. Stan musi pozostać poprawny w każdym przypadku. - Testy grafu. Załaduj każdy węzeł, potwierdź, że każdy cel
nextistnieje, i przejdź ścieżkę od pierwszego węzła do każdego zakończenia bez wywoływania API. - Testy powtórki. Zapisz prawdziwą rozmowę raz, wraz z wywołaniami narzędzi i wynikami, a następnie odtwierz wiadomości narzędzi względem silnika, aby sprawdzić, czy końcowy stan odpowiada temu, czego oczekujesz.
- Testy obciążeniowe. Uruchom zdefiniowanego gracza przez pięćdziesiąt linii przy niskiej temperaturze i upewnij się, że NPC nigdy nie daje przedmiotu, którego nie posiada, i nigdy nie przekracza granic zaufania.
Obniż temperaturę do około 0,3 dla tych uruchomień, a następnie wróć do 0,8 podczas rozgrywki. Mniej niespodzianek podczas testowania oznacza, że awaria wskazuje na Twój kod, a nie na szum próbkowania. Gdy błąd pojawi się w rozgrywce na żywo, dodaj sporną wymianę do zbioru powtórek, aby nie uciekła uwadze.
Ostatni nawyk: trzymaj głos postaci w jednym krótkim akapicie na NPC, a reguły w rejestrze stanu. Głos można swobodnie stroić przez autorów; reguły zmienia się tylko po przeglądaniu kodu. Mieszanie ich w jednym bloku to sposób, w którym przepisanie osobowości NPC przypadkowo odblokowuje przedmiot.
Matematyka kosztów z podanymi założeniami
Ceny to 0,15 USD za milion tokenów wejściowych i 0,50 USD za milion tokenów wyjściowych. Poniższe liczby to założenia do planowania, a nie pomiary. Załóż, że jedna linia NPC kosztuje: instrukcje systemowe i stan 350 tokenów, ostatnia rozmowa 1000 tokenów, definicje narzędzi 250 tokenów, więc 1600 tokenów wejściowych; odpowiedź 100 tokenów wyjściowych.
| Pozycja | Obliczenie | Koszt |
|---|---|---|
| Wejście na linię | 1600 x 0,15 USD / 1M | $0,0004 |
| Wynik na linię | 100 x 0,50 USD / 1M | $0,0001 |
| Jeden wiersz | suma | $0,0005 |
| Jedna sesja, 60 wierszy | 60 × $0,0005 | $0,03 |
| 10 000 sesji | 10 000 × $0,03 | $300 |
Runda wywołania narzędzia dodaje kolejne zapytanie: około 1700 tokenów wejściowych plus 40 wyjściowych, około 0,00047 USD. Jeśli jedna linia na trzy wywoła narzędzie, dodaj jedną trzecią tej kwoty do średniej. Ważne są też limity: przy 300 zapytaniach na minutę na klucz, jeden klucz obsługuje około 300 linii NPC na minutę dla wszystkich współbieżnych graczy, więc duże premiery wymagają kolejkowania. Stawki podsumowano na stronie z cenami.
Pytania i odpowiedzi
Czy API obsługuje wywoływanie funkcji dla akcji w grze?
Tak. Narzędzia są akceptowane w formacie OpenAI, więc deklarujesz funkcje, otrzymujesz wywołania narzędzi i zwracasz wyniki jako komunikaty narzędzi.
Ile kosztuje rozmowa z NPC?
To zależy od twoich promptów. Przy założeniu 1 600 tokenów wejściowych i 100 tokenów wyjściowych na wiersz, jeden wiersz kosztuje około $0,0005 przy opublikowanych stawkach.
Czy postacie w mojej grze mogą być małoletnie w scenach seksualnych?
Nie. Treści seksualne z udziałem małoletnich są zawsze blokowane kodem 403, również w fikcji. Usługa przeznaczona jest dla osób pełnoletnich (18+).
Jak powstrzymać NPC przed ujawnianiem sekretów fabularnych?
Wymień w rekordzie stanu, co wie, a czego nigdy nie zrobi, oraz egzekwuj zmiany przedmiotów i flag we własnym kodzie.
Twój klucz jest o jeden formularz stąd
Utwórz konto, skopiuj klucz, zmień bazowy URL. To cała konfiguracja.