Una API para ficción interactiva y aventuras de texto

Lo que necesita un juego de texto, y lo que obtienes

Cuánto cuesta una sesión

Se envía todo el historial con cada turno, así que la llamada 60 es mucho más larga que la primera. La caché es la razón de que siga siendo barato: la parte que una llamada repite de la anterior se lee de la caché. Sin ningún acierto de caché, la misma sesión cuesta $0.30 en DeepSeek. Cómo funciona la caché.

Un narrador en veinte líneas

El mundo y las reglas van en el mensaje de sistema. Mantenlo igual de un turno al otro, para que el inicio de cada llamada se repita y se lea de la caché. Transmite la respuesta e imprímela conforme llega.

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 es cualquier cadena que mantengas igual para una campaña. Envía las llamadas de la campaña a donde su inicio ya está en caché. Streaming explica el uso en el último fragmento y cómo detener una respuesta a medias.

Mantén el juego en tu código

• Estado fuera de la prosa. Guarda inventario, salud y banderas en tus propios datos, y pon un resumen breve de ellos en el mensaje de sistema. Un modelo recuerda bien una historia y mal un número.
• Pide JSON cuando necesites datos de vuelta. Una segunda llamada corta con response_format puede devolver lo que cambió en este turno, para que tu código lo aplique. Salida JSON.
• Campañas largas. Un millón de tokens son muchos turnos, pero cada uno se cobra. Pasados unos cientos de turnos, reemplaza los más antiguos por un resumen que escribas una vez, y guárdalo siempre en el mismo lugar para que el inicio siga repitiéndose.
• Ramas y deshacer. La API no guarda nada entre llamadas, así que un punto de guardado es simplemente la lista de mensajes en ese turno. Reenvía una lista anterior para retroceder.

Qué modelo usar

Qué pasa con las historias de tus jugadores

Guardamos una fila por llamada: la hora, la clave, el modelo, los conteos de tokens, los créditos y el estado, durante 30 días. Nunca los mensajes, nunca la respuesta. DeepSeek funciona en un nivel privado que no almacena prompts ni respuestas. Las historias de tus jugadores viven donde las guarde tu juego, y en ningún lugar nuestro. Qué guardamos.