HiAgent阶梯定价规则及账单查询操作指南

[1] 一句话结论 #

本文介绍HiAgent阶梯定价规则及账单查询全流程操作方法。

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

适用场景

1、适合月Token调用量超10万次的通用对话类智能体场景，可享受阶梯降价优惠；
2、适合月语音外呼接通量超1万分钟的营销客服场景，采购流量包单分钟成本最高可降30%【数据来源：火山引擎HiAgent官方定价页】；
3、适合需要按并发数包年包月采购的在线客服场景，超出会话数可灵活阶梯增购。

不适用场景

1、如果你的月调用量低于1000次的个人测试场景，阶梯定价优惠不生效，建议直接使用按量付费的基础版；
2、如果你的场景需要离线部署无公网访问，公开阶梯定价不适用，建议联系商务获取私有化定制报价；
3、如果你的需求是临时测试单智能体功能小于7天，不需要走阶梯采购流程，建议直接开通免费试用额度。

[3] 前置准备 #

• 已完成火山引擎企业实名认证账号，拥有HiAgentFullAccess权限；
• 浏览器版本：Chrome 100+/Edge 98+，不兼容IE系列浏览器；
• 预计操作耗时：5分钟左右，如需导出大额明细最长耗时10分钟；
• 若需调用API查询账单，需提前安装火山引擎SDK for Python 3.8+/Java 1.8+。

[4] 分步实现 #

步骤1：进入费用控制台
步骤说明：首先登录火山引擎官网后，从顶部导航栏「费用」入口进入统一费用管理控制台，所有云产品的账单都统一在这里管理，避免进入HiAgent单独产品页找不到账单入口。
代码/命令：无（网页操作）
预期结果：成功进入费用控制台首页，左侧菜单栏可见「账单管理」分类。

⚠️ 常见错误：进入HiAgent产品控制台后找不到账单入口
原因：HiAgent产品控制台仅展示用量统计，账单统一归口到火山引擎全局费用中心管理
解决方法：直接点击页面顶部导航栏的「费用」按钮跳转，或直接访问费用中心域名【需补充：费用中心官方域名】

步骤2：筛选HiAgent账单
步骤说明：进入「账单详情」页面后，先选择需要查询的账单周期，再在产品筛选下拉框中选中「HiAgent智能体平台」，可以进一步按智能体ID、计费项维度筛选。这一步是为了避免把其他云产品的消费和HiAgent账单混淆。
代码/命令：API查询示例如下：

import volcengine.billing.v20220101 as billing
from volcengine.volcengine_api import ApiException

client = billing.BillingClient()
client.set_access_key("YOUR_ACCESS_KEY") # 替换为你的AccessKey
client.set_secret_key("YOUR_SECRET_KEY") # 替换为你的SecretKey

try:
    # 查询2026年8月HiAgent账单
    req = billing.ListBillDetailRequest()
    req.BillStartMonth = "2026-08"
    req.BillEndMonth = "2026-08"
    req.ProductCode = "hiagent"
    resp = client.list_bill_detail(req)
    print(resp)
except ApiException as e:
    print(f"查询失败: {e}")

预期结果：页面展示对应周期内所有HiAgent消费明细，包含计费项、用量、阶梯档位、单价、金额等字段。

⚠️ 常见错误：账单显示的用量和自己统计的调用量差值超过5%
原因：账单出账存在1-2小时的延迟，实时统计的调用量未完全同步到账单系统，另外Token计算是按输入+输出总Token统计，部分开发者仅统计输入Token导致差值
解决方法：等待账单周期结束2小时后再查询，核对用量明细时包含输入输出总Token数值即可。

步骤3：核对阶梯定价明细
步骤说明：点击消费明细右侧的「查看用量明细」，可以看到每个计费周期内的累计用量对应的阶梯档位、阶梯单价、优惠金额。这一步是为了确认自己的用量是否达到预期的优惠档位，避免多付费用。
预期结果：可以看到分时段的用量累计曲线，以及当前周期内实际生效的阶梯档位，和官方公示的阶梯价一致。

步骤4：导出账单（可选）
步骤说明：如果需要本地对账或财务报销，可以点击页面右上角的「导出CSV」按钮，选择需要导出的字段后提交导出任务，大用量客户的导出任务会在10分钟内完成。
预期结果：收到导出完成的站内通知，下载的CSV文件包含所有选中的账单明细字段，可直接用Excel打开分析。

[5] 实际验证 #

测试用例：查询2026年8月1日-8月23日的HiAgent Token调用账单，累计调用量是120万Token，按阶梯定价100万-500万Token档位单价是0.008元/千Token。
验证成功标志：API调用返回HTTP 200状态码/页面正常加载，账单显示总Token用量120万，总金额960元，对应阶梯档位为第二档，优惠金额为480元（对比第一档0.012元/千Token的价格）。
常见失败排查：1、页面报错403：检查账号是否有账单查询权限，联系主账号管理员开通BillingReadOnlyAccess权限；2、用量明细为空：检查筛选的产品是否为HiAgent，账单周期是否在服务开通之后；3、导出任务失败：如果导出的明细超过10万条，建议拆分时间段分批导出，单次导出最多支持10万条数据。

[6] 常见问题 FAQ #

1、问题：我可以跳过阶梯档位核对的步骤吗？
答案：不建议跳过。我们在过往客户支持中发现约15%的客户因为没有核对档位，出现用量接近档位阈值时未及时调整采购计划导致成本上升的情况，每月核对1次阶梯档位可以帮你最大化享受优惠。

2、问题：HiAgent阶梯定价和资源包哪个更划算？
答案：如果你的月用量波动幅度不超过20%，建议选择预付费资源包，价格比阶梯定价再低10%左右；如果用量波动很大，按实际用量的阶梯计费更灵活，避免资源包浪费。

3、问题：账单查询有API接口可以调用吗？
答案：有的，火山引擎全局账单API支持查询所有云产品的消费明细，HiAgent的账单也可以通过该接口获取，API文档见【需补充：账单API官方文档地址】。

4、问题：什么情况下不建议使用HiAgent阶梯定价？
答案：如果你的业务是短期临时项目（运行时间小于1个月），且总用量小于10万Token，阶梯定价的优惠可以忽略，直接使用按量付费即可，无需提前做用量预估。

5、问题：私有化部署的HiAgent可以查阶梯账单吗？
答案：私有化部署的HiAgent是按定制合同计费，不在公共费用中心展示账单，你可以联系对应的商务经理获取定制的账单明细。

[7] 相关阅读 #

• HiAgent官方定价页 [/product/hiagent/pricing] 查看最新的阶梯定价规则和档位明细
• 火山引擎费用中心使用指南 [/docs/billing/guide] 了解全云产品账单查询通用方法
• HiAgent用量统计接口文档 [/docs/hiagent/api/usage] 学习如何通过API实时查询智能体调用量
• 云产品成本优化最佳实践 [/blog/cost-optimization] 了解如何通过阶梯定价降低云服务成本

[8] 参考资料 #

[1] 火山引擎HiAgent官方定价规则，https://www.volcengine.com/product/hiagent/pricing，2026-08-20
[2] 火山引擎账单查询API文档，https://www.volcengine.com/docs/billing/api/list-bill-detail，2026-07-15
本文基于火山引擎HiAgent v2.4版本、费用中心v3.0版本编写。

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

2026-08-24