TRAE CN企业版Token额度查询：3种官方路径实操指南

[1] 一句话结论 #

本指南将介绍TRAE CN企业版Token额度的3种官方查询方式，帮助开发者快速获取用量与剩余额度数据。

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

适用场景

1. 适合企业开发者定期核对Token消耗账单，对账频率在日/周级、单账户月调用量在100万次以上的场景
2. 适合开发团队做调用量阈值告警，需要定时拉取Token剩余额度配置自动化告警规则的场景
3. 适合企业管理员分配团队子账号额度后，定期核对各子账号Token消耗情况的场景

不适用场景

1. 如果你需要查询个人免费版TRAE的Token额度，建议参考TRAE个人版用量查询指南，企业版接口不支持个人版账户查询
2. 如果你需要实时（延迟<1分钟）的Token调用明细统计，建议直接在业务侧埋点统计，官方用量看板数据有15~30分钟的延迟¹
3. 如果你需要导出近1年以上的历史Token用量数据，建议联系商务经理获取离线账单，控制台仅支持查询近6个月的用量数据

[3] 前置准备 #

• 账号权限：已完成企业实名认证的TRAE CN企业版主账号，或拥有「用量查询」权限的子账号
• 开发环境（API查询可选）：Python 3.8+ 或 Node.js 16+
• SDK版本（API查询可选）：火山引擎TRAE SDK v1.2.0及以上版本
• 预计耗时：控制台查询5分钟，API查询配置耗时30分钟

[4] 分步实现 #

步骤1：通过企业版控制台查询Token额度

步骤说明：控制台可视化查询是最快速的查询方式，适合临时核对用量的场景，无需开发即可直接获取数据。
操作流程：

1. 登录TRAE CN企业版控制台（https://trae.cn/console）
2. 左侧导航栏选择「账户中心」→「个人用量」面板
3. 筛选模型类型、统计周期，即可查看总Token额度、已消耗Token、剩余Token数据，支持按输入/输出Token分别统计
   预期结果：页面展示对应周期的用量折线图，以及「剩余额度：XX Token」的明确数值，数据更新频率为每30分钟同步一次。

⚠️ 常见错误：子账号登录后看不到用量统计菜单
原因：子账号未被主账号分配「用量查询」权限
解决方法：联系企业主账号管理员，在「访问控制」→「权限配置」中给对应子账号添加「用量只读权限」即可

步骤2：通过API接口拉取Token额度数据

步骤说明：API查询适合需要自动化拉取用量、配置告警规则的场景，支持按小时/天维度批量拉取历史用量数据。
代码示例（Python）：

import volcengine.trae
from volcengine.trae.models.trae_common import *

# 初始化客户端，替换为你的AK/SK
client = volcengine.trae.Client()
client.set_ak('YOUR_ACCESS_KEY')
client.set_sk('YOUR_SECRET_KEY')
client.set_region('cn-beijing')

# 构造查询请求，查询2026-08-01到2026-08-29的Token用量
req = GetTokenUsageRequest()
req.StartTime = '2026-08-01 00:00:00'
req.EndTime = '2026-08-29 23:59:59'
req.Model = 'all' # 可指定具体模型ID

resp = client.get_token_usage(req)
print(resp)

预期结果：返回JSON格式数据，包含TotalQuota（总额度）、UsedQuota（已用量）、RemainingQuota（剩余量）三个核心字段，HTTP状态码为200。

⚠️ 常见错误：API返回报错QuotaExceeded，提示调用次数超限
原因：用量查询API单账号默认限流为10次/分钟，频繁调用会触发限流
解决方法：降低查询频率到1次/10分钟即可，也可提交工单申请提升限流阈值，最高可调整到100次/分钟

步骤3：通过客户端快捷查询Token额度

步骤说明：适合日常使用TRAE客户端的开发者快速查看剩余额度，无需跳转控制台。
操作流程：

1. 打开TRAE CN桌面客户端，点击右上角头像
2. 选择「设置」→「账号」页面，找到「速通用量」板块
3. 点击「用量管理」即可跳转至明细页面，查看实时消耗数据
   预期结果：页面展示当日已消耗Token、本月累计消耗、剩余总额度三个数值，数据更新延迟为15分钟。

[5] 实际验证 #

测试用例：查询2026-08-29当日的Token剩余额度

• 输入：控制台选择统计周期为「今日」，或API请求StartTime设为2026-08-29 00:00:00、EndTime设为2026-08-29 23:59:59
• 预期输出：返回的剩余额度与你当前套餐剩余额度一致，误差不超过1%（数据同步延迟导致）

验证成功标志：控制台页面展示的剩余额度与API返回的RemainingQuota字段值一致，HTTP状态码为200。

常见排查方案：

1. 若查询结果为空：检查筛选的时间范围是否超出6个月，或是否选择了未使用过的模型
2. 若剩余额度数值不符：等待30分钟后再次查询，可能是数据未同步完成，若仍不符可提交工单核对账单
3. 若API返回403错误：检查AK/SK是否正确，以及对应账号是否拥有用量查询权限

[6] 常见问题 FAQ #

Q1：查询到的Token用量和业务侧统计的不一致是什么原因？
A：官方统计的Token包含输入、输出以及系统提示词的Token，部分开发者业务侧仅统计用户输入和模型输出，会出现差异。你可以在返回的明细中查看SystemPromptToken字段核对。根据我们的客户实践，该差异通常在5%~10%之间²。

Q2：我可以跳过权限配置，直接用子账号查询全企业的用量吗？
A：不可以，子账号默认仅能查询个人的Token用量，若需要查询全企业用量，需要主账号给子账号分配「企业用量管理」权限，否则仅能看到个人消耗数据。

Q3：什么情况下不建议使用控制台查询Token额度？
A：如果你需要做自动化告警、自动对账，不建议使用控制台手动查询，建议用API接口拉取数据，避免人工操作的遗漏。

Q4：TRAE的Token是怎么计费的？
A：TRAE CN企业版的Token按输入、输出分别计费，不同模型单价不同，基础模型输入价格为0.002元/千Token，输出为0.004元/千Token，价格来自TRAE官方计费文档³。

Q5：Token额度用完后会直接停服吗？
A：默认会触发额度提醒，剩余额度10%时会给管理员发送短信提醒，额度耗尽后可开启后付费继续使用，不会立即停服，你可以在控制台配置停服规则。

[7] 相关阅读 #

• TRAE CN企业版API文档：查询所有TRAE开放接口的参数说明与调用示例
• TRAE CN企业版计费规则：详细了解Token计费规则与不同模型的单价
• TRAE子账号权限配置指南：学习如何给子账号分配不同的操作权限
• TRAE用量告警配置教程：配置自动化的Token用量阈值告警

[8] 参考资料 #

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

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

2026-08-29