游戏 AI / 系统课时
客户端调用还是服务端调用
客户端调用还是服务端调用
把生成式 AI 接进游戏时,调用位置会直接影响凭证安全、响应延迟、成本和数据控制。本篇用一个实际的 NPC 内容生成为例,建立客户端、服务端与后台流水线的选型边界。
学习目标
- 能根据凭证、延迟和数据敏感性选择调用位置
- 能区分实时生成与异步生成的适用场景
- 能用服务端代理保护模型凭证并控制请求参数
先确定生成任务是否必须实时
第一步不是选 SDK,而是看生成结果是否必须立即反馈给玩家。战斗中的战术意图、短对话回复通常需要低延迟;任务文本批量生成、语音稿、关卡草案则可以排入后台流水线。
| 场景 | 更合适的位置 | 核心原因 |
|---|---|---|
| 战斗中的短决策 | 服务端 | 保护凭证,同时集中规则和限流 |
| NPC 即时对话 | 服务端 | 玩家输入与世界状态更容易统一控制 |
| 本地轻量生成 | 客户端 | 可减少往返,但必须接受凭证和模型能力受限 |
| 大批量内容生产 | 后台流水线 | 可异步、批量和重试,便于成本控制 |

客户端为什么通常不直接持有模型凭证
最容易实现的方案是把模型 API Key 放进游戏客户端,然后由客户端直接请求模型服务。问题在于客户端属于不可信环境,密钥一旦随包发布,就很难阻止提取和滥用,限额也难以按玩家、房间或账号统一控制。
更稳妥的方式是客户端只发送业务请求,例如“生成这个 NPC 对当前战斗的战术意图”,服务端再补充允许暴露的系统上下文、选择模型参数,并使用服务端凭证调用模型。客户端收到的是经过约束的游戏结果,而不是模型访问权限。
下面是一个最小的服务端代理示例。它刻意不接收模型 API Key,也只把白名单字段交给生成层。
from flask import Flask, request, jsonify
app = Flask(__name__)
ALLOWED_INTENTS = {"suppress", "retreat", "focus", "flank"}
@app.post("/api/npc-intent")
def npc_intent():
data = request.get_json(force=True)
player_hp = int(data.get("player_hp", 100))
threat = str(data.get("threat", "unknown"))[:64]
# 只接收业务需要的字段,避免把原始客户端请求直接转发给模型。
if not 0 <= player_hp <= 100:
return jsonify({"error": "invalid player_hp"}), 400
# 这里代表服务端调用模型;生产环境应接入实际模型客户端。
intent = "retreat" if player_hp < 25 else "focus"
if intent not in ALLOWED_INTENTS:
return jsonify({"error": "invalid generated intent"}), 502
return jsonify({"intent": intent, "threat": threat})
if __name__ == "__main__":
app.run(host="127.0.0.1", port=8000)预期结果:启动服务后,向 /api/npc-intent 发送 player_hp=20 的 JSON 请求时,服务端返回状态码 200,响应中的 intent 为 retreat;非法生命值会返回 400。
HTTP 200
{"intent":"retreat","threat":"boss"}延迟、成本与数据控制怎么权衡
服务端调用增加了一次游戏客户端到业务服务的网络链路,但换来了统一认证、限流、日志和内容策略。实时游戏中应把输入压缩到真正影响结果的状态,例如角色位置、生命值、冷却和威胁目标,而不是上传完整历史。
成本也不只由模型价格决定。客户端直连虽然少一跳,却难以统一限制请求频率;服务端和后台流水线可以做缓存、批处理、超时、重试和模型降级,因此更容易形成可控的成本边界。
数据控制则决定了哪些内容根本不能离开受控环境。包含账号信息、未公开关卡设计、内部运营规则或其他敏感内容时,应优先让服务端决定数据最小化策略;能预生成的内容则尽量放入后台流水线。
什么时候客户端调用仍然合理
客户端调用并非绝对禁止。它更适合不需要秘密凭证、允许离线运行、数据不敏感,并且模型能力已经被打包进客户端或由平台安全机制提供保护的场景。例如本地规则型文本变换、缓存中的小型模型推理,都可以减少网络依赖。
实际项目通常不是三选一,而是分层:实时且受规则约束的游戏决策走服务端,需要大量内容的生成进入后台流水线,客户端只负责展示、交互和提交最小业务输入。这样既保住游戏响应体验,也把凭证、成本和数据控制留在可以治理的位置。