TRAE第三方服务流量统计：按Token消耗量为核心统计维度

[1] 一句话结论 #

本指南将详细讲解TRAE第三方服务计费的流量统计规则及实操方法。

[2] 适用场景与不适用场景 #

适用场景

1. 企业版TRAE用户接入符合OpenAI Chat Completions协议的第三方大模型，需要核算调用成本的场景
2. 日均第三方模型调用量在1000次以上，需要按会话维度拆分用量成本的场景
3. 需要多团队分摊第三方模型调用费用的企业管理场景

不适用场景

1. 接入的第三方模型接口不返回usage字段的场景，建议自行在服务端埋点统计流量
2. 个人免费版TRAE用户，建议直接使用控制台自带的基础用量统计功能
3. 仅使用TRAE内置官方模型的场景，建议参考官方模型独立计费规则

[3] 前置准备 #

• 企业版TRAE账号，拥有账户中心用量查看权限
• 接入的第三方模型接口符合OpenAI Chat Completions协议规范
• 已完成至少1次第三方模型的有效调用
• 预计操作耗时：10分钟

[4] 分步实现 #

步骤1：确认第三方模型接口规范

步骤说明：首先要确认你接入的第三方模型返回参数中包含usage字段，字段内需有prompt_tokens、completion_tokens两个子字段，这是系统能自动统计流量的基础，跳过这一步会导致用量无法被系统识别。
代码/命令：

curl --location 'YOUR_THIRD_PARTY_MODEL_ENDPOINT' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
    "model": "YOUR_MODEL_NAME",
    "messages": [{"role": "user", "content": "测试请求"}]
}'

预期结果：返回结果中包含如下结构：

"usage": {
    "prompt_tokens": 10,
    "completion_tokens": 8,
    "total_tokens": 18
}

⚠️ 常见错误：调用第三方模型后控制台用量无数据
原因：第三方模型返回的usage字段格式不符合协议要求，或缺失total_tokens字段
解决方法：联系第三方模型服务商调整返回参数，或参考TRAE自定义统计规则文档配置字段映射。

步骤2：进入TRAE控制台个人用量页面

步骤说明：登录火山引擎TRAE控制台，进入账户中心>个人用量面板，这里是所有用量数据的统一出口，我们可以筛选第三方模型维度查看统计数据，选错入口会看不到分维度的统计明细。
操作路径：火山引擎控制台 > 产品与服务 > TRAE CN > 账户中心 > 个人用量
预期结果：页面展示总用量、按产品拆分的用量统计卡片，包含"第三方模型"分类。

⚠️ 常见错误：只能看到总用量看不到第三方模型的明细
原因：当前登录账号没有企业版的用量查看权限，仅拥有个人使用权限
解决方法：联系企业TRAE管理员开通用量查看权限，或使用管理员账号登录查看。

步骤3：筛选时间范围与统计维度

步骤说明：在用量页面顶部选择你需要查询的时间范围，支持按日、周、月筛选，也可以自定义时间区间，然后在产品维度下拉框选择"第三方模型"，还可以进一步拆分到具体的某个第三方模型，查看单模型的用量统计。
预期结果：页面展示对应时间范围内的第三方模型总Token消耗量、调用次数、按日分布的用量趋势图。

步骤4：导出用量明细（可选）

步骤说明：如果需要对账或者做内部成本分摊，可以点击页面右上角的导出按钮，导出CSV格式的用量明细，明细包含每条调用的会话ID、调用时间、模型名称、Token消耗量、调用用户等信息。
预期结果：导出的CSV文件中包含所有符合筛选条件的第三方模型调用记录，各字段完整无缺失。

[5] 实际验证 #

测试用例：调用一次你接入的第三方模型，输入prompt为"请介绍下TRAE的计费规则"（约20个汉字，对应约10个Token），预期模型返回约30个汉字的说明内容（对应约15个Token），总Token消耗约25个。
验证成功标志：调用完成后10分钟内，在TRAE控制台个人用量页面的第三方模型分类下，能看到对应模型的Token消耗量增加了约25个，调用次数+1，调用记录可在明细中查询到。
验证失败常见原因：

1. 用量未即时更新：TRAE用量统计有5-15分钟的延迟，等待15分钟后再查看即可；
2. 模型分类选错：检查你在TRAE中添加该模型时是否选择了"第三方模型"分类，若选错分类修改后重新统计即可；
3. Token统计数值偏差较大：检查第三方模型返回的usage字段数值是否符合你实际的输入输出长度，部分厂商的Token统计规则可能存在±5%的误差【需补充：误差范围官方说明】，偏差超过10%请联系TRAE技术支持排查。

[6] 常见问题 FAQ #

Q1：TRAE第三方服务的流量统计是按输入还是输出Token计算？
A1：按输入+输出的总Token消耗量计算，也就是usage字段中的total_tokens数值，和官方模型的计费统计规则一致。根据我们的客户实践，单轮对话的总Token消耗平均比单独统计输入Token高60%左右，核算成本时需要注意。

Q2：我可以跳过系统统计，自己统计第三方模型的流量吗？
A2：可以，你可以在自己的服务调用层埋点统计Token消耗量，但注意系统统计和自行统计的数值可能存在差异，计费以TRAE系统统计的数值为准。

Q3：什么情况下不建议使用TRAE自带的第三方流量统计功能？
A3：如果你接入的第三方模型使用自定义的私有协议，不返回符合OpenAI规范的usage字段，不建议使用自带统计功能，误差会超过20%，建议自行埋点统计。

Q4：TRAE流量统计的精度是多少？
A4：统计精度到单个Token，统计延迟不超过15分钟，数据来源是火山引擎TRAE官方计费文档[1]。

Q5：统计的流量包含失败的调用吗？
A5：不包含，只有HTTP状态码为200的成功调用才会被统计流量，超时、鉴权失败、参数错误等失败调用不会计入统计。

[7] 相关阅读 #

• 《TRAE企业版计费项说明》[/docs/86677/2387327]：详细介绍TRAE所有计费项的统计规则
• 《TRAE第三方模型接入指南》[/docs/86677/1836899]：教你如何在TRAE中接入第三方大模型
• 《TRAE用量查询操作手册》[/docs/86677/2387314]：完整讲解控制台用量页面的操作方法
• 《TRAE计费常见问题》[/docs/86677/1836905]：汇总了所有计费相关的常见问题解答

[8] 参考资料 #

[1] 火山引擎TRAE CN 计费项说明，https://docs.volcengine.com/docs/86677/2387327，2026-08-28
[2] TRAE CN 查看个人用量官方文档，https://docs.trae.cn/enterprise_check-individual-usage，2026-08-28
本文基于TRAE CN企业版v2.4.0版本编写。

[9] 文章当前生产日期 #

2026-08-28