게임 NPC 대화 및 인터랙티브 픽션용 Unfiltered AI
게임의 권위는 엔진에 유지하세요: 각 NPC의 상태를 저장하고, 제안된 도구 호출을 검증하며, 허용된 스토리 전환을 보존하세요. 이 가이드는 이러한 규칙을 생성된 대화에 적용하고 토큰 비용 추산 방법을 보여줍니다.

업데이트됨Unfiltered AI
주요 사항
- Unfiltered AI과 같은 전용 추론 제공자는 단일 모델에서 일관된 무검열 동작을 제공하여 집계 라우팅의 무작위성을 피합니다.
- OpenRouter와 같은 집계기는 여러 모델에 대한 접근을 제공하지만, 특정 모델 버전에 따라 콘텐츠 필터 적용 엄격도가 다를 수 있습니다.
- Unfiltered AI은 100k 컨텍스트 창을 갖춘 전용 하드웨어에서 오픈 웨이트 모델을 사용하며, 토큰 백만 개당 $0.15/$0.50에 가격 책정됩니다.
- 엄격한 NSFW 또는 역할극 일관성을 위해 전용 무검열 LLM API는 일반 필터를 우회하기 위한 복잡한 프롬프트 엔지니어링의 필요성을 제거합니다.
단어로 그린 게임 루프
이 다이어그램을 머릿속에 그려보세요. 플레이어 줄이 engine로 들어옵니다. 엔진은 세 부분으로 프롬프트를 구성합니다: 고정 지시사항, NPC의 현재 상태 기록, 최근 대화입니다. 프롬프트가 모델로 전달됩니다. 모델은 text, 함수 호출 또는 둘 다를 포함하여 응답합니다. 텍스트는 화면으로 전달됩니다. 함수 호출은 엔진으로 다시 전달되며, 엔진은 이를 검증하고 상태 기록을 변경한 후 모델이 문장을 완성할 수 있도록 짧은 결과 문자열을 반환합니다. 그런 다음 루프는 플레이어의 다음 행동을 기다립니다.
중요한 속성은 엔진이 유일한 진실의 원천이라는 점입니다. 모델이 제안하면 엔진이 결정합니다. 모델이 캐릭터가 열쇠를 건넨다고 말하지만 도구를 호출하지 않으면, 열쇠는 인벤토리에 그대로 남아 있습니다. 이 분리 덕분에 생성된 대화가 규칙이 있는 게임에 안전하게 연결될 수 있습니다. 아래에 설명된 모든 내용은 이 사실에서 비롯됩니다.
모든 요청은 모델 ID uncensored와 함께 https://api.unfilteredaiapi.com/v1의 표준 chat-completions 엔드포인트를 사용합니다. 도구는 OpenAI 함수 호출 형식을 사용하므로 동일한 코드가 공식 클라이언트 라이브러리에서도 작동합니다.
범위 및 성인 전용 참고 사항
성인 대상 인터랙티브 픽션은 정당한 용도입니다. 이 서비스는 합법적인 성인 콘텐츠, 다크 테마 또는 논쟁적인 주제를 픽션에서 거부하지 않습니다. 이 서비스는 18세 이상 성인을 위한 것이며, 게임은 스토어 페이지에 이를 명시하고 그에 따라 접근을 제한해야 합니다.
한 줄은 고정되어 있습니다: 미성년자가 관련된 성적 콘텐츠는 픽션과 역할극 모두에서 403으로 항상 차단됩니다. 이를 명시적으로 설계하십시오. 상태 기록에서 모든 캐릭터에게 성인 나이를 부여하고, 엔진이 403을 재시도하지 않고 교환을 종료하는 방식으로 우아하게 처리하도록 하십시오.
구조화된 NPC 상태
자유 형식의 캐릭터 설명은 흐트러지기 쉽습니다. 간결한 구조화된 기록은 그렇지 않습니다. 이를 작게 유지하고, 모든 턴에서 시스템 메시지에 넣으며, 모델이 이를 제안이 아닌 사실로 처리하도록 권위적인 레이블을 붙이십시오.
{
"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 토큰의 전체 기록은 턴당 거의 비용이 들지 않습니다.
게임 액션을 위한 도구 호출
도구는 산문을 상태 변경으로 전환합니다. 아래 세 가지는 대화 기반 메커니즘의 대부분을 커버합니다: 신뢰 변화, 항목 이전, 그리고 선택 제시. 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."))주의해야 할 두 가지 세부 사항이 있습니다. 첫째, 함수 호출 라운드는 최대 4회로 제한되므로 혼란스러운 모델이 무한히 루프를 돌 수 없습니다. 둘째, 모든 함수 호출은 동일한 tool 메시지와 tool_call_id을 가집니다. 이를 생략하면 다음 요청이 잘못됩니다. 결과 문자열은 짧고 사실적이며, 이를 통해 모델은 사건에 따른 결과를 허구로 만들지 않고 발생한 일을 확인할 수 있습니다.
줄거리(플롯)를 잃지 않고 분기하기
엔진이 스토리 그래프를 소유하게 하고 모델이 문장을 소유하게 하십시오. 노드는 누가 말하고, 어떤 게이트를 통과해야 하며, 각 선택지가 어디로 이어지는지 나열합니다. 모델이 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이 존재하는지 확인하며, 게이트된 노드가 플레이어가 실제로 발견할 수 있는 사실을 요구하는지 확인할 수 있습니다. 모델은 구조가 아닌 각 노드 내에서 다양성을 제공합니다.
- 게이트는 상태 기록을 읽습니다: 신뢰 임계값, 보유 항목, 알려진 사실.
- 효과가 이를 수정합니다: gold, trust, flags.
- 폴백은 입력이 모호할 때 플레이어를 제자리에 유지합니다.
긴 플레이 스루의 메모리
10시간 전에 만난 NPC는 모욕을 여전히 기억해야 합니다. 10시간 분량의 대화를 다시 재생하지 마십시오. NPC당 두 문장의 요약본을 저장하고, 대화가 끝날 때마다 이를 업데이트한 후 상태 기록에 memories 필드로 추가하십시오. 요약과 예산 책정에 대한 메커니즘은 100k memory article에서 다루며, 이 같은 다듬기는 각 NPC의 누적 대화에도 적용됩니다.
브라우저 게임을 제공한다면, 키가 클라이언트에 도달하지 않도록 FastAPI 기사에 나와 있는 대로 스트림을 자체 서버를 통해 중계하십시오.
코드 테스트 방식으로 NPC 테스트하기
모델의 대화는 확률적이지만, 그 주변의 규칙은 그렇지 않으며, 테스트는 그 곳에 있어야 합니다. 이전의 상태 기록을 brannoch.json로 저장한 후, 산문 대신 엔진에 대한 검사를 작성하십시오.
- 도구 검증 테스트. NPC가 가지고 있지 않은 항목, 신뢰도 99의 변화량, 그리고 잘못된 인수를 사용하여
apply_tool을 직접 호출하십시오. 모든 경우에서 상태는 유효해야 합니다. - 그래프 테스트. 모든 노드를 로드하고, 각
next대상이 존재하는지 확인하며, API 호출 없이 첫 노드부터 각 종료 지점까지 경로를 탐색하십시오. - 재생 테스트. 실제 대화를 도구 호출 및 결과와 함께 한 번 기록한 후, 도구 메시지를 엔진에 다시 재생하여 최종 상태가 기대한 것과 일치하는지 확인하십시오.
- 소크 테스트. 스크립트화된 플레이어를 낮은 온도에서 50줄 동안 실행하고, NPC가 없는 항목을 주지 않으며 신뢰도 한도를 초과하지 않는지 확인하십시오.
테스트 중에는 약 0.3로 온도를 낮추고, 플레이 중에는 0.8로 되돌리십시오. 테스트 중 예상치 못한 상황이 적으면 실패가 샘플링 노이즈가 아닌 코드 문제를 가리킵니다. 라이브 플레이에서 버그가 발생하면 해당 교환을 재생 세트에 추가하여 눈에 띄지 않게 되돌아오는 것을 방지하십시오.
마지막 습관: 캐릭터 보이스는 NPC당 짧은 단락 하나로 유지하고, 규칙은 상태 기록에 넣으십시오. 보이스는 작가들이 자유롭게 조정할 수 있지만, 규칙은 코드 리뷰를 통해서만 변경됩니다. 이를 단일 블롭에 섞는 것은 NPC 성격의 리라이트가 우연히 항목을 잠금 해제하는 방식입니다.
가정이 명시된 비용 계산
가격은 입력 토큰 백만 개당 $0.15, 출력 토큰 백만 개당 $0.50입니다. 아래 수치는 측정이 아닌 계획용 가정입니다. NPC 한 줄의 비용은 다음과 같이 가정합니다: 시스템 지침 및 상태 350 토큰, 최근 대화 1,000 토큰, 도구 정의 250 토큰, 총 1,600 입력 토큰; 응답 100 출력 토큰.
| 항목 | 계산 | 비용 |
|---|---|---|
| 한 줄당 입력 | 1,600 x $0.15 / 1M | $0.0004 |
| 줄별 출력 | 100 x $0.50 / 1M | $0.0001 |
| 한 줄 | 합계 | $0.0005 |
| 한 세션, 60줄 | 60 x $0.0005 | $0.03 |
| 10,000세션 | 10,000 x $0.03 | $300 |
함수 호출 왕복은 또 다른 요청을 추가합니다: 입력 토큰 약 1,700개와 출력 40개, 약 $0.00047입니다. 세 줄 중 한 줄이 도구를 트리거한다면 평균에 그 3분의 1을 추가하십시오. 상한 검사도 중요합니다: 키당 분당 300 요청의 경우, 단일 키는 모든 동시 플레이어에 걸쳐 분당 약 300개의 NPC 줄을 지원합니다. 따라서 대규모 출시에는 큐잉이 필요합니다. 가격은 pricing page에 요약되어 있습니다.
질문과 답변
API는 게임 액션에 대한 함수 호출을 지원합니까?
네. 도구는 OpenAI 형식으로 허용되므로 함수를 선언하고, 툴 호출을 받으며, 결과를 툴 메시지로 보냅니다.
NPC 대화 한 번의 비용은 얼마인가요?
프롬프트에 따라 다릅니다. 줄당 입력 1,600개와 출력 100개 토큰을 가정할 때, 한 줄의 비용은 공개된 요금 기준으로 약 $0.0005입니다.
게임의 캐릭터가 성적인 장면에서 미성년자가 될 수 있습니까?
아니요. 미성년자가 관련된 성 콘텐츠는 소설에서도 항상 403으로 차단됩니다. 이 서비스는 18세 이상 성인을 위한 것입니다.
NPC가 줄거리의 비밀을 누출하는 것을 어떻게 막습니까?
상태 기록에 알고 있는 내용과 절대 하지 않을 내용을 나열하고, 항목 및 플래그 변경을 자체 코드에서 강제하세요.