2. 创建与管理 API Key#
API Key 是调用所有接口的唯一凭证。
获取 API Key（控制台操作流程）#
- 登录 YiTuoToken 控制台。
- 在左侧导航栏点击「API 密钥」，进入密钥管理页。
- 点击「创建 API 密钥」按钮。
- 在弹出的对话框中填写：
- 密钥名称（必填，如「生产环境服务」，用于区分用途）
- 额度上限（可选，留空表示不限制）
- IP 白名单（可选，限制可调用的来源 IP / CIDR）
- 过期时间（可选，到期后自动失效）
- 可用模型白名单（可选，限定该 Key 能调用的模型范围）
- 点击「创建密钥」提交。
- 系统弹出「保存你的新密钥」——完整密钥明文仅此一次显示。点击「复制密钥」保存到安全位置，再点「我已保存」关闭。
关闭弹窗后无法再次查看完整密钥。系统仅存储密钥哈希，明文不落库。若未及时保存，请吊销该密钥并重新创建。
可配置项#
| 配置 | 说明 |
|---|---|
| 名称 | 便于区分用途（如「生产环境」「本地测试」） |
| 配额上限 | 该 Key 可消耗的额度上限，用尽后请求返回 402 |
| IP 白名单 | 限制来源 IP，支持单 IP 与 CIDR 段（逗号分隔） |
| 有效期 | 过期后 Key 自动失效 |
| 模型白名单 | 限定该 Key 可调用的模型范围 |
管理操作#
- 吊销： 密钥泄露或不再使用时立即吊销，吊销后该 Key 的所有请求返回
401。 - 轮换： 建议定期创建新 Key 并逐步替换旧 Key，降低泄露风险。
安全提示： 切勿把 API Key 硬编码进前端代码、公开仓库或客户端 App，应通过环境变量或后端服务持有。