واجهة برمجية للقصص التفاعلية والمغامرات النصية

ما تحتاجه اللعبة النصية، وما تحصل عليه

تكلفة الجلسة

يُرسل التاريخ كاملًا مع كل دور، فيكون الاستدعاء الستون أطول بكثير من الأول. والتخزين المؤقت هو سبب بقاء الكلفة منخفضة: الجزء الذي يكرره الاستدعاء من الاستدعاء الذي قبله يُقرأ من التخزين المؤقت. ومن دون أي قراءة من التخزين المؤقت تكون الجلسة نفسها $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 هو أي نص تحافظ عليه نفسه لحملة واحدة. وهو يوجّه استدعاءات الحملة إلى المكان الذي تكون بدايته مخزّنة فيه أصلًا. يغطي البث معلومات الاستخدام في آخر جزء، وإيقاف الرد قبل اكتماله.

أبقِ اللعبة في كودك

• الحالة خارج النثر. احفظ المخزون والصحة والمؤشرات في بياناتك أنت، واكتب ملخصًا قصيرًا لها في رسالة النظام. النموذج يتذكر القصة جيدًا، ويتذكر الأرقام بصورة ضعيفة.
• اطلب JSON عندما تحتاج معلومات تعود إليك. يمكن لاستدعاء ثانٍ قصير مع response_format أن يعيد ما تغيّر في هذا الدور، ليطبّقه كودك. مخرجات JSON.
• الحملات الطويلة. مليون رمز عدد كبير من الأدوار، لكن كل دور يُحتسب. وبعد بضع مئات من الأدوار، استبدل الأقدم بملخص تكتبه مرة واحدة، واحفظ الملخص في المكان نفسه كي تبقى البداية متكررة.
• التفرع والتراجع. لا تحتفظ الواجهة بشيء بين الاستدعاءات، فنقطة الحفظ ليست إلا قائمة الرسائل في ذلك الدور. أعد إرسال قائمة أقدم للعودة إلى الوراء.

أي نموذج

ماذا يحدث لقصص لاعبيك

نحتفظ بصف واحد لكل استدعاء: الوقت والمفتاح والنموذج وعدد الرموز والأرصدة والحالة، لمدة 30 يومًا. لا نحتفظ أبدًا بالرسائل ولا بالرد. يعمل DeepSeek على مستوى خاص لا يخزّن أي موجّهات أو ردود. أما قصص لاعبيك فتبقى حيث تحفظها لعبتك، ولا تبقى لدينا. ما الذي نحتفظ به.