大模型服务平台 TokenHub API Key 管理

一、API Key 列表

字段	说明
名称 / Key ID	自定义的 API Key 名称，Key ID 用于分账账单查询 Key 的对应标识，详情参考账单分账。
说明	自定义的 API Key 说明，方便识别用途。
Key	调用 TokenHub 服务的身份凭证，脱敏显示（前 5 位 + *** + 后 4 位），支持一键复制完整 API Key。
状态	启用/禁用。你可以通过状态开关切换 API Key 的启用、禁用状态。禁用状态下，被禁用 API Key 的所有 API 请求将被拒绝。
用量监控	查看当前 APIKey 的 token 消耗走势、模型消耗排行、请求调用量统计。
访问范围	全部（可访问所有模型和服务）。限定范围（包含模型对应的默认和自定义推理服务接入点）。
额度限制	限制 API Key 的使用用量，默认状态不开启。若已经超过你配置的周期内上限，超过后则调用失败。
创建时间	API Key 首次创建时间。
操作	编辑：修改 API Key 的访问范围及关联的模型/服务。删除：永久删除 API Key，需二次确认。删除后使用该 API Key 的所有请求将立即失败。

1. 进入 API Key 管理页面。

2. 在页面上方选择地域后，单击创建 API Key。

3. 在创建 API Key 对话框进行配置：

·Key 名称：例如 “生产环境-文本服务”、“测试用 Key”。

·说明（选填）：为 API Key 设置说明，方便识别和区分用途。

·IP 白名单：设置允许访问此 Key 的 IP 范围，支持设置 IP 网段，最多允许设置 200 个。

·额度限制：开启后该 API Key 的 token 用量达到配额上限将停止服务，用量统计不区分模型与推理服务接入点（免费包不计算入内）。

·限额策略：支持日/月/总额度三种限额周期，切换限额策略（如日 → 月）或修改月度生效日后，历史用量将清零，并按新规则重新累积。

·生效范围：根据你选择的策略周期配置。

·日：按自然日统计，每日 00:00 重置用量重新累积。

·月：按所选生效日统计，周期结束自动重置。如选每月 3 日则统计本月 3 日 00:00 至次月 2 日 23:59。

·总额度：开启后持续累积用量，不自动重置。

·额度上限：单位为 tokens。

·可访问范围：

·全选：可访问你账号下的所有模型和推理服务。

·限定范围：你可以在可访问范围区域勾选可访问的推理服务，实现访问范围控制。平台为每个模型创建一个默认在线推理服务，勾选效果等同于授权模型级的访问，支持基于“模型品牌”和“类型”细粒度筛选。

4. 单击确定，完成创建。

创建完成后，请你务必复制并妥善保管 API Key，在后续调用 API 流程中将会使用该信息。

注意：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 的所有服务调用将立即失效。删除时，会触发账号身份校验，请知悉。

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 创建后，请立即保存到安全位置。