数据看板
数据看板 用于查看 AI 网关的费用、请求量和模型用量。您可以按模型、令牌或模型配置分析费用来源,结合错误率、缓存命中率和用量趋势,了解调用情况发生了哪些变化。
打开控制台中的数据看板,选择时间和资源范围后点击 查询。默认查询当天;修改筛选条件后,需要重新查询。顶部卡片展示当前查询的汇总结果,各页签提供趋势和明细。
费用
牌价金额
牌价金额 是按模型官方牌价计算、尚未应用合同折扣的用量费用,可用于比较不同模型或业务的使用成本。
费用上升时,可先在 模型牌价趋势 中查看哪些模型的金额增加,再通过明细表按令牌或模型配置分组,定位用量来源。模型趋势默认展示牌价金额最高的 Top10 模型,最多可选择 20 个模型;图中选中的模型不影响顶部汇总金额。
消费金额
消费金额 是应用合同折扣后的用量费用。查看合同折扣后的消费时,使用这一指标;比较折扣前的用量成本时,使用牌价金额。
消费金额卡片和页签需要单独授权。如未显示,请联系管理员确认权限。核对应付费用时,应以最终账单的结算金额为准,其中还可能包含调账和税费。测试期间的核对方法见测试消费核对。
币种与金额精度
币种 决定汇总金额和费用趋势以美元(USD)还是人民币(CNY)展示。明细表保留原始计价币种,因此汇总选择美元时,明细仍可能同时出现美元和人民币。悬停在汇总牌价金额上,可查看原始币种金额及换算汇率。
页面金额保留两位小数,<$0.01 或 <¥0.01 表示金额低于页面的显示精度,可导出查看具体数值。导出金额保留 7 位小数,适合进一步核对;按页面显示值相加,可能与导出结果不同。加总明细前,请先按币种分别汇总,或统一换算。
请求量与错误率
请求 页签用于查看调用规模、错误情况和请求频率。
| 指标 | 含义与计算方式 |
|---|---|
| 请求数 | 当前查询范围内统计到的请求数量。顶部 总请求数 展示整个查询时段的合计。 |
| 请求错误数 | 响应状态码为 4xx 或 5xx 的请求数量。 |
| 请求错误率 | 请求错误数 ÷ 请求数 × 100%。 |
| 平均 RPM | 请求数 ÷ 统计时段的分钟数,向上取整。RPM 表示每分钟请求数。 |
判断错误是否增多时,应同时看错误数和错误率:请求量增长可能带来更多错误,但错误占比不一定上升。状态码趋势可帮助缩小排查时段,具体失败原因则需结合请求日志和应用侧记录。
平均 RPM 按整个统计时段计算,包含没有请求的时间。例如,一小时内发生 120 次请求,平均 RPM 为 2,即使这些请求集中在几分钟内。它不代表瞬时峰值,也不代表令牌或模型的限流阈值。
Token 用量与缓存
Token数 页签展示模型的输入、输出和缓存用量。Token 趋势包含总量、输入、输出、缓存命中和缓存写入,另有缓存命中率、TPM 趋势及 TPM Top5模型。
| 指标 | 含义与计算方式 |
|---|---|
| 总 Token 数 | 模型记录的 Token 总用量。顶部卡片展示整个查询时段的合计。 |
| 输入 Token 数 | 模型记录的输入 Token 用量。 |
| 输出 Token 数 | 模型记录的输出 Token 用量。 |
| 缓存命中 Token 数 | 输入中从缓存读取的 Token 数量。 |
| 缓存命中率 | 缓存命中 Token 数 ÷ 输入 Token 数 × 100%。 |
| 缓存写入 Token 数 | 写入缓存的 Token 数量。 |
| 平均 TPM | 总 Token 数 ÷ 统计时段的分钟数,向上取整。TPM 表示每分钟 Token 数。 |
缓存命中率衡量的是输入 Token 的缓存使用比例。例如,4,000 个输入 Token 中有 1,000 个命中缓存,命中率为 25%;它不是命中缓存的请求占比,也不等于费用节省比例。
核对整体用量时,请使用记录的 总 Token 数,不要将总量和输入、输出、缓存等列再次相加。各细分项可能存在包含关系,具体分类和计费方式应以对应模型的说明为准。
RPM 衡量请求频率,TPM 衡量 Token 用量。比较同样长的两个时段时,如果请求数接近、Token 总量却明显增加,可以进一步比较输入和输出用量,判断是否发送了更长的输入或生成了更长的结果。与 RPM 一样,平均 TPM 不反映瞬时峰值。
多模态用量
图片、音频和视频等模型还可能按其他单位记录用量。评估这些模型的使用情况时,应结合 多模态 页签,不能只看 Token 数。
| 指标 | 统计内容 | 单位 |
|---|---|---|
| 输入字符数 | 输入文本的字符数量。 | 字符 |
| 输入图片数 | 作为输入的图片数量。 | 张 |
| 生成图片数 | 模型生成的图片数量。 | 张 |
| 输入语音时长 | 输入音频的时长。 | 秒 |
| 生成视频时长 | 模型生成的视频时长。 | 秒 |
| 视频消耗积分 | 视频生成消耗的积分。 | 积分 |
某个图表没有数据,只表示当前查询没有匹配该指标的结果,其他类型仍可能有用量。
响应状态码
响应状态码 页签展示最多 10 种状态码的请求趋势和分布,用于查看常见响应,以及错误集中出现的时段。
分布图中,状态码占比 = 该状态码的请求数 ÷ Top10 状态码的请求总数 × 100%。如果查询结果包含更多状态码,这里的百分比就不代表全部请求。查看 4xx 和 5xx 在统计请求中的整体占比时,请使用 请求 页签的请求错误率。
状态码只能说明响应类别,不能单独确定失败原因。排查某次调用时,请查看对应请求日志。
按业务或资源分析
筛选范围
可按时间、令牌或令牌组、模型应用、模型 ID 和模型配置筛选。中文控制台中的 令牌 是 API 访问凭证,Token数 则是模型用量。
模型应用 指模型的用途类别,如文本、图片、音频、视频或向量,并非您自己的业务应用。若要分析某个业务的用量,可筛选该业务使用的令牌、令牌组或模型配置。
令牌 与 令牌组 是两种互斥的筛选方式,切换后已选项恢复为 全部。按组筛选或分组时,使用请求发生时记录的归属;之后移动令牌,不会改变历史用量的分组。标记为 已删除 的模型配置仍可用于历史查询。
子账号的 全部 仅指已获授权的资源。令牌、令牌组和模型配置分别授权,能查询某个令牌,并不代表也能按其所属组查询。如果找不到预期资源,请先向管理员确认数据查看权限。
明细分组
在明细表的 列设置 中,可选择 1~5 个维度和至少 1 个指标。维度包括模型配置、令牌组、令牌、模型应用、模型原厂、模型名称和模型 ID;指标可以组合选择,例如同时查看请求数、Token 数和牌价金额。
维度决定每行如何汇总。例如,筛选某个令牌组、按模型 ID 分组,可以比较该组使用各模型的情况;同时选择令牌和模型 ID,则每行对应一个令牌使用一个模型的汇总结果。响应状态码页签没有此类明细表。
时间范围与粒度
查询使用控制台显示的时区,可在账号管理 > 个性设置中查看。与应用记录或账单比较时,请同时核对日期和时区。
趋势图按所选粒度汇总每个时间区间,明细表则汇总整个查询时段。图中每个点的平均 RPM、TPM 按该区间的分钟数计算;明细表中的平均值按整个查询时段计算。因此,表中的平均值可能低于繁忙时段的曲线值。
| 查询时间跨度 | 可选粒度 |
|---|---|
| 1 天 | 1 分钟、5 分钟、1 小时、1 天 |
| 超过 1 天,不超过 7 天 | 5 分钟、1 小时、1 天 |
| 超过 7 天,不超过 1 个自然月 | 1 小时、1 天 |
单次查询最长为 1 个自然月,最早可选日期为 2026 年 4 月 1 日,最多可指定 500 个令牌。子账号选择 全部 时,也可能因已授权令牌超过 500 个而触发上限;遇到提示时,请减少所选令牌后重新查询。
导出与费用核对
导出沿用当前查询的筛选条件。根据需要选择趋势数据、分组汇总或计价明细:
| 导出类型 | 适合用途 |
|---|---|
| 趋势图 下载 | 分析用量或费用随时间的变化,文件按图表所选粒度汇总。模型费用趋势的 下载当前 仅包含图中选定的模型,下载全部 包含查询范围内的全部模型。 |
| 明细表 下载 | 按所选维度和指标分析资源用量,包含全部返回行,不受分页限制。 |
| 牌价明细下载 / 消费明细下载 | 按模型、计费项目、单价和用量核对费用,列不受明细表的列设置影响。牌价明细需要单独的下载权限;消费明细在获授权的消费金额页签中提供。 |
隐藏状态码曲线只改变图表显示,不会从下载文件中排除相应状态码。
牌价趋势导出使用查询时选择的币种;明细表和牌价明细保留原始计价币种。牌价明细仅包含单价和金额均大于 0、且计价币种不为 - 的记录,因此不能用它的行数核对总请求数。
图表和下载文件最多包含前 100,000 条记录。 结果达到这一上限时,请缩小时间或资源范围后分别查询,避免遗漏数据。
测试消费核对
充值页的 累计测试账单金额 覆盖整个测试期,点击后进入数据看板的消费金额视图,默认查询近 31 天。因此,核对前应先对齐测试期、币种和资源范围,并查看充值页的 数据更新时间。
测试期超过单次查询范围时,可拆成相邻且不重叠的时段,保持币种和资源条件一致后汇总。如无法查询完整测试期,或核对后仍有差异,请联系支持人员。牌价金额不能用于判断剩余测试额度。