模型用量

模型用量

模型用量

用于查看 AI Gateway 在指定时间范围内的 Token 消耗、请求量、系统成本、BYOK 成本、平均成本、趋势变化和调用明细。该页面适合用于日常成本观察、账单核对、异常用量排查和 API Key 维度的成本归因。

页面数据会定时刷新，顶部会展示最近更新时间。目前更新时间为 每 10 分钟更新一次。

页面展示金额仅供参考，实际金额以最终出账金额为准。

页面入口

进入 AI Gateway 控制台后，点击左侧导航栏的 用量统计，或直接访问：

<https://aitoken.clickzetta.com/tokens>

顶部筛选区

页面顶部用于控制统计时间范围、统计粒度和数据导出。

控件	说明
`日期范围` 日期范围	选择统计起止日期，例如近 7 天、近 14 天、近 30 天或自定义范围。
`按天` 按天	按自然日聚合展示趋势，适合观察一段时间内的总体变化。
`按小时` 按小时	按小时聚合展示趋势，适合排查短时间内的调用突增或失败率波动。
`导出` 导出	导出当前筛选条件下的统计数据，用于财务核算、内部报表或离线分析。
`刷新` 刷新	手动刷新页面数据。

页面会在统计区提示当前统计范围，例如：

统计区间 2026-05-29 至 2026-06-05 · 共 8 天

调用数据汇总

汇总区以卡片形式展示核心指标，帮助快速判断整体用量、成功率和成本变化。

指标	说明
`总 Token 消耗` 总 Token 消耗	当前统计区间内的总 Token 消耗，包含系统调用和 BYOK 调用，并分别展示 `系统` 系统、 `BYOK` BYOK 的 Token 数。
`总请求数` 总请求数	当前统计区间内的请求总数，包含系统调用和 BYOK 调用，并展示成功率和失败率。
`总成本` 总成本	当前统计区间内的成本汇总。包含系统成本与 BYOK 成本；系统成本以折扣后的价格计算，BYOK成本以页面显示列表价计算。
`平均成本 / 百万 Token` 平均成本 / 百万 Token	总成本 ÷ 总Token × 100 万，用于观察整体单位 Token 成本。该指标不区分具体模型。

指标说明：

```
系统
```
系统
：通过平台内置供应商产生的调用量和费用。
```
BYOK
```
BYOK
：通过用户自有密钥产生的调用量。BYOK 成本通常由用户在云厂商账号中自行结算。
```
成功率
```
成功率
：成功请求数 ÷ 总请求数。
```
失败率
```
失败率
：失败请求数 ÷ 总请求数。
指标右上角的上涨/下降百分比用于展示与上一周期相比的变化趋势。

用量趋势与 Top 消耗

趋势图用于查看成本、Token 和请求数随时间变化的情况；Top 消耗用于快速定位消耗最高的模型或 API Key。

用量趋势

用量趋势

用量趋势

支持切换以下指标：

```
成本
```
成本
```
Token
```
Token
```
请求数
```
请求数

图表上方支持按模型筛选，例如选择

全部模型

全部模型

或指定模型。底部时间轴支持拖拽两端调整观察范围。

使用建议：

成本突增时，先切换到
```
成本
```
成本
指标，定位增长日期或小时。
请求量突增时，切换到
```
请求数
```
请求数
指标，判断是否为业务流量波动。
请求量变化不大但成本升高时，切换到
```
Token
```
Token
指标，检查是否出现长上下文、高输出或高价模型调用。
如果只想分析某个模型，先在模型筛选中选择目标模型，再观察趋势。

Top 消耗

Top 消耗

Top 消耗

支持按不同维度展示排行，例如：

```
按模型
```
按模型
```
按 API KEY
```
按 API KEY

点击任意条目可以查看下钻详情。该功能适合快速定位：

成本最高的模型。
调用量最高的 API Key。
是否出现异常高价模型。
是否有图片、视频、3D 等高成本任务集中发生。

明细表格

页面下方提供明细表格，可按模型、API Key 或账户明细查看消耗来源。

常见页签包括：

页签	说明
`按模型` 按模型	按模型聚合展示请求数、计费用量、输入输出、缓存和成本。
`按 API KEY` 按 API KEY	按 API Key 聚合展示调用量和成本，适合定位具体业务来源。
`账户明细` 账户明细	展示更细粒度的账户级明细，支持查看其他产品（比如Data Agent、Analytics Agent等）调用模型详情，适合账单核对和问题排查。

按模型视图中，表格字段包括：

字段	说明
`模型` 模型	模型名称。
`请求数（系统/BYOK）` 请求数（系统/BYOK）	请求总数，并拆分系统调用和 BYOK 调用。
`计费用量（系统/BYOK）` 计费用量（系统/BYOK）	参与计费统计的用量。不同模型类型的计费用量单位可能不同，例如 Token、秒、张。
`Input（系统/BYOK）` Input（系统/BYOK）	输入 Token 消耗，并拆分系统和 BYOK。
`Output（系统/BYOK）` Output（系统/BYOK）	输出 Token 消耗，并拆分系统和 BYOK。
`缓存创建（系统/BYOK）` 缓存创建（系统/BYOK）	创建上下文缓存产生的 Token。
`缓存命中（系统/BYOK）` 缓存命中（系统/BYOK）	命中上下文缓存的 Token。
`系统成本` 系统成本	平台内置供应商产生的系统成本。
`BYOK 成本` BYOK 成本	BYOK 调用的成本估算或展示值，具体是否计入账单以平台说明和云厂商账单为准。
`操作` 操作	点击 `查看` 查看进入该条目的下钻详情。

说明：

文本模型通常展示 Input、Output、缓存创建和缓存命中。
视频模型可能以秒为计费用量。
图片模型可能以张或图片 Token 为计费用量。
如果某类模型不适用某个字段，表格中可能显示
```
—
```
—
。

下钻详情

点击 Top 消耗或表格中的

查看

查看

后，可以进入下钻详情，查看单个模型或 API Key 在当前时间范围内的详细消耗。

下钻详情通常包含：

区域	说明
`汇总卡片` 汇总卡片	展示当前对象的请求数、计费用量、总成本等指标。
`系统/BYOK 拆分` 系统/BYOK 拆分	展示系统调用和 BYOK 调用的数量或成本拆分。
`趋势图` 趋势图	展示该对象在选定时间范围内的成本或用量变化。
`明细` 明细	按单价、用量、系统成本估算等维度展示具体组成。
`调用情况` 调用情况	展示请求数、计费用量、系统成本、BYOK 成本等细项。

典型用途：

查看某个模型为什么成为 Top 消耗。
分析视频模型按分辨率或秒数产生的成本。
判断成本来自系统供应商还是 BYOK。
排查某个 API Key 是否存在异常调用。

导出数据

点击页面顶部

导出

导出

，可导出当前筛选条件下的数据。

导出前建议确认：

时间范围是否正确。
统计粒度是否符合报表需求。
是否已选择正确维度，例如按模型、按 API Key 或账户明细。
是否需要包含 BYOK 调用量。
是否需要先通过模型筛选缩小范围。

常见排查场景

成本升高

可按以下顺序排查：

查看
```
总成本
```
总成本
和
```
平均成本 / 百万 Token
```
平均成本 / 百万 Token
是否同步升高。
查看
```
Top 消耗
```
Top 消耗
中是否出现新增高价模型。
在明细表中查看
```
Output
```
Output
、
```
缓存创建
```
缓存创建
、
```
缓存命中
```
缓存命中
是否异常。
切换到
```
按 API KEY
```
按 API KEY
，定位是否由某个业务 Key 触发。
点击
```
查看
```
查看
进入下钻详情，分析单价和用量组成。

请求失败率升高

可按以下顺序排查：

查看
```
总请求数
```
总请求数
卡片中的成功率和失败率。
按小时查看失败集中时间段。
切换到 API Key 或账户明细，定位具体业务来源。
结合错误码文档中的
```
requestId
```
requestId
和
```
retry_history
```
retry_history
排查失败原因。

BYOK 调用量异常

如果 BYOK 调用量异常升高：

检查相关 API Key 的路由策略是否配置为
```
仅 BYOK
```
仅 BYOK
或
```
指定供应商
```
指定供应商
。
检查 BYOK 页面中的供应商 Key 是否被多个业务复用。
查看明细表中的系统/BYOK 拆分，确认是否符合预期。
注意 BYOK 成本通常由客户云厂商账号自行计费，AI Gateway 页面展示的系统成本不一定包含 BYOK 云厂商账单。

视频或图片任务费用异常

视频、图片、3D 等模型的计费单位可能不是普通 Token：

视频模型可能按秒、分辨率或任务规格计费。
图片模型可能按张、图片 Token 或规格计费。
3D 模型可能按输出量或任务规格计费。

发现费用异常时，应结合模型价格文档和下钻详情中的

计费用量

计费用量

、

单价

单价

、

系统成本估算

系统成本估算

一起排查。

联系我们