RU ▾

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

Unfiltered AI

Сырой API LLM без цензуры для разработчиков.

Unfiltered AIПолучить API-ключ

Unfiltered AI для диалогов игровых NPC и интерактивной прозы

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

Unfiltered AI для диалогов игровых NPC и интерактивной прозы

Ключевые моменты

  • Специализированные провайдеры вывода, такие как 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, затем пишите проверки для движка, а не для текста.

  1. Тесты валидации инструментов. Вызовите apply_tool напрямую с предметом, которого нет у NPC, дельтой доверия 99 и некорректными аргументами. Состояние должно оставаться легальным во всех случаях.
  2. Тесты графа. Загрузите каждый узел, подтвердите, что каждая цель next существует, и пройдите путь от первого узла к каждому финалу, вообще не вызывая API.
  3. Тесты воспроизведения. Запишите реальный разговор один раз, включая вызовы инструментов и результаты, затем воспроизведите сообщения инструментов для движка, чтобы проверить, что конечное состояние соответствует вашим ожиданиям.
  4. Тесты на выносливость. Прогоните сценарного игрока по пятидесяти репликам при низкой температуре и убедитесь, что 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. Это вся настройка.

Получить API-ключЧитать документацию