API KEY 管理
上图为 API KEY 管理页面。页面上方提供筛选和新建入口，中间列表展示 API Key 的基础信息、状态、限额、路由策略和可执行操作。
页面字段
API Key 列表包含以下字段：
：API Key 的业务名称，建议使用业务、环境或团队名称命名。名称
：API Key 的脱敏展示，用于识别凭证。API KEY
：显示当前 API Key 是否启用。状态
：展示已使用 Token 和 Token 上限。限额
：展示当前 API Key 使用的供应商路由方式。路由策略
：支持路由策略、编辑、复制、禁用、删除、查看用量等操作。操作
页面顶部提供筛选能力：
：可按全部、正常、禁用筛选。状态
：可按全部、当前用户或指定用户筛选。操作人
新建 API Key
操作步骤：
- 进入
。API KEY 管理 - 点击右上角
。新建 - 在弹窗中填写 API Key 名称。
- 选择限额周期。
- 填写 Token 限额。
- 点击
创建。确定
字段说明：
：API Key 的显示名称，用于区分业务或环境。名称
：用于控制 Token 限额的生效周期。限额周期
：限制该 API Key 可消耗的 Token 数量。Token 限额
建议为不同业务、不同环境分别创建 API Key，便于后续统计、限额控制和问题排查。
编辑 API Key
在 API Key 列表中点击
编辑- 名称
- 限额周期
- Token 限额
编辑不会改变 API Key 的调用身份，但可能影响限额控制。调整生产环境 API Key 限额前，建议先确认当前业务调用量。
复制 API Key
点击
复制- 路由策略
- 限额
- 限额周期
该功能适合为相似业务、测试环境或新团队快速创建配置一致的 Key。
禁用与删除
：停用该 API Key。禁用后，使用该 Key 的调用会受到影响。禁用
：删除该 API Key。删除操作应谨慎执行。删除
在禁用或删除 API Key 前，建议先通过
查看用量查看用量
点击
查看用量用量统计常见用途：
- 排查某个 Key 的调用量。
- 查看 Token 消耗趋势。
- 定位异常请求或突增用量。
路由策略
点击 API Key 行内的
路由策略路由策略支持三种模式：
：系统在平台内置供应商和用户已绑定的 BYOK 供应商中自动排序调用。默认
：手动选择供应商，并通过拖拽调整供应商优先级。指定供应商
：仅使用用户绑定的 BYOK Key 调用上游，全部不可用时才报错。仅 BYOK
默认模式下，系统支持三种供应商排序策略：
：优先选择价格最低的供应商。如果最低价供应商不可用，再按价格从低到高依次尝试。如果同一价格存在多个平台内置供应商，则会在这些供应商之间随机路由。价格优先
：优先选择高吞吐量供应商，适合更关注并发能力和处理吞吐的场景。吞吐优先
：优先选择低延迟供应商，适合更关注响应速度的在线调用场景。延迟优先
默认模式和指定供应商模式都会同时覆盖平台内置供应商和用户已绑定的 BYOK 供应商。当同一供应商同时存在用户 BYOK 和平台内置能力时，系统会优先使用用户的 BYOK；如果 BYOK 调用不可用，再回退到平台内置模型供应商。
指定供应商模式下，供应商列表顺序代表调用优先级。排在前面的供应商优先调用，当高优先级供应商不可用时，系统会按顺序故障转移。
仅 BYOK 模式只从已绑定的 BYOK Key 中选择供应商，列表顺序即调用优先级。该模式不会回退到平台内置供应商；当全部 BYOK Key 都不可用时，调用会报错。
使用建议
- 普通业务可优先使用默认路由。
- 对供应商、成本或稳定性有明确要求的业务，可使用指定供应商。
- 必须使用企业自有密钥的业务，可选择仅 BYOK。
- 生产环境和测试环境建议使用不同 API Key。
- 不要在代码仓库、日志或截图中暴露完整 API Key。
联系我们