یک API برای داستان تعاملی و ماجراجویی متنی

یک بازی متنی چه می‌خواهد و چه می‌گیرد

هزینهٔ یک نشست

تاریخچهٔ کامل با هر نوبت فرستاده می‌شود، پس فراخوانی شصتم خیلی طولانی‌تر از اولی است. کش است که این را ارزان نگه می‌دارد: بخشی که یک فراخوانی از فراخوانی قبلی تکرار می‌کند، از کش خوانده می‌شود. بدون حتی یک بار استفاده از کش، همین نشست روی DeepSeek برابر $0.30 می‌شود. نحوهٔ کار کش.

یک راوی در بیست خط

دنیا و قوانین در پیام سیستم قرار می‌گیرند. آن را از نوبتی به نوبت ثابت نگه دار، تا شروع هر فراخوانی تکرار شود و از کش خوانده شود. پاسخ را استریم کن و همان‌طور که می‌رسد چاپش کن.

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 هر رشته‌ای است که برای یک کمپین ثابت نگه می‌داری. فراخوانی‌های کمپین را به جایی می‌فرستد که شروعش از قبل کش شده. استریم دربارهٔ مصرف در آخرین chunk و توقف زودهنگام یک پاسخ توضیح می‌دهد.

بازی را در کدت نگه دار

• وضعیت بیرون از نثر. موجودی، سلامتی و پرچم‌ها را در داده‌های خودت نگه دار و یک خلاصهٔ کوتاه از آن‌ها را در پیام سیستم بگذار. مدل داستان را خوب به خاطر می‌سپارد و عدد را بد.
• برای گرفتن واقعیت‌ها JSON بخواه. یک فراخوانی دوم و کوتاه با response_format می‌تواند آنچه این نوبت تغییر داده را برگرداند، تا کدت اعمالش کند. خروجی JSON.
• کمپین‌های بلند. یک میلیون توکن یعنی نوبت‌های زیاد، اما هر نوبت هزینه دارد. بعد از چند صد نوبت، قدیمی‌ترین‌ها را با خلاصه‌ای که یک بار می‌نویسی جایگزین کن، و خلاصه را همان‌جا نگه دار تا شروع همچنان تکرار شود.
• شاخه‌زدن و بازگشت. API بین فراخوانی‌ها چیزی نگه نمی‌دارد، پس نقطهٔ ذخیره فقط فهرست پیام‌ها در آن نوبت است. برای برگشتن، فهرست قبلی را دوباره بفرست.

کدام مدل

چه بر سر داستان بازیکنانت می‌آید

برای هر فراخوانی یک ردیف نگه می‌داریم: زمان، کلید، مدل، شمارش توکن‌ها، اعتبار و وضعیت، به مدت ۳۰ روز. هرگز پیام‌ها، هرگز پاسخ. DeepSeek روی یک سطح خصوصی اجرا می‌شود که هیچ درخواست یا پاسخی را ذخیره نمی‌کند. داستان بازیکنانت هرجا بازی‌ات نگهش می‌دارد زندگی می‌کند، و هیچ‌جا روی سرورهای ما نیست. آنچه نگه می‌داریم.