方舟Agent Plan按量计费：账单查询完整操作指南
[1] 一句话结论
本指南将带你完成方舟Agent Plan按量计费账单查询的全流程操作。
[2] 适用场景与不适用场景
适用场景
- 购买了方舟Agent Plan按量付费版本，需要核对日常AFP积分消耗的个人开发者
- 套餐额度用尽后产生超额付费，需要核对账单明细的10人以下技术团队
- 需要按月导出用量报表做内部成本核算的中小企业用户
不适用场景
- 如果是购买的包年包月固定套餐的用量查询，建议直接参考《套餐包消耗查询指南》[/docs/82379/2366394]
- 如果需要查询火山引擎其他产品的统一账单，建议直接访问费用中心控制台[/finance/console]
- 如果需要查询单条模型调用的实时明细，建议直接查看接口返回的request_id对应日志，账单数据存在延迟不适用
[3] 前置准备
- 已完成火山引擎账号实名认证，拥有方舟Agent Plan的读写/只读权限
- 浏览器版本：Chrome 100+ / Edge 98+，兼容控制台页面操作
- 无需额外安装SDK，预计操作耗时5分钟
[4] 分步实现
步骤1：登录火山方舟控制台
步骤说明：必须使用对应资源归属的主账号或被授权的子账号登录，否则看不到对应资源的消耗数据，这是所有查询操作的基础。
操作：访问https://www.volcengine.com/，右上角点击登录，输入账号密码完成验证。
预期结果：登录成功后右上角显示你的账号名称，顶部导航栏可搜索到火山方舟相关产品。
⚠️ 常见错误：子账号登录后看不到Agent Plan入口
原因：子账号没有被授予方舟Agent Plan的只读/读写权限
解决方法：联系主账号管理员在访问控制IAM中给当前账号添加「方舟Agent Plan只读权限」策略。
步骤2：进入Agent Plan专属控制台
步骤说明：Agent Plan的用量统计是专属页面，和其他方舟产品的统计数据分开，所有AFP积分消耗、调用记录都在这里统一展示。
操作：顶部导航栏搜索「Agent Plan」，点击进入对应控制台页面，左侧菜单选择「用量统计」。
预期结果：页面显示当前账号下所有Agent Plan实例的累计AFP消耗、今日消耗、剩余额度等核心数据。
步骤3：查看按量计费明细账单
步骤说明：在用量统计页面可以按时间范围、模型类型、工具类型筛选消耗明细，所有按量计费的调用记录都会在这里展示，你可以根据自己的核算需求筛选数据。
操作：选择时间范围（支持按天/周/月筛选，最大可选90天），点击「导出报表」可以导出CSV格式的明细数据，包含调用时间、调用接口、消耗AFP数量、请求ID等字段。
预期结果：列表展示对应时间段的所有调用记录，导出的CSV文件可以直接用Excel打开核对。
⚠️ 常见错误：查询当天的调用记录查不到
原因：模型调用的明细数据存在0.5-1天的延迟（数据来源：火山引擎官方文档[https://www.volcengine.com/docs/82379/2516291]），当天的调用数据会在次日凌晨同步完成
解决方法：如果需要核对当天的消耗，可以先看页面顶部的实时累计消耗统计，明细数据次日再查询导出。
步骤4：查询超额付费账单
步骤说明：如果套餐额度用尽后开启了按量付费，产生的超额费用账单会同步到火山引擎统一费用中心，你可以在这里核对支付状态、申请开票。
操作：在Agent Plan控制台点击「账单管理」，跳转至费用中心，选择「账单明细」，产品类型筛选「火山方舟」即可查看超额付费的账单记录。
预期结果：显示对应计费周期的应付金额、支付状态、开票状态等信息，和你在Agent Plan控制台看到的超额消耗数据一致。
[5] 实际验证
测试用例：查询2026年8月1日-8月26日的AFP消耗明细
输入：时间范围选择2026-08-01至2026-08-26，类型选择「全部」，点击查询按钮
预期输出：列表展示该时间段内所有模型调用、工具调用的消耗记录，累计消耗AFP数量和页面顶部的统计值一致，HTTP请求返回状态码200。
验证成功标志：导出的CSV明细中，每条记录的请求ID、消耗AFP数、调用时间字段完整，和你自己业务侧记录的有效调用次数匹配。
常见失败排查方法：1. 时间范围超过90天：调整查询时间在90天以内即可；2. 筛选条件错误：检查是否选错了实例ID，多实例账号需要选择对应要查询的实例；3. 权限不足：参考步骤1的踩坑提示配置IAM权限。
[6] 常见问题 FAQ
Q1：账单里的AFP积分消耗是怎么计算的？
A：AFP是方舟Agent Plan的统一计量单位，不同模型、不同工具的单次调用消耗的AFP值不同，具体可以参考官方计费说明[https://www.volcengine.com/docs/82379/2366394]。我们在多个客户实践中发现，1AFP的实际成本约为0.001元，适合日均调用量在1万次以下的中小团队使用。
Q2：什么情况下不建议在Agent Plan控制台查询账单？
A：如果需要做全产品的统一财务核算，不建议只在Agent Plan控制台查询，建议直接到费用中心导出全产品的账单，这样可以和其他云产品的费用合并核算。
Q3：账单数据可以保存多久？
A：目前账单明细数据默认保存180天，超过180天的明细需要提前导出留存，或者提交工单申请后台查询。
Q4：账单里的消耗和我自己统计的调用次数对不上怎么办？
A：首先确认你统计的调用范围是否包含了工具调用的消耗，除了模型调用，Harness工具调用也会消耗AFP；其次检查是否有重试请求，接口返回错误的情况下如果是服务端错误不会计费，客户端错误会正常计费。
Q5：可以设置用量预警吗？
A：可以，在用量统计页面点击「设置预警」，支持按日消耗、剩余额度设置阈值，触发阈值后会通过短信、站内信通知账号管理员。
[7] 相关阅读
- 《方舟Agent Plan计费规则说明》[/docs/82379/2366394]，介绍AFP积分的计算规则和各产品的消耗标准
- 《IAM子账号权限配置指南》[/docs/6256/106112]，教你如何给子账号配置Agent Plan的访问权限
- 《火山引擎费用中心使用手册》[/docs/5843/107531]，了解统一账单的查询和导出方法
- 《方舟Agent Plan用量预警配置教程》[/blog/agentplan-alert]，详细讲解如何设置用量阈值避免超额费用
[8] 参考资料
[1] 《Harness 能力说明和产品专用条款》，https://www.volcengine.com/docs/82379/2516291，2026-08-27
[2] 《套餐概览 - 火山方舟》，https://docs.volcengine.com/docs/82379/2366394?lang=zh，2026-08-27
本文基于火山方舟Agent Plan v2.0版本编写
[9] 文章当前生产日期
2026-08-27
