跳到主要内容

创建与管理 API Key

API Key 用于访问推理网关,不用于登录管理控制台。平台管理员在管理员端的 开发者工具 → API Key 管理平台直发 Key;租户成员在租户端的 核心功能 → API Key 管理所属租户的 Key。两处同名菜单的数据范围不同。

创建租户 Key​

  1. 在租户端打开 核心功能 → 模型市场,确认目标模型已对当前租户开放,并记下它的对外模型名称。
  2. 打开 API Key → 创建 Key,填写便于识别的名称,例如 production-service。
  3. 在 授权模型 中选择允许调用的模型。留空表示当前租户全部可用模型,不是平台上的所有模型;后续新开放的模型也会进入这个范围。如果需要固定访问范围,请明确选择模型。
  4. 按需要设置过期时间;在 展开更多 中设置 RPM、TPM、总 Token 配额和预算上限。空值表示该项不限,但仍受租户余额、模型状态及平台规则约束。
  5. 创建并复制密钥,在应用的服务端密钥管理中保存。不要放入浏览器代码、公开仓库或日志。
密钥显示方式

创建成功弹窗显示完整密钥。当前版本的列表也会向有相应查看权限的管理端返回完整明文,界面中间省略显示并提供复制;它不是“只在创建时显示一次”的凭据。请严格控制 API Key 页的查看权限。

平台 Key 与租户 Key​

平台直发 Key租户 Key
创建入口管理员端 开发者工具 → API Key租户端 核心功能 → API Key
所属范围平台域当前租户
模型限制留空所有已发布模型当前租户可用的已发布模型
余额与封禁不按租户钱包扣费或校验租户封禁受租户余额、模型封禁及租户状态约束

管理员 API 可以指定 tenant_id 为某个租户签发 Key,但当前管理员界面的创建表单使用平台域。给业务应用接入租户服务时,优先在对应租户端创建 Key。

管理员端创建平台 Key 时,表单先显示名称、授权模型和过期时间;展开更多后可设置四项用量限制。下图是管理员端的平台 Key 表单,租户端应在自己的控制台操作。

管理员端新建 API Key 基本字段
授权模型留空表示平台范围内的全部已发布模型。
管理员端 API Key 的 RPM、TPM、Token 和预算限额
“展开更多”可分别设置 RPM、TPM、总 Token 配额和预算上限。

调整或停用​

在 Key 列表中可以调整授权模型、期限与限额,或启用、禁用、删除 Key。禁用后该 Key 立即失效;删除后不能恢复。重置预算会清除已消费累计和该 Key 的 Token 配额计数,不会更改配置的上限;请先确认业务周期和计费策略。

为不同应用和环境分别签发 Key。轮换时先创建新 Key、更新应用并验证调用,再停用旧 Key。请求可使用 Authorization: Bearer <KEY>;Anthropic 客户端也可使用 x-api-key: <KEY>。见调用推理 API和API 参考。