API untuk fiksi interaktif dan petualangan teks

Yang dibutuhkan game teks, dan yang kamu dapat

Biaya satu sesi

Seluruh riwayat dikirim di setiap giliran, jadi panggilan ke-60 jauh lebih panjang dari yang pertama. Cache-lah yang membuatnya tetap murah: bagian yang diulang dari panggilan sebelumnya dibaca dari cache. Tanpa satu pun hit cache, sesi yang sama berharga $0,30 di DeepSeek. Cara kerja cache.

Narator dalam dua puluh baris

Dunia dan aturannya ditaruh di pesan sistem. Biarkan tetap sama dari giliran ke giliran, sehingga awal setiap panggilan berulang dan dibaca dari cache. Stream balasannya dan tampilkan saat tiba.

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 adalah string apa pun yang kamu jaga tetap sama untuk satu kampanye. Ini mengarahkan panggilan kampanye ke tempat awalnya sudah ada di cache. Streaming menjelaskan penggunaan di potongan terakhir dan menghentikan balasan lebih awal.

Simpan permainan di kodemu

• Keadaan di luar prosa. Simpan inventaris, kesehatan dan penanda di datamu sendiri, dan taruh ringkasan singkatnya di pesan sistem. Model mengingat cerita dengan baik dan angka dengan buruk.
• Minta JSON saat kamu butuh fakta kembali. Panggilan kedua yang singkat dengan response_format bisa mengembalikan apa yang berubah di giliran ini, agar kodemu menerapkannya. Output JSON.
• Kampanye panjang. Satu juta token berarti banyak giliran, tetapi setiap giliran ditagih. Setelah beberapa ratus giliran, ganti yang paling lama dengan ringkasan yang kamu tulis sekali, dan simpan ringkasan itu di tempat yang sama agar awalnya tetap berulang.
• Cabang dan undo. API tidak menyimpan apa pun di antara panggilan, jadi titik simpan hanyalah daftar pesan pada giliran itu. Kirim ulang daftar yang lebih lama untuk mundur.

Model mana

Apa yang terjadi pada cerita pemainmu

Kami menyimpan satu baris per panggilan: waktu, kunci, model, jumlah token, kredit dan statusnya, selama 30 hari. Tidak pernah pesannya, tidak pernah balasannya. DeepSeek berjalan di tingkat privat yang tidak menyimpan prompt atau balasan. Cerita pemain tinggal di tempat game kamu menyimpannya, dan tidak di tempat kami. Apa yang kami simpan.