API Keys 管理

API Key 是调用 Router 的唯一凭证。在控制台「API Keys」页自助管理，所有操作即时生效。

签发 Key

1. 进入控制台「API Keys」页（或「快速接入」页第一步），点击签发 Key。
2. 填写字段：
   • 用途备注（必填）：给 Key 起个能认出来的名字，如 prod、实验、客户A。会作为 Key 名称的一部分展示在列表里。
   • 可用模型（可选）：限定该 Key 可调用的模型，逗号分隔；留空 = 可调用全部模型。
   • 限额（可选，单位 ¥）：两种模式二选一——
     • 总额：累计花费达到总额后调用被拒（429）。用完即止——不会自动恢复，需要时在限额弹窗点清空已用量复位；
     • 周期：按每日 / 每周 / 每月限额，三个窗口可任选也可叠加（任一窗口超限即拒）。窗口到点自动重置（自然日/自然周/自然月，按东八区边界）。
3. 签发成功后弹窗展示 Key 明文。

明文仅此一次

Key 明文只在签发时展示一次，服务端不保存明文。请立即复制保存；丢失只能删除重签。

Key 的保管

• 不要把 Key 提交到代码仓库、贴到聊天工具或写进前端代码
• 怀疑泄露：立即在「API Keys」页删除该 Key（删除后立即失效且不可恢复），再签一个新的
• 建议生产与测试环境使用不同的 Key，配合「可用模型」与「限额」做隔离

列表字段

字段	说明
名称	签发时的用途备注（Key 别名）
key	脱敏前缀，用于辨认（非完整明文）
可用模型	该 Key 可调用的模型范围；「全部」= 不限
状态	正常 / 已禁用（如触发限额策略）
限额	限额配置与当前已用量：总额显示「已用 / 总额」；周期按配置的窗口逐项显示「日/周/月 已用 / 限额」；「不限」= 未设置
创建时间 / 最近调用	用于盘点 Key 的使用情况（最近调用按近 7 天调用记录计）

调整限额

在列表行尾点限额，弹窗中切换模式或修改金额后保存，即时生效。选「不限」= 清除限额。

总额模式下弹窗底部有清空已用量按钮：把已用总额归零、Key 立即恢复可用（周期窗口到点自动重置，无需手动清）。

删除 Key

在列表行尾点删除并确认。删除后该 Key 立即无法调用，且不可恢复——需要时再签发新 Key。