JA ▾

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

Unfiltered AI

開発者向け、無検閲のLLM API

Unfiltered AIAPI キーを取得

ゲームNPC対話とインタラクティブフィクション用Unfiltered AI

ゲームの権限はエンジンに保持してください:各NPCの状態を保存し、提案されたツール呼び出しを検証し、許可されたストーリー遷移を維持します。このガイドでは、生成された対話にこれらのルールを適用し、トークンコストの見積もり方法を説明します。

ゲームNPC対話とインタラクティブフィクション用Unfiltered AI

Key points

  • Unfiltered AIのような専用推論プロバイダーは、単一モデルで一貫した無検閲の動作を提供し、アグリゲーターのルーティングによるランダム性を回避します。
  • OpenRouterのようなアグリゲーターは複数のモデルへのアクセスを提供しますが、特定のモデルバージョンに応じてコンテンツフィルターの適用厳格さが異なる場合があります。
  • Unfiltered AIは100kのコンテキストウィンドウを持つオープンウェイトモデルを専用ハードウェアで実行し、100万トークンあたり$0.15/$0.50で提供されます。
  • 厳格なNSFWやロールプレイの一貫性には、専用無検閲LLM APIを使用することで、汎用フィルターを回避するための複雑なプロンプトエンジニアリングが不要になります。

言葉で描くゲームループ

この図を頭に入れてください。プレイヤーの行がengineに入力されます。エンジンは3つの部分からプロンプトを構成します:固定指示、NPCの現在のステートレコード、および直近の対話です。プロンプトはモデルに送信されます。モデルはtext、ツール呼び出し、またはその両方を返します。テキストは画面に表示され、ツール呼び出しはエンジンに戻されます。エンジンはそれらを検証し、ステートレコードを変更し、モデルが文を完成させられるよう短い結果文字列を返します。その後ループはプレイヤーの入力を待ちます。

重要な特性は、エンジンが唯一の真実の源であることです。モデルは提案し、エンジンが決定します。モデルがキャラクターが鍵を渡すと述べてもツールを呼び出さなければ、鍵はインベントリに残ったままになります。この分離こそが、ルール付きゲームに生成された対話を安全に接続可能にするものです。以下のすべてはこれに基づきます。

すべてのリクエストは、モデルIDuncensoredを用いて標準チャット完了エンドポイントhttps://api.unfilteredaiapi.com/v1を使用します。ツールはOpenAI関数呼び出し形式を使用するため、公式クライアントライブラリと同じコードが機能します。

スコープと成人向けに関する注意書き

大人向けインタラクティブフィクションは正当な用途です。本サービスは、法的な大人向けコンテンツ、ダークなテーマ、またはフィクション内の論争的な主題を拒否しません。これは18歳以上の成人向けであり、ゲームはストアページでそれを明記し、アクセスを制限すべきです。

1行は固定です:未成年を伴う性的コンテンツは、フィクションでもロールプレイでも常に403でブロックされます。これを明示的に設計してください。ステートレコードで各キャラクターに成人の年齢を与え、エンジンが403を適切に処理し(再試行ではなく終了)、対話を終了するようにしてください。

Structured NPC state

自由形式のキャラクター説明は曖昧になります。コンパクトな構造化レコードはそうではありません。小さく保ち、すべてのターンでシステムメッセージに配置し、それを権威あるものとしてラベル付けし、モデルがそれを提案ではなく事実として扱うようにしてください。

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

各フィールドは存在理由があります。moodとtrustはトーンを制御します。inventoryは与えられるものを制限します。knowsはNPCが明らかにできる情報を制限し、プレイヤーがキャラクターが理由を持っていないプロットポイントを引き出せないようにします。will_neverは、キャラクターに骨格を与える堅固な拒否の短いリストです。約120トークンのこのレコード全体は、1ターンあたりのコストはほぼゼロです。

ゲームアクションのツール呼び出し

ツールは文章を状態変更に変換します。以下の3つは、対話駆動型のメカニニクスの大部分をカバーします:信頼のシフト、アイテムの移動、選択肢の提示です。apply_toolが信頼を制限し、NPCが持っていないアイテムを拒否することに注意してください。検証はコード内にあります。

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

注目すべき点が2つあります。まず、ツール呼び出しのラウンドは最大4回に制限されているため、混乱したモデルが無限ループに陥ることはありません。次に、すべてのツール呼び出しには、同じtoolメッセージと一致するtool_call_idが必要です。これを省略すると、次のリクエストが不正な形式になります。結果文字列は短く事実的であるため、モデルは結果を創作することなく、何が起こったかを認識できます。

プロットを失わない分岐

ストーリーグラフをエンジンが所有させ、文章をモデルが所有させます。ノードはどのNPCが話すか、通過する必要があるゲート、および各選択肢がどこに繋がるかをリストします。モデルがoffer_choicesを呼び出すと、各オプションをノードキーにマッピングします。一致しない自由テキストは現在のノードにフォールバックします。

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

これにより、物語は到達可能かつテスト可能になります。API呼び出しなしでグラフをトレースでき、すべてのnextが存在することを確認し、ゲート付きノードがプレイヤーが実際に発見できる事実を必要とすることを確認できます。モデルは構造そのものではなく、各ノード内の多様性を提供します。

  • ゲートはステートレコードを読み取ります:信頼の閾値、所持アイテム、既知の事実。
  • エフェクトはそれを変更します:ゴールド、信頼、フラグ。
  • フォールバックは、入力が曖昧な場合にプレイヤーをその場に留めます。

長期プレイスルーでの記憶

10時間前に会ったNPCは、まだ侮辱を記憶しているはずです。10時間のダイアログを再生しないでください。NPCごとに2文の要約を保存し、会話が終了したときに更新し、それを状態レコードのmemoriesフィールドとして追加します。要約と予算のメカニクスは100kの記憶に関する記事でカバーされており、同じ削減が各NPCのローリングダイアログにも適用されます。

ブラウザゲームを提供する場合は、FastAPI記事にあるように、キーがクライアントに到達しないよう、ストリームを自前のサーバー経由でリレーしてください。

コードと同様にNPCをテストする

モデルからの対話は確率的ですが、それを取り巻くルールはそうではなく、テストはそこに属します。以前の状態レコードをbrannoch.jsonとして保存し、文章に対してではなくエンジンに対してチェックを書いてください。

  1. ツール検証テスト。NPCが持っていないアイテム、信頼度の変化99、および不正な引数でapply_toolを直接呼び出します。すべてのケースで状態が妥当である必要があります。
  2. グラフテスト。 すべてのノードを読み込み、各nextターゲットが存在することを確認し、APIを一切呼び出さずに最初のノードから各エンドポイントへのパスをトレースします。
  3. リプレイテスト。 実際の会話を1回記録し(ツール呼び出しと結果を含む)、その後ツールメッセージをエンジンにリプレイして、最終状態が期待どおりであることを確認します。
  4. ソークテスト。スクリプト化されたプレイヤーを低い温度で50行実行し、NPCが持っていないアイテムを絶対に与えず、信頼の境界を絶対に超えないことをアサートします。

それらの実行では温度を約0.3に下げ、プレイでは0.8に戻します。テスト中の予期せぬことが少ないほど、失敗はあなたのコードを指し、サンプリングノイズを指しません。バグが実際のプレイで発生した場合、問題のあるやり取りを再生セットに追加し、見逃されないようにします。

最後の習慣:NPCごとに1つの短い段落でキャラクターの声を保ち、ルールを状態レコードに保つことです。声はライターが自由に調整できますが、ルールはコードレビューでのみ変更されます。これらを単一の塊に混ぜると、NPCの性格の書き換えが偶然アイテムをアンロックすることがあります。

前提を明示したコスト計算

価格は100万入力トークンあたり$0.15、100万出力トークンあたり$0.50です。以下の数字は測定値ではなく、計画のための仮定です。NPCの1行あたりのコストは次のように仮定します:システム指示と状態350トークン、最近のダイアログ1,000トークン、ツール定義250トークン、つまり1,600入力トークン;返信100出力トークン。

ItemCalculationCost
1行あたりの入力1,600 x $0.15 / 1M$0.0004
1行あたりの出力100 x $0.50 / 1M$0.0001
1行合計$0.0005
1セッション、60行60 x $0.0005$0.03
10,000セッション10,000 x $0.03$300

ツール呼び出しの往復は別のリクエストを追加します:約1,700入力トークンと40出力、約$0.00047。3行に1行がツールをトリガーする場合、平均にその3分の1を追加します。上限チェックも重要です:キーあたり1分あたり300リクエストの場合、単一のキーはすべての同時プレイヤーにわたって1分あたり約300のNPC行をサポートするため、大規模なローンチにはキューイングが必要です。レートは料金ページに要約されています。

質問と回答

APIはゲームアクションの関数呼び出しに対応していますか?

はい。ツールはOpenAI形式で受け入れられるため、関数を宣言し、ツール呼び出しを受け取り、結果をツールメッセージとして送信できます。

NPCの会話にはどのくらいの費用がかかりますか?

プロンプトによります。1行あたり1,600入力トークンと100出力トークンを想定すると、公開レートでは1行あたり約$0.0005がかかります。

ゲーム内のキャラクターが性的なシーンで未成年でも問題ありませんか?

いいえ。未成年を伴う性的コンテンツは、フィクションであっても常に403エラーでブロックされます。本サービスは18歳以上の成人向けです。

NPCがプロットの秘密を漏らさないようにするには?

状態レコードに認識している情報と、絶対に実行しない事項をリスト化し、アイテムやフラグの変更は自前のコードで制御してください。

キーはフォーム 1 つで手に入ります

アカウントを作成し、キーをコピーし、ベースURLを変更します。これだけですべての設定が完了します。

APIキーを取得ドキュメントを読む