واجهة حوار الشخصيات في الألعاب

ما يحتاجه حوار الشخصيات، وما تحصل عليه

ما تكلّفه ألف حوار

على GLM تكلّف الألف حوار نفسها نحو $1.34 قبل تفكيره القصير، لكن هذا التفكير يسبق كل سطر، وهذا وقت لا تتحمله الشخصية في اللعبة. مطالبات الشخصية القصيرة رخيصة في الحالين؛ ما يتراكم هو وضع كتاب خلفية طويل في كل استدعاء.

سطر حوار يُبث

شغّل هذا على خادم لعبتك، لا في العميل: المفتاح المدمج داخل اللعبة يمكن استخراجه منها. اعرض كل جزء فور وصوله، حتى تمتلئ فقاعة الكلام أمام عين اللاعب.

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)

سطر تستطيع لعبتك أن تتصرف بناءً عليه

حين ينبغي أن يغيّر رد الشخصية اللعبة، اطلب JSON بدل النثر المبثوث: السطر الذي يُعرض، ومزاجًا للرسوم المتحركة، وإجراءً لكودك. صف الشكل في المطالبة أيضًا.

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"])

لاعبون كثيرون في وقت واحد

• يحصل كل مفتاح على 120 طلبًا في الدقيقة، ويستطيع الحساب أن يضم 10 مفاتيح. بعد 429، تخبرك الترويسة Retry-After بمدة الانتظار. حدود المعدل.
• امنح كل بيئة مفتاحها الخاص بسقف يومي: الخلل الذي يكرر حوارًا يتوقف عند السقف، لا عند رصيدك. المفاتيح والسقوف.
• أبقِ مطالبات الشخصية قصيرة وثابتة. مطالبة الشخصية التي تبلغ نحو 1,000 توكن أو أكثر وتتكرر من استدعاء إلى آخر تُقرأ من المخبّأ بجزء من السعر.
• اكتب سطرًا احتياطيًا لحالة فشل الاستدعاء، حتى لا يتجمد المشهد في لحظة ازدحام. الرد 503 busy لا يكلّف شيئًا.

أي نموذج

استخدم deepseek-v4.1-flash-uncensored للأسطر المنطوقة: يجيب دون تفكير مسبق، ويقبل معاملات أخذ العينات، ويرجع JSON. أما glm-5.3-flash-uncensored فأرخص لكل توكن ($0.20 داخل و$0.65 خارج لكل مليون، مقابل $0.45 و$1.75)، لكنه يفكّر قليلًا قبل كل رد، فيناسب الأعمال التي لا ينتظرها اللاعب، مثل كتابة أحاديث بلدة الغد. قارن بينهما.

ما نحتفظ به من كلام اللاعبين

سطر واحد لكل استدعاء: الوقت والمفتاح والنموذج وأعداد التوكنات والرصيد والحالة، ويُحفظ 30 يومًا. لا نحتفظ أبدًا بما كتبه اللاعب، ولا بسطر الشخصية. لا يُضاف أي شيء إلى مطالبة شخصيتك. ما نحتفظ به.