Unfiltered AI для диалогов игровых NPC и интерактивной прозы
Оставляйте управление игрой за движком: храните состояние каждого NPC, проверяйте предлагаемые вызовы инструментов и сохраняйте допустимые сюжетные переходы. Это руководство применяет эти правила к сгенерированному диалогу и показывает, как оценить стоимость токенов.

ОбновленоUnfiltered AI
Ключевые моменты
- Специализированные провайдеры вывода, такие как Unfiltered AI, предлагают стабильное поведение без цензуры на одной модели, избегая случайности маршрутизации агрегаторов.
- Агрегаторы, такие как OpenRouter, предоставляют доступ к нескольким моделям, но могут различаться по строгости применения фильтров контента в зависимости от конкретной версии модели.
- Unfiltered AI использует модель с открытыми весами на выделенном оборудовании с контекстным окном на 100 000 токенов по цене $0,15/$0,50 за миллион токенов.
- Для строгого NSFW или согласованности ролевой игры выделенный API LLM без цензуры устраняет необходимость в сложной настройке промптов для обхода общих фильтров.
Игровой цикл, описанный словами
Удерживайте эту схему в голове. линия игрока поступает в engine. Движок собирает промпт из трёх частей: фиксированные инструкции, текущая запись состояния NPC и недавний диалог. Промпт отправляется в модель. Модель отвечает текстом, text, с вызовом функций или и тем, и другим. Текст выводится на экран. Вызовы функций возвращаются в движок, который проверяет их, изменяет запись состояния и возвращает короткую строку результата, чтобы модель могла закончить предложение. Затем цикл ожидает игрока.
Важное свойство заключается в том, что движок является единственным источником истины. Модель предлагает; движок решает. Если модель говорит, что персонаж передаёт ключ, но никогда не вызывает функцию, ключ остаётся в инвентаре. Именно это разделение делает сгенерированный диалог безопасным для подключения к игре с правилами. Всё остальное вытекает из этого.
Все запросы используют стандартный эндпоинт chat-completions по адресу https://api.unfilteredaiapi.com/v1 с идентификатором модели uncensored. Инструменты используют формат вызова функций 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."))Заслуживают внимания две детали. Во-первых, количество раундов вызовов инструментов ограничено четырьмя, поэтому запутавшаяся модель не может зациклиться бесконечно. Во-вторых, каждый вызов инструмента сопровождается соответствующим сообщением 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, и подтвердить, что шлюзовые узлы требуют фактов, которые игрок действительно может обнаружить. Модель обеспечивает разнообразие внутри каждого узла, а не структуру вокруг него.
- Шлюзы читают запись состояния: пороги доверия, удерживаемые предметы, известные факты.
- Эффекты изменяют её: золото, доверие, флаги.
- Возвраты удерживают игрока на месте, когда ввод неоднозначен.
Память в течение долгой игры
NPC, встреченный десять часов назад, должен помнить оскорбление. Не воспроизводите десять часов диалога. Сохраняйте двухпредложное резюме для каждого NPC, обновляйте его при завершении разговора и добавляйте его в запись состояния как поле memories. Механики суммирования и бюджетирования описаны в статье о памяти на 100k, и та же обрезка применяется к скользящему диалогу каждого NPC.
Если вы разрабатываете браузерную игру, проксируйте поток через свой сервер, как в статье FastAPI, чтобы ключ никогда не достигал клиента.
Тестирование NPC так же, как вы тестируете код
Диалог от модели вероятностен, но правила вокруг него — нет, и именно здесь должны быть тесты. Сохраните запись состояния из прошлого как brannoch.json, затем пишите проверки для движка, а не для текста.
- Тесты валидации инструментов. Вызовите
apply_toolнапрямую с предметом, которого нет у NPC, дельтой доверия 99 и некорректными аргументами. Состояние должно оставаться легальным во всех случаях. - Тесты графа. Загрузите каждый узел, подтвердите, что каждая цель
nextсуществует, и пройдите путь от первого узла к каждому финалу, вообще не вызывая API. - Тесты воспроизведения. Запишите реальный разговор один раз, включая вызовы инструментов и результаты, затем воспроизведите сообщения инструментов для движка, чтобы проверить, что конечное состояние соответствует вашим ожиданиям.
- Тесты на выносливость. Прогоните сценарного игрока по пятидесяти репликам при низкой температуре и убедитесь, что NPC никогда не выдаёт предмет, которого у него нет, и никогда не превышает границы доверия.
Снизьте температуру до 0,3 для этих прогонов, а затем верните 0,8 для игры. Меньше сюрпризов при тестировании означает, что сбой указывает на ваш код, а не на шум сэмплирования. Когда баг всё же появляется в игре, добавьте спорный обмен в набор воспроизведения, чтобы он не вернулся незамеченным.
Последняя привычка: храните голос персонажа в одном коротком абзаце на NPC, а правила — в записи состояния. Голос можно свободно настраивать авторам; правила меняются только при рецензировании кода. Смешивание их в едином блоке — это то, как переписывание личности NPC случайно разблокирует предмет.
Расчёт стоимости с указанными допущениями
Цены: $0,15 за миллион input-токенов и $0,50 за миллион output-токенов. Приведённые ниже цифры — это предположения для планирования, а не замеры. Считайте, что одна реплика NPC стоит: системные инструкции и состояние — 350 токенов, недавний диалог — 1 000 токенов, определения инструментов — 250 токенов, итого 1 600 input-токенов; ответ — 100 output-токенов.
| Пункт | Расчёт | Стоимость |
|---|---|---|
| Input-токенов на реплику | 1 600 × $0,15 / 1 млн | $0,0004 |
| Output-токенов на реплику | 100 × $0,50 / 1 млн | $0,0001 |
| Одна реплика | сумма | $0,0005 |
| Одна сессия, 60 реплик | 60 × $0,0005 | $0,03 |
| 10 000 сессий | 10 000 × $0,03 | $300 |
Раунд вызовов инструментов добавляет ещё один запрос: примерно 1 700 input-токенов плюс 40 output, около $0,00047. Если одна из трёх реплик запускает инструмент, добавьте треть этой суммы к среднему значению. Важны и проверки потолка: при 300 запросах в минуту на ключ один ключ поддерживает около 300 реплик NPC в минуту для всех одновременных игроков, поэтому для крупных запусков нужна очередь. Ставки обобщены на странице с ценами.
Вопросы и ответы
Поддерживает ли API вызов функций для действий в игре?
Да. Инструменты принимаются в формате OpenAI, поэтому вы объявляете функции, получаете вызовы инструментов и отправляете результаты обратно как сообщения инструментов.
Сколько стоит разговор NPC?
Это зависит от ваших промптов. При условии 1 600 входных и 100 выходных токенов на строку, одна строка стоит около $0,0005 по опубликованным тарифам.
Могут ли персонажи в моей игре быть несовершеннолетними в сексуальных сценах?
Нет. Сексуальный контент с участием несовершеннолетних всегда блокируется с кодом 403, включая художественные тексты. Сервис предназначен для взрослых старше 18 лет.
Как предотвратить раскрытие NPC сюжетных тайн?
Перечислите в записи состояния, что он знает и чего он никогда не должен делать, и контролируйте изменения предметов и флагов в своём коде.
Ваш ключ — всего в одной форме
Создайте аккаунт, скопируйте ключ, измените базовый URL. Это вся настройка.