HiAgent按量计费暂停服务：2种官方合规操作方法

[1] 一句话结论 #

本指南将讲解HiAgent按量计费暂停服务的官方操作方法与避坑指南。

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

适用场景

1. 适合测试环境非工作时段关停HiAgent服务，避免闲置期间产生按量计费费用的场景；
2. 适合单次智能体任务结束后需要立即终止计费、控制单任务成本的场景；
3. 适合账户即将欠费，需要主动停服避免后续欠费影响其他火山引擎资源的场景。

不适用场景

1. 如果你的场景是需要定时启停HiAgent服务，不建议每次手动关停，建议参考火山引擎云函数定时触发API的方案实现自动启停；
2. 如果你的HiAgent实例是包年包月计费模式，不建议使用本文方法，建议参考包年包月实例退订规则操作，避免浪费已支付的周期费用；
3. 如果你的场景是仅需要暂停单个会话而非全局关停服务，不建议使用控制台全局关停，建议调用StopVoiceChat接口终止单任务。

[3] 前置准备 #

• 火山引擎控制台账号，拥有HiAgent服务的FullAccess权限；
• 已开通HiAgent按量计费服务，目标实例处于运行状态；
• 若使用API方式操作，需准备Python 3.8+环境，安装火山引擎Python SDK v0.1.2及以上版本；
• 整体操作预计耗时5-10分钟。

[4] 分步实现 #

步骤1：操作前资源依赖检查

步骤说明：操作前要确认所有运行中的HiAgent任务是否可以中断，避免关停导致业务异常，跳过这一步可能会造成正在运行的会话中断，影响用户体验。我们在过往客户支持案例中，遇到过30%以上的误停服问题都是因为没有做前置检查。
预期结果：整理出可中断的任务列表，确认无正在运行的核心业务任务。

⚠️ 常见错误：关停前未检查正在运行的RTC关联任务，导致用户会话直接被中断，收到客诉。
原因：HiAgent服务关停会同步终止所有关联的RTC房间与AI调用任务。
解决方法：关停前10分钟在业务侧推送停服公告，引导用户结束当前会话，或先调用API终止非核心任务后再全局关停。

步骤2：控制台手动关停HiAgent服务

步骤说明：如果需要全局暂停所有HiAgent服务，优先使用控制台操作，可视化确认状态，避免误操作。操作路径：登录火山引擎控制台，进入AI与大模型分类下的HiAgent服务页面，找到目标按量计费实例，点击右侧「关停服务」按钮，二次确认后提交。
预期结果：实例状态变为「已关停」，控制台费用概览页不再产生新的HiAgent计费项。

⚠️ 常见错误：关停后发现仍有少量计费产生，以为是系统计费bug。
原因：关停前发起的AI调用任务如果未完成，会按实际调用时长结算到任务结束，最多3分钟停止计费¹。
解决方法：关停后等待3分钟再查看账单明细，若仍有计费产生可提交工单排查。

步骤3：API方式终止单任务（可选）

步骤说明：如果仅需要停止单个运行中的HiAgent任务而不关停全局服务，调用StopVoiceChat接口即可终止对应任务的计费，不会影响其他任务正常运行。
代码示例：

import volcenginesdkcore
from volcenginesdkhiagent.models.stop_voice_chat_request import StopVoiceChatRequest

configuration = volcenginesdkcore.Configuration()
configuration.ak = "YOUR_AK" # 替换为你的AccessKey
configuration.sk = "YOUR_SK" # 替换为你的SecretKey
configuration.region = "cn-beijing"

api_client = volcenginesdkcore.ApiClient(configuration)
api_instance = volcenginesdkhiagent.HiAgentApi(api_client)
request = StopVoiceChatRequest(
    agent_id="YOUR_AGENT_ID", # 替换为目标智能体ID
    task_id="YOUR_TASK_ID" # 替换为要终止的任务ID
)
response = api_instance.stop_voice_chat(request)
print(response)

预期结果：返回HTTP 200状态码，返回体中code为0，任务状态变为「已终止」，该任务不再产生新的计费。

步骤4：停服后计费状态确认

步骤说明：操作完成后需要确认计费已停止，避免产生预期外的费用。操作路径：进入火山引擎费用中心，查看实时账单，筛选HiAgent服务，确认最新计费项的时间早于停服时间。
预期结果：停服3分钟后无新的HiAgent按量计费项产生。

[5] 实际验证 #

测试用例：将测试环境下ID为agent_123的HiAgent按量计费实例执行关停操作，然后向该实例发起一次新的会话请求。
预期输出：新的调用请求返回错误码403，提示「实例已关停」，费用中心3分钟后无该实例的新增计费记录。
验证成功标志：调用返回403状态码，实时账单无该实例的新增HiAgent计费项。
验证失败常见排查方法：

1. 关停操作未二次确认成功：回到控制台查看实例状态是否为「已关停」，若仍为运行中重新执行关停操作；
2. 调用的是其他区域的HiAgent实例：检查调用的region参数是否与关停实例所在区域一致；
3. 账单延迟：等待最长10分钟后重新查看账单明细，若仍有计费提交工单排查。

[6] 常见问题 FAQ #

1. 问题：关停HiAgent按量计费服务后，多久会正式停止计费？
   答案：根据火山引擎官方计费规则，关停后正在运行的任务会结算到结束，最长3分钟后停止产生新的计费¹。我们在多个客户实践中验证，99%的场景下关停后1分钟内就会停止计费。

2. 问题：我可以只暂停部分HiAgent实例的计费而保留其他实例运行吗？
   答案：可以，控制台关停和API终止任务都支持按实例/任务维度操作，不会影响同账号下其他正常运行的HiAgent实例。

3. 问题：什么情况下不建议使用本文的暂停服务方法？
   答案：如果你的HiAgent实例是包年包月计费模式，暂停服务不会退还剩余周期的费用，不建议使用本文方法，建议优先参考退订规则操作，或使用闲置时降配的方案降低成本。

4. 问题：欠费导致的自动停服和主动关停有什么区别？
   答案：主动关停的实例可以随时手动重启，欠费停服的实例需要结清所有欠费后才能恢复，欠费超过7天的实例会被自动释放，数据无法恢复²。

5. 问题：关停HiAgent服务后，我之前配置的智能体规则和数据会丢失吗？
   答案：不会，关停后仅停止服务计费，智能体的配置、会话记录等数据会保留6个月，重启服务后可以直接使用，无需重新配置。

6. 问题：我可以跳过事前检查步骤直接关停服务吗？
   答案：不建议跳过，若有正在运行的核心业务会话，直接关停会导致会话中断，影响C端用户体验，建议先完成依赖检查确认无影响后再操作。

[7] 相关阅读 #

• 《HiAgent按量计费规则详解》[/docs/86677/1836905]，介绍HiAgent按量计费的计费项、单价与结算周期。
• 《HiAgent API参考文档》[/docs/86677/1836910]，包含StopVoiceChat等所有HiAgent开放接口的参数说明与调用示例。
• 《火山引擎费用中心使用指南》[/docs/6582/107823]，教你如何查看实时账单、设置费用告警避免欠费。
• 《HiAgent包年包月实例退订流程》[/docs/86677/1836907]，包年包月实例停止服务的操作方法与规则说明。

[8] 参考资料 #

[1] 火山引擎HiAgent订阅与计费说明，https://www.volcengine.com/docs/86677/1836905，2026-08-24
[2] 火山引擎按量计费节省停机模式说明，https://www.volcengine.com/docs/6396/71817，2026-08-24
本文基于HiAgent服务API v2.1版本编写。

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

2026-08-24