TR ▾

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

Unfiltered AI

Geliştiriciler için ham, sansürsüz LLM API'si.

Unfiltered AIAPI anahtarı al

Unfiltered AI oyun NPC diyalogları ve interaktif kurgu için

Oyun otoritesini motor içinde tutun: her NPC'nin durumunu kaydedin, önerilen araç çağrılarını doğrulayın ve izin verilen hikaye geçişlerini koruyun. Bu kılavuz bu kuralları oluşturulan diyaloğa uygular ve token maliyetlerini nasıl tahmin edileceğini gösterir.

Unfiltered AI oyun NPC diyalogları ve interaktif kurgu için

Temel noktalar

  • Unfiltered AI gibi özel çıkarım sağlayıcıları, toplayıcı yönlendirmenin rastgeleliğinden kaçınarak tek bir modelde tutarlı sansürsüz davranış sunar.
  • OpenRouter gibi toplayıcılar birden fazla modele erişim sağlar ancak belirli model sürümüne bağlı olarak içerik filtrelerinin ne kadar sıkı uygulandığı değişebilir.
  • Unfiltered AI, 100k bağlam penceresine sahip özel donanımda açık ağırlıklı bir model kullanır ve fiyatı milyon token başına $0,15/$0,50'dir.
  • Sıkı NSFW veya rol yapma tutarlılığı için, özel bir sansürsüz LLM API'si, genel filtreleri aşmak için karmaşık istem mühendisliğine olan ihtiyacı ortadan kaldırır.

Kelimelerle çizilmiş oyun döngüsü

Bu diyagramı zihninizde tutun. Bir oyuncu satırı engine'e girer. Motor, bir istemi üç parçadan oluşturur: sabit talimatlar, NPC'nin mevcut durum kaydı ve yakın geçmiş diyalog. İstem modele gider. Model text ile, fonksiyon çağrıları ile veya her ikisiyle birlikte yanıt verir. Metin ekrana gider. Fonksiyon çağrıları motora geri döner; motor bunları doğrular, durum kaydını değiştirir ve modelin cümlesini tamamlaması için kısa bir sonuç dizesi döndürür. Ardından döngü oyuncuyu bekler.

Önemli özellik, motorun tek gerçeklik kaynağı olmasıdır. Model önerir; motor karar verir. Model bir karakterin anahtar verdiğini söyler ama fonksiyon çağırmazsa, anahtar envanterde kalır. Bu ayrım, kuralları olan bir oyuna oluşturulan diyalogların güvenli bir şekilde bağlanmasını sağlar. Aşağıdaki her şey bundan kaynaklanır.

Tüm istekler, https://api.unfilteredaiapi.com/v1 adresindeki standart chat-completions uç noktasını ve uncensored model kimliğini kullanır. Araçlar OpenAI fonksiyon çağırma formatını kullandığından, aynı kod resmi istemci kütüphaneleriyle de çalışır.

Kapsam ve yetişkinlere özel not

Olgun kitleler için interaktif kurgu meşru bir kullanımdır. Hizmet, kurgudaki yasal yetişkin içeriğini, karanlık temaları veya tartışmalı konuları reddetmez. 18 yaş ve üzeri yetişkinler içindir; oyununuz bunu mağaza sayfasında belirtmeli ve erişimi buna göre kısıtlamalıdır.

Bir satır sabittir: reşit olmayanlarla ilgili cinsel içerik, kurgu ve rol yapma dahil olmak üzere her zaman 403 hatasıyla engellenir. Bunu açıkça tasarlayın. Her karaktere durum kaydında yetişkin bir yaş verin ve motorun bir 403'ü, yeniden deneme yerine değişimi sonlandırarak zarif bir şekilde yönetmesini sağlayın.

Yapılandırılmış NPC durumu

Serbest biçimli karakter tanımları kayar. Kompakt bir yapılandırılmış kayıt kaymaz. Küçük tutun, her adımda sistem mesajına yerleştirin ve modeli bir öneri yerine gerçek olarak kabul etmesi için ona otoriter olarak etiketleyin.

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

Her alan yerini hak eder. mood ve trust tonu belirler. inventory ne verilebileceğini sınırlar. knows NPC'nin neyi ortaya çıkarabileceğini sınırlar, böylece oyuncular karakterin bir nedeni olmayan hikaye noktalarını çıkaramaz. will_never, karaktere bir omurga veren kesin reddetme listelerinin kısa bir halidir. Yaklaşık 120 token ile tüm kayıt, her adımda neredeyse hiçbir maliyete mal olmaz.

Oyun eylemleri için fonksiyon çağırma

Araçlar, düz metni durum değişikliklerine dönüştürür. Aşağıdaki üçü, çoğu diyalog odaklı mekanikleri kapsar: güveni değiştirme, öğe transferi ve seçenekler sunma. apply_tool'ün güveni sınırladığı ve NPC'nin sahip olmadığı öğeleri reddettiğine dikkat edin; doğrulama kodda yer alır.

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

İki ayrıntı dikkat gerektirir. Birincisi, araç çağrı turu dört ile sınırlıdır, böylece şaşkın bir model sonsuza kadar döngüye giremez. İkincisi, her araç çağması, aynı tool_call_id ile eşleşen bir tool mesajı alır; bunu atlayın ve bir sonraki istek hatalı olur. Sonuç dizeleri kısa ve gerçektir, bu da modelin yaşananları icat etmeden kabul etmesini sağlar.

Hikayeyi kaybetmeden dallanma

Motor hikâye grafiğini, model ise cümleleri yönetsin. Bir düğüm hangi NPC'nin konuştuğunu, hangi kapının geçileceğini ve her seçeneğin nereye gideceğini listeler. Model offer_choices çağrısı yaptığında, her seçeneği bir düğüm anahtarına eşlersiniz; eşleşmeyen serbest metin mevcut düğüme düşer.

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

Bu, anlatımın erişilebilir ve test edilebilir olmasını sağlar. API çağrısı yapmadan grafiği gezebilir, her next'in var olduğundan emin olabilir ve kapılı düğümlerin oyuncunun gerçekten keşfedebileceği gerçekleri gerektirdiğini doğrulayabilirsiniz. Model, her düğümün içinde çeşitlilik sağlar, etrafındaki yapıda değil.

  • Kapılar durum kaydını okur: güven eşikleri, tutulan öğeler, bilinen gerçekler.
  • Etkiler değiştirir: altın, güven, bayraklar.
  • Yedeklemeler girdi belirsiz olduğunda oyuncuyu yerinde tutar.

Uzun bir oyun oturumu boyunca hafıza

On saat önce tanışılan bir NPC, bir hakareti hala hatırlamalıdır. On saatlik diyalogları tekrar oynatmayın. Her NPC için iki cümlelik bir özet depolayın, konuşma bittiğinde güncelleyin ve bunu durum kaydına memories alanı olarak ekleyin. Özetleme ve bütçeleme mekanikleri 100k hafıza makalesinde ele alınmıştır ve aynı kısaltma, her NPC'nin kayan diyaloglarına da uygulanır.

Bir tarayıcı oyunu sunuyorsanız, anahtar istemciye ulaşmasın diye akışı kendi sunucunuz üzerinden aktarın; FastAPI makalesinde gösterildiği gibi.

NPC'leri kodu test ettiğiniz gibi test etme

Modelden gelen diyalog olasılıksaldır, ancak etrafındaki kurallar değildir ve işte testlerin buraya ait olduğu yer. Daha önceki durum kaydını brannoch.json olarak kaydedin, ardından düz metne değil, motora karşı kontroller yazın.

  1. Araç doğrulama testleri. NPC'nin sahip olmadığı bir öğeyle, 99 güven deltasıyla ve hatalı argümanlarla doğrudan apply_tool çağırın. Durum her durumda yasal kalmalıdır.
  2. Grafik testleri. Her düğümü yükleyin, her next hedefinin var olduğunu onaylayın ve API'yi hiç çağırmadan ilk düğümden her sona bir yol yürüyün.
  3. Tekrar oynatma testleri. Gerçek bir konuşmayı bir kez, araç çağrıları ve sonuçları dahil olmak üzere kaydedin, ardından son durumun beklentilerinizle eşleşip eşleşmediğini kontrol etmek için araç mesajlarını motora tekrar oynatın.
  4. Soak testleri. Düşük bir sıcaklıkta bir betikli oyuncuyu elli satır çalıştırın ve NPC'nin sahip olmadığı bir eşyayı asla vermediğinden ve güven sınırlarını aşmadığından emin olun.

Bu testler için sıcaklığı yaklaşık 0.3'e düşürün, ardından oynanış için 0.8'e geri dönün. Test sırasında daha az sürpriz olması, bir hatanın kodunuzdan kaynaklandığını gösterir, örnekleme gürültüsünden değil. Canlı oynanışta bir hata ortaya çıktığında, hatayı gözden kaçırmamak için sorumlu olan diyalogu tekrar setine ekleyin.

Son bir alışkanlık: karakter sesini her NPC için kısa bir paragrafta ve kuralları durum kaydında tutun. Ses, yazarlar tarafından özgürce ayarlanabilir; kurallar yalnızca kod incelemesiyle değiştirilir. Bunları tek bir yığında karıştırmak, bir NPC'nin kişiliğinin yeniden yazılmasının bir öğeyi yanlışlıkla açığa çıkarmasına neden olur.

Varsayımlar belirtilerek maliyet hesaplaması

Fiyatlar milyon giriş token başına $0,15 ve milyon çıkış token başına $0,50'dir. Aşağıdaki rakamlar ölçüm değil, planlama için varsayımlardır. Bir NPC satırının maliyetini şu şekilde varsayın: sistem talimatları ve durum 350 token, yakın diyalog 1.000 token, araç tanımları 250 token; yani 1.600 giriş token; yanıt 100 çıkış token.

ÖğeHesaplamaMaliyet
Satır başına giriş1.600 x $0,15 / 1M$0,0004
Satır başına çıktı100 x $0,50 / 1M$0,0001
Bir satırtoplam$0,0005
Bir oturum, 60 satır60 x $0,0005$0,03
10.000 oturum10.000 x $0,03$300

Bir araç çağrı turu ek bir istek ekler: yaklaşık 1.700 giriş token ve 40 çıkış, yaklaşık $0,00047. Satırların üçte birinin bir aracı tetiklediğini varsayarsak, ortalamaya bunun üçte birini ekleyin. Tavan kontrolleri de önemlidir: ana başına dakikada 300 istek ile, tek bir anahtar tüm eşzamanlı oyuncular için dakikada yaklaşık 300 NPC satırını destekler, bu nedenle büyük lansmanlar kuyruk yönetimi gerektirir. Hızlar fiyatlandırma sayfasında özetlenmiştir.

Sorular ve cevaplar

API, oyun eylemleri için fonksiyon çağırma desteği sağlıyor mu?

Evet. Araçlar OpenAI formatında kabul edilir; bu nedenle fonksiyonları tanımlarsınız, fonksiyon çağrıları alırsınız ve sonuçları araç mesajları olarak gönderirsiniz.

Bir NPC konuşması ne kadar tutar?

İstemlerinize bağlıdır. Satır başına 1.600 girdi ve 100 çıktı token varsayıldığında, yayımlanan oranlara göre bir satırın maliyeti yaklaşık $0,0005'tir.

Oyunumdaki karakterler cinsel sahnelerde reşit olmayanlar olabilir mi?

Hayır. Reşit olmayanlarla ilgili cinsel içerik her zaman 403 hatası ile engellenir; bu durum kurgusal içerikler için de geçerlidir. Hizmet 18 yaş ve üzeri yetişkinler içindir.

NPC'nin hikaye sırlarını ifşa etmesini nasıl engellerim?

Bildiği şeyleri ve asla yapmayacağı şeyleri durum kaydında listeleyin ve öğe ile bayrak değişikliklerini kendi kodunuzda uygulayın.

Anahtarınız tek bir formun uzağında

Bir hesap oluşturun, anahtarı kopyalayın ve temel URL'yi değiştirin. Kurulumun tamamı budur.

API anahtarını alBelgeleri oku