API для интерактивной прозы и текстовых приключений

Что нужно текстовой игре и что вы получаете

Сколько стоит сессия

Вся история отправляется с каждым ходом, поэтому 60-й вызов намного длиннее первого. Кэш делает это дешёвым: часть, которую вызов повторяет из предыдущего, читается из кэша. Без единого попадания в кэш та же сессия стоит $0.30 на DeepSeek. Как работает кэш.

Рассказчик в двадцати строках

Мир и правила идут в системное сообщение. Держите его неизменным от хода к ходу, тогда начало каждого вызова повторяется и читается из кэша. Передавайте ответ потоком и печатайте его по мере поступления.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://nokeep.ai/v1",
    api_key=os.environ["NOKEEP_API_KEY"],
)

history = [{"role": "system", "content": "You are the narrator of a dark fantasy text adventure. The player is a smuggler in the drowned city of Vell. Describe what they see, hear and smell in second person, in under 150 words. Never act or speak for the player. End each turn with the scene open, not with a list of options."}]

def turn(move):
    history.append({"role": "user", "content": move})
    stream = client.chat.completions.create(
        model="deepseek-v4.1-flash-uncensored",
        messages=history,
        stream=True,
        max_tokens=400,
        temperature=0.9,
        extra_body={"min_p": 0.05, "repetition_penalty": 1.05, "prompt_cache_key": "campaign-42"},
    )
    text = ""
    for chunk in stream:
        if chunk.choices:
            piece = chunk.choices[0].delta.content or ""
            print(piece, end="", flush=True)
            text += piece
    history.append({"role": "assistant", "content": text})

turn("I row the stolen skiff under the old customs bridge.")

prompt_cache_key — любая строка, которую вы сохраняете одинаковой для одной кампании. Она направляет вызовы кампании туда, где её начало уже в кэше. Потоковая передача рассказывает про usage в последнем фрагменте и про досрочную остановку ответа.

Держите игру в своём коде

• Состояние вне прозы. Храните инвентарь, здоровье и флаги в своих данных и кладите короткую сводку о них в системное сообщение. Модель хорошо помнит историю и плохо помнит числа.
• Просите JSON, когда нужны факты обратно. Второй короткий вызов с response_format может вернуть, что изменилось в этом ходу, а ваш код применит это. Вывод JSON.
• Длинные кампании. Миллион токенов — это много ходов, но каждый из них оплачивается. После нескольких сотен ходов заменяйте самые старые сводкой, которую вы пишете один раз, и держите её на одном месте, чтобы начало по-прежнему повторялось.
• Ветвление и отмена. API ничего не хранит между вызовами, поэтому точка сохранения — это просто список сообщений на данном ходу. Чтобы откатиться, отправьте более ранний список снова.

Какую модель выбрать

Что происходит с историями ваших игроков

Мы храним одну строку на вызов: время, ключ, модель, число токенов, кредиты и статус, в течение 30 дней. Никогда сообщения и никогда ответ. DeepSeek работает на приватном уровне, который не хранит промпты и ответы. Истории игроков живут там, где их хранит ваша игра, и нигде у нас. Что мы храним.