API Key 管理

最近更新时间:2026-04-24 11:46:41

我的收藏
API Key 是调用大模型服务平台 TokenHub 服务的身份凭证,长期有效。您可以在 API Key 管理 页面创建、编辑、启停和删除 API Key,并为每个 API Key 设置精细的访问范围。
注意:
API Key 长期有效,请在请求时通过请求头携带,并妥善保管,定期更新。请勿在公开环境中分享或泄露,以防未授权访问造成安全隐患或资金损失。

API Key 使用限制

1. 单个主账号 API Key 默认创建个数上限为 50 个,如您有更多使用需求,请 提交工单 申请。
2. API Key 中暂不包含 Coding plan、Token plan 生成的 Key,二者的 Key 创建个数也不受此处默认值限制。

API Key 列表

字段
说明
名称
自定义的 API Key 名称。
说明
自定义的 API Key 说明,方便识别用途。
Key
脱敏显示(前 5 位 + *** + 后 4 位),支持一键复制完整 API Key。
状态
启用/禁用。
您可以通过状态开关切换 API Key 的启用、禁用状态。禁用状态下,被禁用 API Key 的所有 API 请求将被拒绝。
访问范围
全部(可访问所有模型和服务)。
限定范围(仅可访问勾选的模型/服务)。
创建时间
API Key 首次创建时间。
操作
编辑:修改 API Key 的访问范围及关联的模型/服务。
删除:永久删除 API Key,需二次确认。删除后使用该 API Key 的所有请求将立即失败。

创建 API Key

1. 进入 API Key 管理 页面。
2. 在页面上方选择地域后,单击创建 API Key。
3. 创建 API Key 对话框进行配置:
Key 名称:例如,"生产环境-文本服务"、"测试用 Key"。
说明(选填):为 API Key 设置说明,方便识别用途,区分 API Key 的用途。
可访问范围
全选:可访问您账号下的所有模型和推理服务。
限定范围:您可以在可访问范围区域左、右两侧勾选可访问的模型和/或推理服务,实现访问范围控制。

4. 单击确定,完成创建。
创建完成后,请您务必复制并妥善保管 API Key,在后续调用 API 流程中将会使用该信息。
注意:
API Key 名称和 API Key 值创建后不可修改。

编辑 API Key

1. 进入 API Key 管理 页面。
2. 在页面上方选择目标 API Key 所属地域,找到 API Key。
3. 在 API Key 右侧的操作列单击编辑。
4. 您可以在编辑 API Key 对话框修改 API Key 说明或 API Key 的访问范围。
注意:
切换为新的指定范围后,上次选择的访问范围将失效,以本次切换后的范围为准。
5. 单击确定,保存更改。

删除 API Key

注意:
删除 API Key 后将无法恢复,使用该 API Key 的所有服务调用将立即失效。删除时,会触发账号身份校验,请知悉。
1. 进入 API Key 管理 页面。
2. 在页面上方选择目标 API Key 所属地域,找到 API Key。
3. 在 API Key 右侧的操作列单击删除
4. 确认删除 API Key 对话框确认删除信息无误后,单击确认,完成删除。


使用建议

建议
说明
按用途分配 API Key
为不同应用或环境(开发/测试/生产)创建独立的 API Key。
最小权限原则
使用指定范围限制 API Key 仅能访问所需的模型和服务。
及时轮换 API Key
定期更换 API Key,降低泄露风险。
禁用不用的 API Key
不再使用的 API Key 应及时禁用或删除。
妥善保管 API Key
API Key 创建后,请立即保存到安全位置。