Une API pour la fiction interactive et les aventures textuelles

Ce qu’il faut à un jeu textuel, et ce que vous obtenez

Le coût d’une session

L’historique entier est envoyé à chaque tour, si bien que le 60e appel est bien plus long que le premier. Le cache est ce qui garde le coût bas : la partie qu’un appel répète depuis l’appel précédent est lue dans le cache. Sans un seul succès de cache, la même session coûterait $0.30 sur DeepSeek. Comment fonctionne le cache.

Un narrateur en une vingtaine de lignes

Le monde et les règles vont dans le message système. Gardez-le identique d’un tour à l’autre, pour que le début de chaque appel se répète et soit lu dans le cache. Diffusez la réponse et affichez-la au fur et à mesure qu’elle arrive.

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 est une chaîne quelconque que vous gardez identique pour une campagne. Elle envoie les appels de la campagne là où son début est déjà en cache. Le streaming explique l’usage dans le dernier fragment et l’arrêt anticipé d’une réponse.

Gardez le jeu dans votre code

• L’état hors de la prose. Gardez inventaire, santé et drapeaux dans vos propres données, et mettez un court résumé dans le message système. Un modèle retient bien une histoire et mal un nombre.
• Demandez du JSON quand vous avez besoin de données en retour. Un second appel court avec response_format peut renvoyer ce qui a changé à ce tour, pour que votre code l’applique. Sortie JSON.
• Longues campagnes. Un million de tokens, c’est beaucoup de tours, mais chacun est facturé. Au-delà de quelques centaines de tours, remplacez les plus anciens par un résumé écrit une fois, et gardez ce résumé au même endroit pour que le début continue de se répéter.
• Embranchements et annulation. L’API ne garde rien entre les appels : un point de sauvegarde n’est donc que la liste des messages à ce tour. Renvoyez une liste antérieure pour revenir en arrière.

Quel modèle

Ce qu’il advient des histoires de vos joueurs

Nous gardons une ligne par appel : l’heure, la clé, le modèle, les comptes de tokens, les crédits et le statut, pendant 30 jours. Jamais les messages, jamais la réponse. DeepSeek tourne sur un palier privé qui ne stocke ni prompts ni réponses. Les histoires de vos joueurs restent là où votre jeu les garde, et nulle part chez nous. Ce que nous conservons.