Interaktif kurgu ve metin maceraları için API

Bir metin oyununun ihtiyaçları ve nokeep'te karşılıkları

Bir oturum ne kadar tutar

Her turda tüm geçmiş gönderilir; bu yüzden 60. çağrı ilkinden çok daha uzundur. Ucuz kalmasını önbellek sağlar: bir çağrının önceki çağrıyla tekrar eden kısmı önbellekten okunur. Tek bir önbellek isabeti olmasaydı aynı oturum DeepSeek'te $0.30 olurdu. Önbellek nasıl çalışır.

Yirmi satırda bir anlatıcı

Dünya ve kurallar sistem mesajına yazılır. Bunu tur tur aynı tut ki her çağrının başlangıcı tekrarlansın ve önbellekten okunsun. Yanıtı akıt ve geldikçe yazdır.

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, bir kampanya için aynı kalan herhangi bir metindir. Kampanyanın çağrılarını, başlangıcı zaten önbellekte olan yere yönlendirir. Akış, son parçadaki kullanım bilgisini ve yanıtı erken durdurmayı anlatır.

Oyunu kodunda tut

• Durum metnin dışında. Envanteri, canı ve bayrakları kendi verinde tut ve sistem mesajına bunların kısa bir özetini koy. Bir model hikâyeyi iyi hatırlar, sayıları kötü hatırlar.
• Bilgi geri istediğinde JSON iste. response_format içeren ikinci, kısa bir çağrı, bu turda neyin değiştiğini döndürebilir; kodun da bunu uygulayabilir. JSON çıktısı.
• Uzun kampanyalar. Bir milyon token çok sayıda tur demektir, ama her tur faturalanır. Birkaç yüz turdan sonra en eskileri, bir kez yazdığın bir özetle değiştir ve özeti hep aynı yerde tut ki başlangıç yine tekrarlansın.
• Dallanma ve geri alma. API çağrılar arasında hiçbir şey tutmaz; bu yüzden bir kayıt noktası, o turdaki mesaj listesinin kendisidir. Geri sarmak için daha önceki bir listeyi yeniden gönder.

Hangi model

Oyuncularının hikâyelerine ne olur

Çağrı başına yalnızca bir satır tutarız: zaman, anahtar, model, token sayıları, kredi ve durum; bunları 30 gün boyunca. Mesajları ve yanıtı asla tutmayız. DeepSeek, istem ya da yanıt saklamayan özel bir katmanda çalışır. Oyuncuların hikâyeleri, oyununun onları tuttuğu yerde durur; bizde değil. Neleri tutuyoruz.