Uma API para ficção interativa e aventuras de texto

O que um jogo de texto precisa, e o que você recebe

Quanto custa uma sessão

O histórico inteiro é enviado a cada turno, então a 60ª chamada é bem mais longa que a primeira. O cache é o que mantém isso barato: a parte que uma chamada repete da anterior é lida do cache. Sem nenhum acerto no cache, a mesma sessão sai por $0.30 no DeepSeek. Como funciona o cache.

Um narrador em vinte linhas

O mundo e as regras vão na mensagem de sistema. Mantenha-a igual de turno em turno, para que o começo de cada chamada se repita e seja lido do cache. Transmita a resposta e mostre-a conforme ela chega.

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 é qualquer texto que você mantém igual numa campanha. Ele envia as chamadas da campanha para onde o começo já está em cache. Streaming explica o uso no último pedaço e como interromper uma resposta cedo.

Mantenha o jogo no seu código

• Estado fora da prosa. Guarde inventário, vida e flags nos seus próprios dados, e coloque um resumo curto deles na mensagem de sistema. Um modelo lembra bem de uma história e mal de um número.
• Peça JSON quando precisar de dados de volta. Uma segunda chamada curta com response_format pode devolver o que mudou neste turno, para o seu código aplicar. Saída em JSON.
• Campanhas longas. Um milhão de tokens são muitos turnos, mas cada um é cobrado. Depois de algumas centenas de turnos, substitua os mais antigos por um resumo que você escreve uma vez, e mantenha o resumo no mesmo lugar para que o começo continue se repetindo.
• Ramificações e desfazer. A API não guarda nada entre chamadas, então um ponto de salvamento é apenas a lista de mensagens naquele turno. Reenvie uma lista anterior para voltar atrás.

Qual modelo

O que acontece com as histórias dos seus jogadores

Guardamos uma linha por chamada: a hora, a chave, o modelo, a contagem de tokens, os créditos e o status, por 30 dias. Nunca as mensagens, nunca a resposta. O DeepSeek roda em um nível privado que não armazena prompts nem respostas. As histórias dos jogadores ficam onde o seu jogo as guarda, e em nenhum lugar nosso. O que guardamos.