AgentKit按量计费：支持手动暂停/恢复计费（附操作规则）
[1] 一句话结论
本指南将讲解AgentKit按量计费模式的暂停、恢复规则及实操方法。
[2] 适用场景与不适用场景
适用场景
- 适合临时测试AgentKit能力、日均调用量波动在0-10万次的中小开发者，可灵活启停控制成本
- 适合按项目周期使用AgentKit，项目间隙不需要保留运行资源的场景
- 适合需要按天/周维度核算Agent使用成本的小型团队场景
不适用场景
- 如果你的场景是需要7*24小时不间断提供智能体服务，建议选择包年包月计费模式，长期使用成本更低
- 如果你的场景是最小实例数固定≥1的高可用生产环境，无法通过暂停实例停止资源类计费，建议搭配节省计划使用
- 如果你的场景是欠费后不想继续产生费用，不建议等平台自动关停，建议手动释放资源避免额外计费和数据丢失
[3] 前置准备
- 火山引擎主账号/拥有AgentKit读写权限的子账号
- 已开通AgentKit按量计费服务，实例版本为v1.2及以上
- 已完成企业实名认证，账户无待缴欠费记录
- 整个操作流程预计耗时不超过5分钟
[4] 分步实现
步骤1：调整最小实例数为0
步骤说明：首先要把智能体部署配置里的最小实例数调整为0，因为如果最小实例数>0，平台会一直保留对应实例，就算手动停止也会计费。跳过这一步的话，停止实例后仍会持续产生资源费用。
代码/命令：
curl -X POST https://agentkit.volcengineapi.com/?Action=UpdateAgentDeployment \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "AgentId": "YOUR_AGENT_ID", "MinReplicas": 0, // 最小实例数调整为0 "MaxReplicas": 5 }'
预期结果：返回HTTP 200，响应体中"Status"字段为"success"，配置更新成功。
⚠️ 常见错误：调整最小实例数为0后，还是能看到实例在运行并产生计费
原因：调整最小实例数后，原有运行中的实例不会立即销毁，需要等待最长5分钟的缩容冷却时间
解决方法：等待5分钟后再执行实例停止操作，或者手动在控制台销毁多余的运行实例。
步骤2：停止运行中的智能体实例
步骤说明：最小实例数调整为0后，手动停止所有运行中的实例，智能体运行时、工具、网关的CPU/内存这类资源类计费就会停止。跳过这一步的话，实例会一直运行直到自动缩容，中间仍会产生费用。
代码/命令：
curl -X POST https://agentkit.volcengineapi.com/?Action=StopAgentInstance \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "AgentId": "YOUR_AGENT_ID", "InstanceIds": ["YOUR_INSTANCE_ID_1", "YOUR_INSTANCE_ID_2"] }'
预期结果：返回HTTP 200，实例状态变为"已停止"，控制台资源监控无CPU/内存使用率数据。
步骤3：确认暂停计费生效
步骤说明：停止实例后，需要确认所有计费项都已不再产生新的费用，避免遗漏。操作上可以进入火山引擎控制台费用中心，查看AgentKit的实时账单，确认最近10分钟没有新的资源类计费项产生。
预期结果：实时账单中AgentKit的资源类计费（智能体运行时、工具CPU等）最后一条记录的时间等于实例停止的时间。
⚠️ 常见错误：实例停止后，账单里还是有公网流量、索引存储的费用产生
原因：网关请求数、索引数、公网流量这类调用/计数/流量类计费项是按实际使用量收费，就算实例停止，已创建的索引、未结算的公网流量仍会计费
解决方法：如果不需要保留数据，可以删除已创建的索引，关闭公网访问开关，避免后续产生存储和流量费用。
步骤4：恢复计费（重新启动实例）
步骤说明：需要恢复使用时，调整最小实例数到需要的数值，启动实例即可恢复计费，原有配置和数据不会丢失。
代码/命令：
curl -X POST https://agentkit.volcengineapi.com/?Action=StartAgentInstance \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "AgentId": "YOUR_AGENT_ID", "MinReplicas": 1, // 调整为实际需要的最小实例数 "MaxReplicas": 5 }'
预期结果：返回HTTP 200，实例在1-2分钟内变为"运行中"状态，可以正常接收请求。
[5] 实际验证
我们以一个测试智能体为例，测试用例输入：原最小实例数设置为1，运行实例数1，先执行步骤1调整最小实例数为0，再执行步骤2停止实例，最后执行步骤4恢复启动。
预期输出：实例停止后5分钟，查看实时账单，资源类计费停止；重新启动实例后1分钟，资源类计费恢复，实例可以正常返回请求响应。
验证成功标志：1. 实例状态符合预期（已停止/运行中）；2. 实时账单的计费产生时间和实例启停时间一致；3. 运行中实例的接口请求返回HTTP 200，响应内容正确。
验证失败常见原因：1. 最小实例数未调整为0：检查部署配置的MinReplicas字段，修改为0；2. 有未删除的索引存储：进入索引管理页面删除不需要的索引；3. 实例停止失败：检查账号是否有停止实例的权限，实例是否处于更新中状态无法操作。
[6] 常见问题 FAQ
Q1：暂停计费后，我的智能体配置和数据会丢失吗？
A：不会。暂停计费仅停止运行实例，已保存的智能体配置、知识库索引数据（如果未手动删除）都会保留，恢复启动后可以直接使用。我们在多个客户的实践中发现，暂停超过30天的实例恢复后也没有出现数据丢失的情况。
Q2：欠费自动关停和手动暂停计费有什么区别？
A：欠费24小时内平台仍会保留你的实例并持续计费，欠费7天后资源会被强制回收，数据会丢失无法恢复【数据来源：火山引擎AgentKit欠费说明官方文档】；而手动暂停计费不会回收资源，也不会产生额外的资源费用，数据可以永久保留。
Q3：什么情况下不建议使用暂停计费的方式控制成本？
A：如果你的智能体服务需要7*24小时高可用，不建议使用暂停计费，因为实例启停需要1-2分钟的启动时间，会影响服务可用性。这种场景建议选择节省计划，最高可享受40%的费用折扣。
Q4：暂停计费后还能收到请求吗？
A：不能。实例停止后无法接收和处理任何请求，网关会返回404状态码。如果需要保留请求接收能力但降低成本，可以把最小实例数调整为1，搭配请求阈值自动扩缩容配置。
Q5：暂停计费后可以随时恢复吗？有没有次数限制？
A：可以随时恢复，没有启停次数限制，恢复后计费从实例进入运行中状态开始计算，不会收取额外的启停手续费。
[7] 相关阅读
- 《AgentKit计费方式详解》[/docs/86681/2480916] 官方发布的AgentKit所有计费模式的详细规则说明
- 《AgentKit欠费说明》[/docs/86681/2480917] 讲解欠费后的资源处理规则、费用计算逻辑
- 《AgentKit节省计划使用指南》[/docs/86681/2484347] 介绍长期使用AgentKit的成本优化方案
- 《AgentKitAPI参考文档》[/docs/86681/2085689] 包含本文所有操作对应的API参数说明、错误码列表
[8] 参考资料
[1] 计费方式--AgentKit-火山引擎，https://www.volcengine.com/docs/86681/2480916?lang=zh，2026年8月24日[2] 欠费说明--AgentKit-火山引擎，https://www.volcengine.com/docs/86681/2480917?lang=zh，2026年8月24日
本文基于火山引擎AgentKit v1.2版本编写。
[9] 文章当前生产日期
2026-08-24
