令牌管理
API 令牌是应用调用模型 API 的访问凭证。在控制台的 令牌管理 中，您可以设置应用可调用的模型、允许的请求来源和用量上限。
建议先了解模型范围和限额，再创建令牌或设置团队共享额度。已有凭证的管理方式见重新获取密钥和暂停、恢复或删除令牌。
规划模型范围和用量限额
根据需要控制的范围，选择相应设置：
| 需求 | 使用的设置 |
|---|---|
| 应用只能调用指定模型 | 关联包含这些模型的 模型配置，并通过统一 Base URL 发起请求。每个令牌关联一份模型配置。 |
| 多个应用共用一份额度 | 将令牌加入同一 令牌组，设置组限额。每个令牌只能归属一个组。 |
| 为单个应用设置上限 | 设置令牌自身的 令牌限额，可单独使用，也可与组限额同时使用。 |
| 跨团队或环境查找相关令牌 | 使用 标签，不改变访问权限或限额。 |
令牌组也可以只用于汇总分析，不设置共享限额。未加入组的令牌显示在 未分组 中；未分组没有共享限额，不能像普通组一样编辑或删除。
查看配置、管理令牌和令牌组、新建模型配置、获取密钥分别需要相应权限。无法执行某项操作时，请联系主账号管理员。列表中的 系统信息（ⓘ）可查看账号的令牌和令牌组数量上限。
使模型范围限制生效
只有应用通过统一 Base URL 发起请求时，关联模型配置的范围限制才会生效，仅选择配置并不足以完成限制。协议与地址的对应关系见选择协议和调用地址。
选择限额指标和周期
按需启用自然日、自然周或自然月限额。每个周期选择一种指标，并填写正整数限额值。
| 限制类型 | 数值含义 |
|---|---|
| 牌价金额 | 按模型牌价计算、折算为 USD 的消耗金额，未扣除折扣，不代表最终账单的金额上限。 |
| 请求数 | API 请求次数。 |
| 总Token数 | Token 用量，按单个 Token 填写，而非按百万填写。例如，限制为一百万 Token 时应输入 1000000。 |
所有已启用周期的限额同时生效。达到任一适用周期的上限后，即使其他周期仍有余额，调用也会受限。关闭某个周期只会取消该周期的限制。
令牌限额与组限额也同时生效。 令牌达到自身限额，会暂停使用该令牌的调用；组达到限额，会暂停组内所有令牌的调用。例如，组每日限额为 1,000 USD，某应用的令牌每日限额为 100 USD，该应用达到 100 USD 后就会受限；如果团队先用完 1,000 USD，该应用也会一起受限。令牌自身的限额不会增加组的共享额度。
限额周期采用账号时区，可在账号管理 > 个性设置或 系统信息 > 统计时区 中查看。账单另有计费时区。如果业务安排依赖自然周的具体起始时间，请向支持人员确认。统计显示可能存在时延，不能仅凭图表判断准确的重置时刻或调用是否已恢复。
创建令牌组，共享团队额度
多个应用需要共享额度或一起分析用量时，可以先建组；否则可直接创建令牌。
在 令牌管理 > 新建令牌组 中，填写主账号内唯一的名称和可选描述。名称支持中文、英文、数字、中划线和下划线，长度为 2–50 个字符。在 限额配置 中启用所需周期，分别选择指标并填写数值，然后确认。之后可在新建令牌时选择该组，也可将已有令牌移入组内。
如果组已创建，但限额保存失败，请在该组的 配置信息 中编辑 限额配置，重新保存，继续使用已创建的组。
为应用创建令牌
选择 新建令牌，按应用需要配置访问范围：
- 确定名称和使用期限。 名称需在主账号内唯一，可按应用和环境命名，例如
support-production。名称与组名一样，支持上述字符，长度为 2–50 个字符。将 过期时间 设为未来的日期和时间，到期后令牌失效。 - 选择初始状态和分组。 启用状态 默认为 启用；提前准备的凭证可先设为 禁用。在 令牌组(ID) 中选择所属组，或保留为未分组。
- 设置模型范围。 在 关联模型配置 中选择包含所需模型的配置。如果应用只能访问一个模型，应使用仅包含该模型的配置，并通过统一 Base URL 发起请求。没有合适的配置时，可使用 新建配置，填写名称和可选描述，明确选择所需的 模型范围 后确认，再核对令牌表单中选中的配置。无法创建配置时，请管理员提供合适的配置或授予相应权限。
- 限制请求来源和用量。 IP白名单 支持 IPv4、IPv6 和 CIDR 网段，每行一条，最多 50 条。请填写网关接收到应用请求时所使用的来源地址；留空表示不设置令牌级 IP 限制。应用需要独立上限时，设置 令牌限额。
- 按需添加标签。 选择已有标签，或输入名称后按 Enter，便于之后查找。每个令牌最多关联 20 个标签。
- 确认创建后，从结果弹窗中复制完整令牌并妥善保存。请勿将密钥放入共享文档、截图或代码仓库。
如果令牌已保存，但限额保存失败，编辑该令牌并重新保存限额即可。重新创建会产生另一份凭证。
接入时，在 模型广场 打开目标模型的 API示例，获取配套的请求地址和认证方式，详见模型广场指南。
查找令牌或重新获取密钥
按名称或 ID 搜索，或按令牌组、启用状态、标签、模型配置、是否设置 IP 白名单筛选，再点击 查询。展开组可查找其中的令牌，点击令牌名称可查看配置。
部署应用时，如需重新获取凭证：
- 选择目标令牌操作列中钥匙形状的 查看令牌。
- 按提示通过账号的手机或邮箱完成身份验证。
- 从结果弹窗中复制令牌。即使显示为掩码，复制获取的仍是完整密钥。
名称旁的 ID 用于标识和查找管理记录，不能作为 API 访问凭证。能够查看配置，不代表同时具有获取密钥的权限。
调整访问规则或所属团队
应用需要更换模型配置、请求来源、有效期、限额或标签时，可编辑现有令牌。修改模型范围或来源限制前，应检查对应用调用的影响，再确认保存。
调整所属团队时，请从 令牌管理 主列表编辑令牌，选择目标组或 未分组。移动后，目标组的限额随之适用。在原普通组中记录的历史消耗仍归属于原组；历史统计的归属不能说明当前周期的限额计数如何处理。如需通过移组调整可用额度，请先向支持人员确认计数规则。
批量修改令牌
筛选并勾选目标令牌后，使用 批量操作 > 批量修改令牌。IP 白名单需逐个编辑。
| 需要修改的内容 | 操作方式 |
|---|---|
| 分组或状态 | 选择新值；保留“不修改”则沿用原值。 |
| 过期时间、模型配置或限额 | 分别勾选 覆盖过期时间、覆盖关联模型配置 或 覆盖限额配置，再填写完整的替换设置。 |
| 标签 | 不操作则保留原标签；提交时应提供完整的新标签集合，新标签会替换原标签，而非追加。 |
覆盖限额会替换整套规则。 例如，原令牌有每日和每月限额，替换设置中却只有每日限额，原有每月规则就会被移除。需要保留的周期应一并配置；各令牌所需规则不同时，应分批处理。
提交前请核对已选数量。主列表的组复选框会跨分页选中组内符合已应用筛选条件的令牌；组详情 配置信息 中的表头全选仅作用于当前页。
查看消耗，调整额度
打开组的 统计分析，可查找用量较高的应用，或查看一段时间内的消耗变化。选择 本日、本周、本月 或 自定义；自定义日期限近六个月，最长跨度为一个月。
通过 消耗排行 按牌价金额比较令牌用量，展开令牌可查看其 Top 10 模型，点击可用的令牌名称可查看单个令牌的统计分析；通过 消耗趋势 查看变化。牌价金额未扣除折扣，统计分析会按 系统信息 中的参考汇率将非美元金额折算为 USD，显示金额保留两位小数。
Token 用量中的 M 表示百万。缓存命中率 = 缓存命中 Token 数 ÷ 输入总 Token 数 × 100%。例如，4,000 个输入 Token 中有 1,000 个来自缓存，命中率为 25%；这既不是使用缓存的请求占比，也不是费用节省比例。
区分限额进度与历史消耗
额度使用情况 展示额度消耗，可与排行和趋势分开刷新。统计可能存在时延。
- 组进度始终显示当前限额周期，不随统计日期筛选变化。
- 单个令牌的限额进度对应所选的本日、本周或本月，且需存在匹配的限额。选择自定义日期后，排行中的限额列显示短横线，单个令牌统计页不展示限额进度。
- 令牌移出普通组后，仍可能出现在原组的历史排行中，并标记为“已移除”，但不能再从该行打开详情。
- 未分组 没有共享限额进度或组汇总图表。其排行统计当前未分组令牌在所选日期范围内的用量，也包含这些令牌移入未分组之前的消耗。
调整团队额度时，在组的 配置信息 中编辑 限额配置。只有某个应用需要不同上限时，应调整该令牌自身的限额。
管理标签
使用 production 等标签，可跨组查找相关令牌。在 标签管理 中可新增、重命名或删除标签。名称需在主账号内唯一，支持中文、英文、数字、中划线和下划线，长度为 2–20 个字符；主账号内最多可创建 20 个标签。
重命名会同步更新所有关联令牌上的标签名称。删除标签只解除关联，不会删除令牌或停止调用。各项操作分别保存，关闭弹窗不会撤销已保存的变更。
导出配置清单
通过主列表中 ⓘ 旁的导出图标，可导出 CSV 配置清单。文件记录令牌 ID、名称、分组、标签、IP 白名单、限额、状态、过期时间及相关时间信息，不包含密钥，也不是用量报表。列表无数据时无法导出。
将文件作为完整清单使用前，请核对导出的令牌 ID 和行数是否覆盖预期范围，尤其是在使用筛选或涉及多个分页时。
暂停、恢复或删除令牌
| 应用的需要 | 操作及影响 |
|---|---|
| 暂时停用，以后仍使用同一凭证 | 编辑令牌，将 启用状态 设为 禁用，保留令牌和配置。 |
| 在指定时间结束访问 | 设置 过期时间，到期后令牌失效。 |
| 恢复已停用的凭证 | 检查有效期以及令牌、组限额后，将 启用状态 设为 启用。 |
| 应用下线，或已完成凭证替换 | 删除令牌，原凭证无法恢复。 |
暂停或恢复使用
启用 记录的是手动设置的状态，并不保证调用成功。令牌过期、令牌或组限额耗尽，以及模型范围或请求来源不匹配，都可能阻止访问。恢复业务流量前，应先处理相应限制。
删除令牌和空组
删除前，请确认应用已不再使用该令牌。如果是在更换凭证，应先更新应用，确认替代令牌可用。
使用令牌的删除操作，或勾选多个令牌后选择 批量操作 > 批量删除令牌。按前文的选择范围规则核对名称和数量，再确认删除。
组内没有令牌时才能删除该组，应先移走或删除组内令牌。不能通过删除非空组来批量停止应用调用。