进入控制台

API Keys 管理

API Key 是调用 Router 的凭证。在控制台「API Keys」页自助管理；运营管理员也可在组织管理中查看和维护指定组织的 Key。

签发 Key

进入控制台「API Keys」页（或「快速接入」页第一步），点击签发 Key。
填写字段：
- 用途备注（必填）：给 Key 起个能认出来的名字，如 prod、实验、客户A。会作为 Key 名称的一部分展示在列表里。
- 可用模型（可选）：从下拉列表中勾选该 Key 可调用的模型（候选即贵组织当前可见的全部模型）；留空 = 可见的全部模型。
- 调用限制（可选）：单个 Key 跨模型、跨三种协议合计限制——
  - 每分钟请求数：固定自然分钟内允许准入的请求数；请求内的通道重试不重复计数。
  - 每分钟 Token 数：按上游实际返回的用量控制后续请求。没有用量信息时不估算。
  - 同时处理请求数：同一时刻允许处理的请求数；流式请求在整个响应期间占用名额。留空表示该项不限。达到限制的新请求返回 429，客户端应根据 Retry-After 响应头稍后重试。
- 限额（可选，单位 ¥）：两种模式二选一——
  - 总额：累计花费达到总额后调用被拒（429）。用完即止——不会自动恢复，需要时在限额弹窗点清空已用量复位；
  - 周期：按每日 / 每周 / 每月限额，三个窗口可任选也可叠加（任一窗口超限即拒）。窗口到点自动重置（自然日/自然周/自然月，按东八区边界）。
签发成功后弹窗展示 Key 明文。

明文仅此一次

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

Key 的保管

不要把 Key 提交到代码仓库、贴到聊天工具或写进前端代码
怀疑泄露：立即在「API Keys」页删除该 Key（删除后立即失效且不可恢复），再签一个新的
建议生产与测试环境使用不同的 Key，配合「可用模型」与「限额」做隔离
可用模型的可选范围由平台按组织授权配置；看不到预期模型时请联系平台确认组织的可见范围

列表字段

字段	说明
名称	签发时的用途备注（Key 别名），可通过编辑修改
key	脱敏前缀，用于辨认（非完整明文）
可用模型	该 Key 可调用的模型范围；「全部」= 组织当前可见范围不限
状态	正常 / 已禁用（管理员通过编辑停用）
调用限制	每分钟请求数 / 每分钟 Token 数 / 同时处理请求数；「不限」= 未设置
限额	限额配置与当前已用量：总额显示「已用 / 总额」；周期按配置的窗口逐项显示「日/周/月已用 / 限额」；「不限」= 未设置
创建时间 / 最近调用	用于盘点 Key 的使用情况（最近调用按近 7 天调用记录计）

修改名称、模型范围与启停

在列表行尾点编辑：

名称：修改用途备注，不改变 Key 明文、归属员工、限额或历史记录。
可用模型：保存后整体替换该 Key 的白名单；留空 = 组织当前可见范围不限。只能选择本组织专区内的模型或模型池，不能借此访问其他专区的资源。
状态：停用后，后续新请求返回 401；配置、额度、归属及历史记录保留。恢复后，原 Key 可继续使用，无需重新签发。
调用限制：可分别修改或清空每分钟请求数、每分钟 Token 数和同时处理请求数；未修改的项保持原值。修改只影响后续新请求，不中断在途响应。

请求数与 Token 数采用 UTC 自然分钟窗口。Token 用量在收到上游实际用量后才计入，因此多个在途请求可能使当前分钟总量暂时超过配置值；该限制不是每个分钟绝不超量的预留额度。调用限制与金额预算分别计算，不互相扣减。

计数服务暂时不可用时，为保证业务可用，调用会放行；恢复后继续按共享计数限制。修改限额的其他实例生效窗口与停用/恢复相同。

停用不会主动中断已建立的流式响应，也不会回滚已产生的用量。写操作由接收请求的实例立即刷新，其他实例通过刷新通知或周期同步生效，可能存在短暂窗口。删除仍是单独的不可恢复操作。

调整限额

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

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

删除 Key

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