#智能体鉴权

#Key 策略

• 一智能体一 Key:每个智能体/每套环境独立子 Key,名称写明用途;泄露时单点吊销(见 API Keys)。
• Key 只在服务端;客户端直连仅用于个人脚本场景。
• 限额即隔离:平台可为 Key 设置消费配额,触顶 402(1013)。智能体失控重试的损失被限制在该 Key 的配额内。

#轮换

「先建后吊」:新 Key 部署 → 确认流量切换 → 吊销旧 Key。智能体运行中断连的会话以 4021 关闭码体现;重试时使用新 Key。

#与 OpenAI SDK 的组合

OpenAI SDK 以 apiKey 传 Reelway Key;同一智能体的媒体面(@reelway/client)用同一把 Key。不要在两端使用不同账户——余额与用量对账会割裂。