Eine API für interaktive Fiktion und Textabenteuer

Was ein Textspiel braucht und was Sie bekommen

Was eine Session kostet

Der gesamte Verlauf wird mit jeder Runde gesendet, daher ist der 60. Aufruf weit länger als der erste. Das Caching hält es günstig: Der Teil, den ein Aufruf vom vorherigen wiederholt, wird aus dem Cache gelesen. Ohne einen einzigen Cache-Treffer kostet dieselbe Session auf DeepSeek 0,30 $. So funktioniert Caching.

Ein Erzähler in zwanzig Zeilen

Die Welt und die Regeln stehen in der System-Nachricht. Halten Sie sie von Runde zu Runde gleich, damit sich der Anfang jedes Aufrufs wiederholt und aus dem Cache gelesen wird. Streamen Sie die Antwort und geben Sie sie aus, sobald sie eintrifft.

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 ist eine beliebige Zeichenkette, die Sie für eine Kampagne gleich lassen. Sie schickt die Aufrufe der Kampagne dorthin, wo ihr Anfang schon im Cache liegt. Streaming erklärt die Nutzungsangaben im letzten Chunk und wie Sie eine Antwort vorzeitig stoppen.

Das Spiel im eigenen Code halten

• Zustand außerhalb der Prosa. Halten Sie Inventar, Lebenspunkte und Flags in Ihren eigenen Daten und legen Sie eine kurze Zusammenfassung davon in die System-Nachricht. Ein Modell merkt sich eine Geschichte gut und Zahlen schlecht.
• JSON anfordern, wenn Sie Fakten zurückbrauchen. Ein zweiter, kurzer Aufruf mit response_format kann zurückgeben, was sich in dieser Runde geändert hat, damit Ihr Code es anwendet. JSON-Ausgabe.
• Lange Kampagnen. Eine Million Tokens sind viele Runden, aber jede wird berechnet. Ab einigen hundert Runden ersetzen Sie die ältesten durch eine einmal geschriebene Zusammenfassung und halten die Zusammenfassung an derselben Stelle, damit der Anfang trotzdem wiederkehrt.
• Verzweigung und Rückgängig. Die API behält nichts zwischen Aufrufen, ein Speicherpunkt ist also schlicht die Nachrichtenliste dieser Runde. Senden Sie eine frühere Liste erneut, um zurückzuspulen.

Welches Modell

Was mit den Geschichten Ihrer Spielerinnen und Spieler passiert

Wir speichern pro Aufruf eine Zeile: die Zeit, den Schlüssel, das Modell, die Token-Zahlen, die Guthaben und den Status, 30 Tage lang. Nie die Nachrichten, nie die Antwort. DeepSeek läuft auf einer privaten Stufe, die keine Prompts oder Antworten speichert. Die Geschichten der Spielerinnen und Spieler liegen dort, wo Ihr Spiel sie hält, und nirgends bei uns. Was wir speichern.