API cho truyện tương tác và trò chơi phiêu lưu chữ

Trò chơi chữ cần gì, và bạn nhận được gì

Một phiên tốn bao nhiêu

Toàn bộ lịch sử được gửi kèm mỗi lượt, nên lần gọi thứ 60 dài hơn nhiều so với lần đầu. Cache là lý do nó vẫn rẻ: phần mà một lần gọi lặp lại từ lần gọi trước được đọc từ cache. Nếu không có lần trúng cache nào, cùng phiên đó là $0.30 trên DeepSeek. Cách cache hoạt động.

Người kể chuyện trong hai mươi dòng

Thế giới và luật chơi đặt trong tin nhắn hệ thống. Giữ nó không đổi từ lượt này sang lượt khác, để phần mở đầu của mọi lần gọi lặp lại và được đọc từ cache. Truyền phản hồi và in ra khi nó đến.

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 là bất kỳ chuỗi nào bạn giữ nguyên cho một chiến dịch. Nó gửi các lần gọi của chiến dịch đến nơi phần mở đầu đã được cache. Truyền trực tiếp đề cập đến usage trong chunk cuối và cách dừng phản hồi giữa chừng.

Giữ trò chơi trong mã của bạn

• Trạng thái nằm ngoài văn xuôi. Giữ túi đồ, sinh lực và cờ trong dữ liệu của riêng bạn, và đặt một bản tóm tắt ngắn trong tin nhắn hệ thống. Mô hình nhớ truyện tốt và nhớ số liệu kém.
• Yêu cầu JSON khi bạn cần lấy lại dữ liệu. Một lần gọi thứ hai, ngắn, với response_format có thể trả về những gì đã thay đổi trong lượt này, để mã của bạn áp dụng. Đầu ra JSON.
• Chiến dịch dài. Một triệu token là rất nhiều lượt, nhưng mỗi lượt đều bị tính phí. Qua vài trăm lượt, hãy thay những lượt cũ nhất bằng một bản tóm tắt bạn viết một lần, và giữ bản tóm tắt ở cùng một chỗ để phần mở đầu vẫn lặp lại.
• Rẽ nhánh và hoàn tác. API không giữ gì giữa các lần gọi, nên một điểm lưu chỉ là danh sách tin nhắn tại lượt đó. Gửi lại một danh sách cũ để quay lại.

Chọn mô hình nào

Điều gì xảy ra với câu chuyện của người chơi

Chúng tôi giữ một dòng cho mỗi lần gọi: thời gian, khóa, mô hình, số token, tín dụng và trạng thái, trong 30 ngày. Không bao giờ giữ tin nhắn, không bao giờ giữ phản hồi. DeepSeek chạy trên một tầng riêng không lưu prompt hay phản hồi. Câu chuyện của người chơi nằm ở nơi trò chơi của bạn lưu chúng, và không ở nơi nào của chúng tôi. Chúng tôi giữ gì.