创建与管理 API Key
API Key 用于访问推理网关,不用于登录管理控制台。平台管理员在管理员端的 开发者工具 → API Key 管理平台直发 Key;租户成员在租户端的 核心功能 → API Key 管理所属租户的 Key。两处同名菜单的数据范围不同。
创建租户 Key
- 在租户端打开 核心功能 → 模型市场,确认目标模型已对当前租户开放,并记下它的对外模型名称。
- 打开 API Key → 创建 Key,填写便于识别的名称,例如
production-service。 - 在 授权模型 中选择允许调用的模型。留空表示当前租户全部可用模型,不是平台上的所有模型;后续新开放的模型也会进入这个范围。如果需要固定访问范围,请明确选择模型。
- 按需要设置过期时间;在 展开更多 中设置 RPM、TPM、总 Token 配额和预算上限。空值表示该项不限,但仍受租户余额、模型状态及平台规则约束。
- 创建并复制密钥,在应用的服务端密钥管理中保存。不要放入浏览器代码、公开仓库或日志。
密钥显示方式
创建成功弹窗显示完整密钥。当前版本的列表也会向有相应查看权限的管理端返回完整明文,界面中间省略显示并提供复制;它不是“只在创建时显示一次”的凭据。请严格控制 API Key 页的查看权限。
平台 Key 与租户 Key
| 平台直发 Key | 租户 Key | |
|---|---|---|
| 创建入口 | 管理员端 开发者工具 → API Key | 租户端 核心功能 → API Key |
| 所属范围 | 平台域 | 当前租户 |
| 模型限制留空 | 所有已发布模型 | 当前租户可用的已发布模型 |
| 余额与封禁 | 不按租户钱包扣费或校验租户封禁 | 受租户余额、模型封禁及租户状态约束 |
管理员 API 可以指定 tenant_id 为某个租户签发 Key,但当前管理员界面的创建表单使用平台域。给业务应用接入租户服务时,优先在对应租户端创建 Key。
管理员端创建平台 Key 时,表单先显示名称、授权模型和过期时间;展开更多后可设置四项用量限制。下图是管理员端的平台 Key 表单,租户端应在自己的控制台操作。


调整或停用
在 Key 列表中可以调整授权模型、期限与限额,或启用、禁用、删除 Key。禁用后该 Key 立即失效;删除后不能恢复。重置预算会清除已消费累计和该 Key 的 Token 配额计数,不会更改配置的上限;请先确认业务周期和计费策略。
为不同应用和环境分别签发 Key。轮换时先创建新 Key、更新应用并验证调用,再停用旧 Key。请求可使用 Authorization: Bearer <KEY>;Anthropic 客户端也可使用 x-api-key: <KEY>。见调用推理 API和API 参考。