方舟Agent Plan按量计费：完整扣费规则及避坑指南

[1] 一句话结论 #

本指南将详解方舟Agent Plan按量计费的完整扣费规则，帮开发者准确核算业务成本。

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

适用场景

1. 适合每月AFP使用量波动大，不想被长期套餐绑定的Agent开发测试场景
2. 适合单项目周期短，临时需要调用多模态大模型的短期开发场景
3. 适合日均模型调用量在1000次以下的小型Agent应用生产场景

不适用场景

1. 如果是日均调用量超过1万次的稳定生产场景，建议选择包年包月套餐，比按量计费成本低约30%（数据来源：火山引擎官方定价页）
2. 如果仅需要单一模型能力的场景，不推荐用Agent Plan，建议直接购买对应模型的单独资源包
3. 如果是需要长期固定额度的团队开发场景，建议选择企业版固定额度套餐，避免月度成本大幅波动

[3] 前置准备 #

• 已完成火山引擎账号实名认证，成功开通方舟Agent Plan服务
• 拥有账号财务查看权限，可访问费用中心账单页面
• 已梳理自身业务的模型调用量级和常用模型类型
• 预计阅读时长10分钟

[4] 分步实现 #

步骤1：查询当前AFP剩余额度

步骤说明：Agent Plan采用AFP（Agent Fuel Points）作为统一计量单位，调用服务前先查询剩余额度，是核算扣费、避免服务中断的基础，跳过这一步可能会出现额度意外耗尽导致业务报错。
代码/命令：

curl --request GET \
     --url https://ark.volcengineapi.com/?Action=GetAccountAfpQuota \
     --header 'Authorization: Bearer YOUR_API_KEY' # 替换为你的火山引擎API密钥

预期结果：返回包含month_quota（月度额度）、week_quota（周额度）、rolling_5h_quota（滚动5小时额度）、used_quota（已使用额度）的JSON结构体。

⚠️ 常见错误：只关注月度AFP额度，忽略周/滚动5小时额度限制，导致业务中途无法调用模型
原因：Agent Plan额度有三重校验规则，任意维度额度耗尽都会触发服务调用限制
解决方法：在业务代码中增加三重额度的预检查逻辑，提前配置额度预警阈值

步骤2：核对AFP抵扣系数

步骤说明：不同类型模型的AFP抵扣系数不同，按实际调用的模型类型核算消耗，能避免成本预估出现偏差。根据我们的实践经验，系数偏差是90%以上用户成本预估错误的原因。
抵扣规则（数据来源：火山引擎官方计费文档[1]）：极速类大模型1000输出tokens=1AFP，标准类大模型1000输出tokens=2AFP，进阶类多模态模型1000输出tokens=5AFP，生图模型1张=10AFP。
预期结果：根据业务的模型调用量乘以对应系数，可算出预计消耗的AFP总量。

⚠️ 常见错误：将输入输出tokens合并计算AFP消耗，导致成本预估比实际高50%以上
原因：AFP仅按模型输出的tokens数量核算，输入tokens不消耗AFP
解决方法：核算成本时仅统计模型输出的tokens量即可，无需计入输入部分

步骤3：配置超额后付费开关

步骤说明：超额后付费默认关闭，需要根据业务需求主动配置，避免额度耗尽后服务突然中断，同时可设置单日超额费用上限控制成本风险。
代码/命令：

curl --request POST \
     --url https://ark.volcengineapi.com/?Action=SetOverPayConfig \
     --header 'Content-Type: application/json' \
     --header 'Authorization: Bearer YOUR_API_KEY' \
     --data '{"enable_over_pay": true, "max_over_fee": 1000}' # max_over_fee为单日超额费用上限，单位元

预期结果：返回HTTP 200，响应体code=0表示配置成功。

步骤4：查看实时扣费明细

步骤说明：每次模型调用后都会实时扣减AFP或扣除超额费用，定期查看明细可及时核对成本，排查异常消耗。
操作方法：登录火山引擎控制台→费用中心→账单管理→明细账单，筛选产品为「方舟Agent Plan」。
预期结果：可以看到每笔调用的模型类型、消耗AFP数量/扣费金额、调用时间、请求ID等明细信息。

[5] 实际验证 #

测试用例：调用doubao-3-pro标准类大模型，输入1000tokens，输出1000tokens。
预期输出：AFP额度扣减2个，无额外扣费（账户有剩余额度的情况下）。
验证成功标志：账单明细中显示该笔调用消耗2AFP，账户AFP余额对应减少2，返回HTTP 200状态码。
验证失败常见排查方法：

1. 扣减数量不符：核对调用的模型类型是否匹配对应抵扣系数，是否触发了附加工具调用产生了额外模型输出
2. 产生额外扣费：检查三重额度中是否有一项已经耗尽，确认超额后付费是否已经开启
3. 服务返回403错误：检查是否额度耗尽且超额后付费未开启，或者API密钥权限不足

[6] 常见问题 FAQ #

1. 问题：AFP额度没用完会结转到下个周期吗？
   答案：不会结转，滚动5小时额度到期自动清零，周额度每周一0点清零，月额度每个订阅月1号0点清零，未使用的额度不会累计到下个周期，建议根据实际使用量选择合适的档位。

2. 问题：开启超额后付费后，扣费是实时扣还是月结？
   答案：超额部分的费用是实时从账户余额中扣除，和其他云产品按量计费规则一致，不会累计到月结，你可以在费用中心实时查看扣费明细。

3. 问题：什么情况下不建议开启超额后付费？
   答案：如果你的业务对成本敏感，有严格的月度预算限制，不建议开启超额后付费，避免峰值调用产生超出预算的费用，建议配置多级额度预警，额度耗尽前提前调整业务策略或者补充额度。

4. 问题：调用三方工具会额外消耗AFP吗？
   答案：三方工具调用本身不消耗AFP，但是工具调用过程中产生的模型推理输出tokens，会按照对应模型的抵扣系数消耗AFP，核算成本时需要将这部分纳入统计。

5. 问题：Agent Plan的AFP可以和其他产品的资源包通用吗？
   答案：不可以，AFP是Agent Plan专属的计量单位，仅可用于抵扣Agent Plan内包含的模型和服务消耗，不可用于其他火山引擎产品的费用抵扣。

[7] 相关阅读 #

• 《方舟Agent Plan和Coding Plan选型对比》[/blog/agent-plan-vs-coding-plan]，帮你根据业务场景选择性价比最高的套餐
• 《方舟Agent Plan额度预警配置指南》[/blog/agent-plan-quota-alert]，教你配置多级额度预警，避免服务意外中断
• 《方舟Agent Plan官方API文档》[/docs/82379/2160841]，包含所有AFP查询、配置的完整接口说明

[8] 参考资料 #

[1] 《方舟Agent Plan计费说明》，https://www.volcengine.com/docs/87732/2272741?lang=zh，2026年8月27日
[2] 《火山方舟Agent Plan上线公告》，http://m.toutiao.com/group/7638557019615543844/?upstream_biz=VolcEngine，2026年8月27日
本文基于火山方舟Agent Plan v2.0版本编写。

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

2026-08-27