Unfiltered AI untuk dialog NPC game dan fiksi interaktif
Pertahankan otoritas game di mesin: simpan status setiap NPC, validasi panggilan alat yang diusulkan, dan pertahankan transisi cerita yang diizinkan. Panduan ini menerapkan aturan tersebut ke dialog yang dihasilkan dan menunjukkan cara memperkirakan biaya token.

DiperbaruiUnfiltered AI
Poin kunci
- Penyedia inferensi khusus seperti Unfiltered AI menawarkan perilaku tanpa sensor yang konsisten pada satu model, menghindari keacakan pengalihan agregator.
- Agregator seperti OpenRouter menyediakan akses ke beberapa model tetapi mungkin bervariasi dalam seberapa ketat mereka menerapkan filter konten tergantung pada versi model tertentu.
- Unfiltered AI menggunakan model bobot terbuka di perangkat keras khusus dengan jendela konteks 100k, dihargai $0,15/$0,50 per juta token.
- Untuk konsistensi NSFW atau roleplay yang ketat, API LLM tanpa sensor khusus menghilangkan kebutuhan rekayasa prompt kompleks untuk melewati filter umum.
Loop game, digambarkan dengan kata-kata
Pertahankan diagram ini dalam pikiran Anda. Garis pemain masuk ke engine. Mesin menyusun prompt dari tiga bagian: instruksi tetap, catatan keadaan NPC saat ini, dan dialog baru-baru ini. Prompt dikirim ke model. Model menjawab dengan text, dengan pemanggilan fungsi, atau dengan keduanya. Teks ditampilkan di layar. Pemanggilan fungsi kembali ke mesin, yang memvalidasinya, mengubah catatan keadaan, dan mengembalikan string hasil singkat agar model dapat menyelesaikan kalimatnya. Kemudian loop menunggu pemain.
Properti pentingnya adalah mesin adalah sumber kebenaran tunggal. Model mengusulkan; mesin memutuskan. Jika model mengatakan karakter menyerahkan kunci tetapi tidak pernah memanggil alat, kunci tetap ada di inventaris. Pemisahan inilah yang membuat dialog yang dihasilkan aman untuk dihubungkan ke game dengan aturan. Semua di bawah ini mengikuti dari itu.
Semua permintaan menggunakan endpoint chat-completions standar di https://api.unfilteredaiapi.com/v1 dengan id model uncensored. Alat menggunakan format pemanggilan fungsi OpenAI, sehingga kode yang sama berfungsi dengan pustaka klien resmi.
Lingkup dan catatan hanya untuk dewasa
Fiksi interaktif untuk audiens dewasa adalah penggunaan yang sah. Layanan tidak menolak konten dewasa yang sah, tema gelap, atau subjek kontroversial dalam fiksi. Ini dimaksudkan untuk orang dewasa berusia 18 tahun ke atas, dan game Anda harus mengatakannya di halaman toko dan membatasi akses sesuai.
Satu hal tetap: konten seksual yang melibatkan anak di bawah umur selalu diblokir dengan 403, baik dalam fiksi maupun roleplay. Rancanglah untuk itu secara eksplisit. Berikan setiap karakter usia dewasa dalam catatan status, dan buat mesin Anda menangani 403 dengan anggun dengan mengakhiri pertukaran daripada mencoba lagi.
Status NPC terstruktur
Deskripsi karakter bebas-formulir menyimpang. Catatan terstruktur yang ringkas tidak. Jaga agar tetap kecil, masukkan dalam pesan sistem pada setiap giliran, dan beri label otoritatif agar model memperlakukannya sebagai fakta daripada saran.
{
"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"
}Setiap bidang mendapatkan tempatnya. mood dan trust mengarahkan nada. inventory membatasi apa yang dapat diberikan. knows membatasi apa yang dapat diungkapkan NPC, sehingga pemain tidak dapat mengekstrak poin plot yang tidak ada alasan bagi karakter untuk diketahui. will_never adalah daftar penolakan keras yang memberikan karakter tulang punggung. Sekitar 120 token, seluruh catatan biayanya hampir tidak ada per giliran.
Pemanggilan fungsi untuk aksi game
Alat mengubah prosa menjadi perubahan status. Tiga di bawah ini mencakup sebagian besar mekanisme yang digerakkan dialog: menggeser kepercayaan, mentransfer item, dan menyajikan pilihan. Perhatikan bahwa apply_tool membatasi kepercayaan dan menolak item yang tidak dimiliki NPC; validasi ada di kode.
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."))Dua detail patut diperhatikan. Pertama, putaran pemanggilan fungsi dibatasi empat kali, sehingga model yang bingung tidak akan berputar terus menerus. Kedua, setiap pemanggilan fungsi mendapat pesan tool yang sesuai dengan tool_call_id yang sama; abaikan dan permintaan berikutnya akan tidak valid. String hasil pendek dan faktual, yang memungkinkan model mengakui apa yang terjadi tanpa menciptakan konsekuensi.
Percabangan tanpa kehilangan plot
Biarkan mesin memiliki grafik cerita dan biarkan model memiliki kalimat. Simpul mencantumkan NPC mana yang berbicara, gerbang mana yang harus dilewati, dan ke mana setiap pilihan mengarah. Ketika model memanggil offer_choices, Anda memetakan setiap opsi ke kunci simpul; teks bebas yang tidak cocok kembali ke simpul saat ini.
{
"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"
}Ini menjaga narasi dapat dijangkau dan diuji. Anda dapat berjalan di grafik tanpa panggilan API tunggal, periksa bahwa setiap next ada, dan konfirmasi bahwa simpul gerbang memerlukan fakta yang dapat ditemukan pemain. Model menyediakan variasi di dalam setiap simpul, bukan struktur di sekitarnya.
- Gerbang membaca catatan status: ambang kepercayaan, item yang dipegang, fakta yang diketahui.
- Efek memodifikasinya: emas, kepercayaan, flag.
- Fallback menjaga pemain di tempat ketika input ambigu.
Memori selama permainan panjang
NPC yang bertemu sepuluh jam lalu harus masih mengingat penghinaan. Jangan putar ulang sepuluh jam dialog. Simpan ringkasan dua kalimat per NPC, perbarui saat percakapan berakhir, dan tambahkan ke catatan status sebagai bidang memories. Mekanisme meringkas dan anggaran dibahas dalam artikel memori 100k, dan pemangkasan yang sama berlaku untuk dialog bergulir setiap NPC.
Jika Anda melayani game browser, alirkan stream melalui server Anda sendiri seperti di artikel FastAPI sehingga kunci tidak pernah mencapai klien.
Menguji NPC seperti cara Anda menguji kode
Dialog dari model bersifat probabilistik, tetapi aturan di sekitarnya tidak, dan di situlah pengujian berada. Simpan catatan status dari sebelumnya sebagai brannoch.json, lalu tulis pemeriksaan terhadap mesin daripada terhadap prosa.
- Pengujian validasi alat. Panggil
apply_toollangsung dengan item yang tidak dimiliki NPC, delta kepercayaan 99, dan argumen tidak valid. Status harus tetap legal dalam setiap kasus. - Uji grafik. Muat setiap simpul, konfirmasi setiap target
nextada, dan jalankan jalur dari simpul pertama ke setiap akhir tanpa memanggil API sama sekali. - Uji replay. Rekam percakapan nyata sekali, termasuk panggilan alat dan hasil, lalu putar ulang pesan alat terhadap mesin untuk memeriksa apakah status akhir sesuai dengan yang Anda harapkan.
- Uji soak. Jalankan pemain terskrip melalui lima puluh baris pada suhu rendah dan assert bahwa NPC tidak pernah memberikan item yang tidak dimilikinya dan tidak pernah melebihi batas kepercayaan.
Turunkan suhu menjadi sekitar 0,3 untuk putaran pengujian tersebut, lalu kembali ke 0,8 untuk bermain. Lebih sedikit kejutan saat pengujian berarti kegagalan menunjuk pada kode Anda, bukan pada noise sampling. Ketika bug muncul dalam permainan langsung, tambahkan pertukaran yang bersalah ke set replay agar tidak kembali tanpa disadari.
Kebiasaan terakhir: jaga suara karakter dalam satu paragraf singkat per NPC dan aturan dalam catatan status. Suara dapat disesuaikan secara bebas oleh penulis; aturan hanya diubah dengan tinjauan kode. Mencampurkannya dalam satu blob adalah bagaimana penulisan ulang kepribadian NPC secara tidak sengaja membuka item.
Perhitungan biaya, dengan asumsi yang dinyatakan
Harga adalah $0,15 per juta token input dan $0,50 per juta token output. Angka di bawah ini adalah asumsi untuk perencanaan, bukan pengukuran. Asumsikan satu baris NPC biayanya: instruksi sistem dan status 350 token, dialog terbaru 1.000 token, definisi alat 250 token, sehingga 1.600 token input; balasan 100 token output.
| Item | Perhitungan | Biaya |
|---|---|---|
| Input per baris | 1.600 x $0,15 / 1M | $0,0004 |
| Output per baris | 100 x $0,50 / 1M | $0,0001 |
| Satu baris | jumlah | $0,0005 |
| Satu sesi, 60 baris | 60 x $0,0005 | $0,03 |
| 10.000 sesi | 10.000 x $0,03 | $300 |
Perjalanan pulang pergi pemanggilan fungsi menambahkan permintaan lain: sekitar 1.700 token input plus 40 output, sekitar $0,00047. Jika satu dari tiga baris memicu alat, tambahkan sepertiga dari itu ke rata-rata. Pemeriksaan batas atas juga penting: pada 300 permintaan per menit per kunci, satu kunci mendukung sekitar 300 baris NPC per menit di seluruh pemain konkuren, sehingga peluncuran besar memerlukan antrian. Tingkat dirangkum di halaman harga.
Tanya jawab
Apakah API mendukung pemanggilan fungsi untuk tindakan game?
Ya. Alat diterima dalam format OpenAI, sehingga Anda mendeklarasikan fungsi, menerima pemanggilan fungsi, dan mengirim hasil kembali sebagai pesan alat.
Berapa biaya percakapan NPC?
Tergantung pada prompt Anda. Dengan asumsi 1.600 token input dan 100 token keluaran per baris, satu baris biaya sekitar $0,0005 pada tarif yang diterbitkan.
Apakah karakter dalam game saya bisa menjadi anak di bawah umur dalam adegan seksual?
Tidak. Konten seksual yang melibatkan anak di bawah umur selalu diblokir dengan 403, termasuk dalam fiksi. Layanan ini untuk orang dewasa berusia 18 tahun ke atas.
Bagaimana cara menghentikan NPC membocorkan rahasia plot?
Daftar apa yang diketahuinya dan apa yang tidak akan pernah dilakukannya dalam catatan status, dan terapkan perubahan item dan flag dalam kode Anda sendiri.
Kunci Anda hanya selangkah lagi dari satu formulir
Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh penyiapannya.