Bir oyun NPC diyalog API'si

NPC diyaloğunun ihtiyaçları ve nokeep'te karşılığı

Bin konuşmanın maliyeti

GLM'de aynı bin konuşma, kısa düşünmesinden önce yaklaşık $1.34 tutar; ancak bu düşünme her satırdan önce gelir ve bir NPC'nin ayıramayacağı süreye mal olur. Kısa kişilik promptları her iki durumda da ucuzdur; asıl maliyeti, her çağrıda gönderilen uzun bir lore metni biriktirir.

Akış halinde bir diyalog satırı

Bunu istemcide değil, oyun sunucunda çalıştır: bir oyunun içine konan anahtar oradan çekilip alınabilir. Her parçayı geldiği anda göster; oyuncu izlerken konuşma balonu dolsun.

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://nokeep.ai/v1",
    api_key=os.environ["NOKEEP_API_KEY"],
)

persona = "You are Brannoc, the blacksmith of Hollowmere: gruff, superstitious, owes the thieves guild money. The player has the quest \"Missing ore\" and has not yet found the mine. Speak only as Brannoc, in one to three short sentences. Never mention game mechanics."

stream = client.chat.completions.create(
    model="deepseek-v4.1-flash-uncensored",
    messages=[
        {"role": "system", "content": persona},
        {"role": "user", "content": "Have you seen any ore carts come through town?"},
    ],
    stream=True,
    max_tokens=120,
    temperature=0.8,
)
for chunk in stream:
    if chunk.choices:
        print(chunk.choices[0].delta.content or "", end="", flush=True)

Oyunun uygulayabileceği bir satır

NPC'nin yanıtının oyunu değiştirmesi gerektiğinde, akan düz metin yerine JSON iste: gösterilecek satır, animasyon için bir ruh hali ve kodun için bir eylem. Yapıyı promptta da anlat.

import json

reply = client.chat.completions.create(
    model="deepseek-v4.1-flash-uncensored",
    max_tokens=200,
    response_format={"type": "json_object"},
    messages=[
        {"role": "system", "content": persona + ' Answer as JSON: {"line": string, "mood": "calm" | "angry" | "afraid", "action": "none" | "give_map" | "attack"}.'},
        {"role": "user", "content": "Tell me where the mine is or I tell the guild you skipped town."},
    ],
)
npc = json.loads(reply.choices[0].message.content)
print(npc["line"], npc["mood"], npc["action"])

Aynı anda çok oyuncu

• Her anahtar dakikada 120 istek alır, bir hesapta 10 anahtar tutulabilir. 429 aldığında Retry-After başlığı ne kadar beklemen gerektiğini söyler. Hız sınırları.
• Her ortama günlük sınırı olan kendi anahtarını ver: diyaloğu döngüye sokan bir hata, bakiyende değil sınırda durur. Anahtarlar ve sınırlar.
• Kişilikleri kısa ve sabit tut. Çağrıdan çağrıya tekrar eden yaklaşık 1.000 token ve üzeri bir kişilik, önbellekten fiyatının bir kısmıyla okunur.
• Bir çağrı başarısız olduğunda kullanılacak yedek bir satır yaz; yoğun bir an sahneyi asla dondurmasın. 503 busy ücretsizdir.

Hangi model

Sesli satırlar için deepseek-v4.1-flash-uncensored kullan: önce düşünmeden yanıtlar, örnekleme ayarlarını kabul eder ve JSON döndürür. glm-5.3-flash-uncensored token başına daha ucuzdur (milyon başına $0.20 girdi, $0.65 çıktı; DeepSeek'te $0.45 ve $1.75'e karşılık) ama her yanıttan önce kısa süre düşünür. Bu yüzden oyuncunun beklemediği işlere uygundur, örneğin yarının kasaba dedikodusunu yazmak. Karşılaştır.

Oyuncuların sözlerinden neyi tutuyoruz

Çağrı başına bir satır: zaman, anahtar, model, token sayıları, krediler ve durum; 30 gün tutulur. Oyuncunun yazdığı metin de NPC'nin söylediği satır da asla tutulmaz. Kişilik promptuna hiçbir şey eklenmez. Neyi tutuyoruz.