> For AI agents: the complete documentation index is available at https://docs.reelway.ai/llms.txt, the full documentation bundle is available at https://docs.reelway.ai/llms-full.txt.

# 智能体鉴权

## Key 策略

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

## 轮换

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

## 与 OpenAI SDK 的组合

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