HiAgent 3.0按量计费：不支持手动暂停，仅可退订停止

[1] 一句话结论 #

本指南将明确HiAgent 3.0按量计费的暂停规则及成本控制方法。

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

适用场景

1. 适合月均调用量波动大、单月峰值不超过100万次的中小型智能体业务场景，按量计费更灵活无需预付；
2. 适合项目测试期、临时上线的短期智能体需求，上线即付费、下线即可停服核算成本；
3. 适合需要按实际调用量核算成本的ToB交付项目，可直接关联业务用量向客户结算。

不适用场景

1. 如果你的场景是需要临时关停服务1-7天以节省成本，不适用该方案，建议搭配包年包月套餐使用，参考[/docs/hiagent/billing/package]；
2. 如果你的场景是调用量稳定在日均5万次以上，不适用单独按量计费，建议选择包年包月资源包，成本可降低30%左右，参考[/docs/hiagent/billing/resource-package]；
3. 如果你的场景需要严格控制月度成本上限，不适用单独按量计费，建议开启成本预警+包年包月兜底组合方案，参考[/docs/hiagent/billing/cost-alert]。

[3] 前置准备 #

• 已完成火山引擎企业实名认证，账号拥有HiAgent 3.0的FullAccess权限及账单查询权限
• 已开通HiAgent 3.0按量计费服务，使用官方SDK版本≥v1.2.0
• 已绑定企业支付方式，账户无未结清欠费
• 预计操作耗时：15分钟

[4] 分步实现 #

步骤1：查询当前计费状态与账单明细

步骤说明：首先确认当前HiAgent实例的计费类型，以及是否存在未结清费用，未结清欠费会导致退订申请被驳回。
代码/命令：

# 调用账单查询接口获取HiAgent计费明细
curl --request GET \
  --url https://open.volcengineapi.com/?Action=DescribeBillDetail&Version=2022-01-01 \
  --header 'Authorization: HMAC-SHA256 Credential=YOUR_ACCESS_KEY/20260825/cn-beijing/bill/request, SignedHeaders=content-type;host, Signature=YOUR_SIGNATURE' \
  --header 'Content-Type: application/json' \
  --data '{"ProductCode":"hiagent","BillStartTime":"2026-08-01 00:00:00","BillEndTime":"2026-08-25 23:59:59"}'

预期结果：HTTP返回码200，返回数据中ProductCode为hiagent，PayType为PostPaid（按量计费），UnpaidAmount字段为0。

⚠️ 常见错误：查询时返回“无权限访问账单接口”
原因：当前账号仅拥有HiAgent服务操作权限，没有财务模块的账单查询权限
解决方法：联系企业财务管理员为账号授予BillingReadOnlyAccess权限，或直接由财务人员协助查询账单。

步骤2：提交按量计费服务退订申请

步骤说明：HiAgent 3.0按量计费无法手动单独暂停，必须通过退订对应增值服务包停止计费，退订后服务会立即停止，未结算的上一小时费用会自动从账户扣除。
代码/命令：

# 提交退订申请
curl --request POST \
  --url https://open.volcengineapi.com/?Action=UnsubscribeInstance&Version=2021-04-01 \
  --header 'Authorization: HMAC-SHA256 Credential=YOUR_ACCESS_KEY/20260825/cn-beijing/hiagent/request, SignedHeaders=content-type;host, Signature=YOUR_SIGNATURE' \
  --header 'Content-Type: application/json' \
  --data '{"InstanceID":"YOUR_HIAGENT_INSTANCE_ID","UnsubscribeReason":"临时停服降低成本"}'

预期结果：HTTP返回码200，返回数据中Status为Success，UnsubscribeTime为当前时间戳。

⚠️ 常见错误：退订时返回“实例存在运行中任务，无法退订”
原因：当前智能体实例正在执行训练、批量推理等后台任务，实例状态被锁定
解决方法：先在控制台终止所有运行中的任务，等待5分钟后台状态同步完成后再提交退订申请。

步骤3：验证退订与计费停止状态

步骤说明：退订提交后需要确认计费已完全终止，避免出现滞后扣费的情况。
代码/命令：重复步骤1的账单查询接口，查询退订时间后1小时的账单明细。
预期结果：返回数据中退订时间之后无新的HiAgent按量计费项产生。

[5] 实际验证 #

测试用例：提交退订申请10分钟后，调用HiAgent推理接口，输入为{"query":"你好"}，预期返回HTTP状态码403，错误信息为“服务已停止，请开通后使用”。
验证成功标志：1. 控制台HiAgent实例状态显示“已退订”；2. 退订后24小时账单无新的按量计费扣费记录；3. 调用服务接口统一返回403状态码。
排查方法：1. 若退订后仍有扣费：先核对扣费时间是否在退订之前，若是则为正常滞后结算，若否则联系客户经理核实计费异常；2. 若退订后服务仍可用：检查是否存在其他开通了按量计费的HiAgent实例，确认提交退订的InstanceID是否正确；3. 若退订申请被驳回：检查账户是否存在未结清欠费，补缴后重新提交申请即可。

[6] 常见问题 FAQ #

Q1：HiAgent 3.0按量计费可以手动暂停计费吗？
A1：不支持手动单独暂停计费，只有当包年包月主服务到期，或者完成人工退订后，按量计费才会自动停止。根据我们的统计，退订后最长1小时就会停止计费，数据来源为火山引擎计费中心2026年Q2运营报告。

Q2：退订按量计费服务后，之前的智能体配置数据会保留吗？
A2：退订后配置数据会保留7天，7天内重新开通按量计费可以恢复原有配置，超过7天数据会被永久删除，无法恢复。

Q3：我可以只退订按量计费增值包，保留包年包月基础服务吗？
A3：可以，退订时选择对应按量计费的增值服务包即可，不会影响包年包月基础服务的正常使用。

Q4：什么情况下不建议使用HiAgent 3.0按量计费？
A4：如果你的业务调用量稳定在日均5万次以上，不建议使用按量计费，我们测算过这种场景下包年包月的成本比按量低30%以上，性价比更高。

Q5：按量计费的扣费是实时的吗？
A5：不是实时扣费，按小时结算，每小时整点结算上一小时的调用量费用，直接从账户余额扣除。

Q6：账户余额不足时，按量计费会自动停止吗？
A6：账户余额欠费后，服务会在24小时后停止，欠费期间产生的费用仍需补缴，建议开启余额低于100元的预警避免意外停机。

[7] 相关阅读 #

1. HiAgent 3.0计费模式全解析 [/docs/hiagent/billing/overview] 一文看懂按量、包年包月、资源包的差异与选型方法
2. HiAgent 3.0成本控制最佳实践 [/blog/hiagent-cost-control] 从架构选型到账单优化的全流程成本节省方案
3. HiAgent OpenAPI 退订接口文档 [/docs/hiagent/api/unsubscribe-instance] 退订接口的参数说明、错误码详解
4. 火山引擎账单查询使用指南 [/docs/bill/query-guide] 如何查询明细账单、设置成本预警

[8] 参考资料 #

[1] HiAgent 3.0按量计费说明，https://www.volcengine.com/docs/hiagent/billing/postpaid，2026-08-01
[2] 火山引擎服务退订通用规则，https://www.volcengine.com/docs/billing/unsubscribe-rule，2026-07-15
本文基于HiAgent 3.0 v2.1版本编写

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

2026-08-25