创建 API Key

推理 API Key 在控制台的 API Key 页创建和管理。

前提

• 角色为工作空间的所有者（owner）或管理员（admin）。
• 已开启两步验证：创建 Key 需要二次验证。
• 钱包可用余额不低于开通所需的最低额度（不足时返回 INSUFFICIENT_BALANCE，页面会给出充值入口）。

创建步骤

1. 打开 API Key 页的“创建 API Key”。

2. 填写：

   字段	说明
   名称	1–100 个字符，便于区分用途
   模型白名单	1–20 个模型；这个 Key 只能调用白名单中的模型。可选模型来自页面上的模型目录
   总预算（可选）	这个 Key 一生累计可消费的上限，用满后 Key 自动暂停且不能恢复；留空表示不限
   到期日期（可选）	到期后 Key 自动失效；留空表示不设到期。设置时须晚于当前时间且不超过系统允许的最长有效期

3. 勾选同意算力服务附加条款与可接受使用政策。

4. 完成二次验证。

冻结额度

创建时会从钱包冻结一笔初始额度，用于担保这个 Key 的调用费用：

• 冻结金额取“系统冻结块”“当前可用余额”“剩余预算”三者中的最小值。
• 调用费用从冻结额度中结算扣款；冻结额度用到一定比例或临近到期时自动续冻（开新的冻结、结清旧的冻结）。
• Key 被吊销、暂停或过期后，系统会等待短时间收齐迟到的用量，再结清并释放剩余冻结。

冻结中的金额在钱包页显示为“冻结中”，不能用于其他付款或退款。计费方式见计费。

明文只显示一次

创建成功后，页面显示形如 sk-cmp-… 的 Key 明文，只显示这一次。请立即保存到密码管理器或你的服务的机密配置中。

• 之后列表中只显示 Key 前缀，平台不能找回明文。
• 如果创建请求因网络问题被重放，返回结果不再包含明文；明文丢失时请吊销后重建。
• 不要把 Key 写进前端代码、公开仓库或工单中。

吊销与恢复

• 吊销：立即停止使用该 Key，不可撤销，不需要二次验证（便于在泄露时紧急处理）。
• 恢复：仅适用于部分暂停原因，见暂停与恢复。
• 没有手动“暂停”功能；暂停只由系统根据余额、预算等条件触发。
• 每个工作空间未终结的 Key 数量有上限，达到上限时创建返回 KEY_LIMIT_REACHED。

Key 状态：开通中、有效、已暂停、已吊销、已过期、开通失败。