密钥管理

密钥管理

> API 密钥是大模型网关调用的凭证：正式密钥走申请审批链签发、数据等级不走过场，日常扩容在工作区直接新建；配置可调、消耗可见、失效可控，覆盖从签发、配置到吊销的全生命周期管理。

两条签发路径

申请单要写清用途（应用名、模型清单、额度上限）、场景（使用场景、应用地址、负责人）、等级（数据安全等级、端点场景），提交后由管理员审批。状态机完整：草稿 → 已提交 → 批准 / 驳回 / 撤回，驳回附原因、可改后重新提交。

两条硬纪律：

1. 申请人不能批自己的单——自批在入口即被拦截；

2. 数据等级调整也走审批——已签发密钥想升降等级，须另起一张变更审批单（调整原因必填），批准后申请单与密钥两处状态同时写回，调用行为立即随新等级变化：原来被 403 拒的调用当场放行，原来能调的越级调用当场被拦。等级不是管理员手改的字段，是一张可追溯的审批记录。

密钥配置域

创建（支持一次批量建多把）时可配置：

• 场景：聊天 / 嵌入 / 图像 / 语音等多选，不勾 = 不限场景（限了场景的密钥调错端点会 403 key_scene_mismatch）；
• 额度：金额上限或无限；
• 模型白名单：只允许调用清单内模型；
• IP 白名单：支持 CIDR 网段；
• 过期时间：永久 / 1 个月 / 1 天 / 1 小时，到期自动失效；
• 路由策略：为这把密钥单独覆盖 auto 策略（见智能路由）。

消耗核对

密钥列表展开月度用量卡：今日调用次数、今日额度消耗、本月 Token 与请求数、月度额度进度条——哪把钥匙烧了多少，不用翻日志，卡片直读。四维限额的语义见配额与限流。

调整、禁用与删除

判断口径：影响计费与数据边界的改动必须经他人之手（防自批），日常运维项交给持有者——治理与效率分层。

密钥安全

• 列表、搜索、详情接口里的密钥一律掩码显示；查看完整密钥是独立授权的敏感操作，每次查看都留安全审计记录；
• 系统各日志出口不落完整密钥；
• 密钥泄露的处置：立即删除该密钥（已删密钥立即 401），再走申请签发新密钥，必要时请管理员核查该密钥近期调用流水（见审计与日志）。

常见问题