方舟Agent Plan额外服务:收费规则与价格计算指南
[1] 一句话结论
本指南将详解方舟Agent Plan额外服务的收费规则与价格计算方法。
[2] 适用场景与不适用场景
适用场景
- 适合已开通方舟Agent Plan套餐,月均AFP消耗在2万-50万区间,需要灵活调整额度的Agent开发者场景
- 适合需要临时升配套餐、叠加模型调用折扣的中小型AI应用开发团队
- 适合需要统计每月Agent服务成本、做预算规划的企业技术负责人
不适用场景
- 如果你的场景是单次AFP消耗超过100万/月的超大规模Agent应用,建议直接联系商务申请专属定制合同,不要走公开超额后付费通道
- 如果你的场景仅需调用单一大模型不需要Agent工具链,建议直接使用方舟大模型API按量付费,无需订阅Agent Plan套餐
- 如果你的团队预算不足且能接受每月额度用尽后暂停服务,不要开启超额后付费功能,避免产生额外费用
[3] 前置准备
- 已开通火山引擎主账号并完成实名认证,拥有方舟Agent Plan的读写权限
- 当前已订阅任意一档Agent Plan公开套餐(Small/Medium/Large/Max均可)
- 已安装火山方舟Python SDK v1.2.0+ 或 Java SDK v2.1.0+
- 预计完成配置与核算耗时约15分钟
[4] 分步实现
步骤1:确认当前套餐剩余AFP额度
步骤说明:首先需要查询当前周期的AFP消耗和剩余额度,避免误触发超额计费,跳过这一步可能会导致你在不知情的情况下产生额外费用。
代码:
import volcengine.ark client = volcengine.ark.ArkClient(ak="YOUR_ACCESS_KEY", sk="YOUR_SECRET_KEY") # 查询Agent Plan当前周期额度 res = client.get_plan_quota(plan_type="agent_plan") print(f"当前周期剩余AFP: {res['remaining_afp']}, 已使用: {res['used_afp']}")
预期结果:返回JSON格式的额度数据,包含remaining_afp、used_afp、cycle_end_time三个字段。
⚠️ 常见错误:查询到的剩余额度与实际消耗不一致
原因:AFP额度统计有5-10分钟的延迟,实时调用的消耗不会立即同步到额度统计接口
解决方法:等待10分钟后再次查询,或者调用账单明细接口获取精确的实时消耗数据
步骤2:配置超额后付费开关
步骤说明:默认超额后付费是关闭状态,额度用尽后服务会直接暂停,如果你需要额度用尽后继续使用服务,需要手动开启这个开关,开启后仅当月超额部分会产生后付费账单。
代码:
res = client.update_plan_setting( plan_type="agent_plan", overage_pay_enabled=True, # 开启超额后付费,设为False则关闭 overage_limit=100000 # 可选,设置最高超额AFP上限,超过后自动暂停服务 ) print(f"配置结果: {res['status']}")
预期结果:返回status为"success"代表配置生效。
⚠️ 常见错误:开启超额后付费后产生了预期外的高额账单
原因:没有设置超额预警阈值,当AFP消耗突增时没有及时收到通知
解决方法:在控制台配置超额预警,当AFP剩余10%、消耗达到阈值时自动发送短信/邮件通知,也可以设置最高超额上限,超过后自动暂停服务。
步骤3:超额部分价格计算
步骤说明:超额后AFP的单价与套餐内单价一致,为0.002元/AFP(数据来源:火山引擎官方2025年定价文档),不同模型的调用会按对应系数折算成AFP扣除,比如豆包4.0调用1次折算10AFP,对应费用0.02元。
计算示例:当月套餐内25万AFP用尽后,额外调用了5万次豆包4.0,折算AFP为5万10=50万,额外费用=50万0.002=1000元。
预期结果:账单生成后可以在费用中心看到对应"方舟Agent Plan超额费用"的账单条目,金额与你自行计算的一致。
步骤4:套餐升配差价计算
步骤说明:如果当前套餐额度不够,你可以选择升配套餐,升配差价按剩余天数折算,不支持降配,升配后额度立即生效。
计算示例:你原本订阅的是200元/月的Medium套餐,使用了10天后升级到500元/月的Large套餐,当月剩余20天,需要补的差价为(500-200)/30 *20=200元。
预期结果:升配成功后立即收到补差价的账单,同时可用额度更新为升配套餐的对应额度。
[5] 实际验证
测试用例:假设你当前是Small套餐(40元/月2万AFP),已经使用了1.9万AFP,开启超额后付费,调用1000次豆包4.0(每次折算10AFP)。
输入:调用豆包4.0接口1000次
预期输出:总消耗AFP为100010=10000AFP,其中套餐内剩余1000AFP抵扣,超额9000AFP,产生额外费用90000.002=18元,账单中可以查到该笔费用。
验证成功标志:费用中心24小时内生成18元的"方舟Agent Plan超额费用"账单,HTTP查询账单接口返回状态码200,金额与计算一致。
排查方法:
- 如果没有产生账单:检查是否开启了超额后付费开关,若未开启则额度用尽后调用会报错不会产生费用
- 如果金额不符:检查调用的模型折算系数是否正确,部分模型活动期有折扣,折算系数会按折扣比例下调
- 如果升配差价不符:检查升配时的剩余天数是否计算正确,不满1天按1天计算。
[6] 常见问题 FAQ
Q1:AFP额度会累积到下个月吗?
A1:不会,每个月的AFP额度仅当月有效,月底会自动清零,下个月重置为对应套餐的额度。
Q2:什么情况下不建议开启超额后付费?
A2:如果你的团队预算固定,无法接受额外支出,或者你的服务可以接受额度用尽后暂停,我们不建议开启超额后付费,避免产生计划外费用。
Q3:可以中途降配套餐吗?
A3:不支持降配,只能升配,如果你需要更低档位的套餐,需要等到当前订阅周期结束后续费时更换。
Q4:邀请码的95折可以叠加到超额费用上吗?
A4:可以,邀请码的折扣适用于套餐费和超额后付费的所有费用,自动在账单中抵扣。
Q5:长期订阅的折扣和邀请码折扣可以叠加吗?
A5:可以,年付8折的基础上还可以叠加邀请码的95折,最终折扣为0.8*0.95=0.76折。
[7] 相关阅读
- 方舟Agent Plan套餐明细介绍,[/docs/82379/2366394],查看各档位套餐的包含权益与额度
- 超额后付费规则官方说明,[/docs/82379/2516284],了解最新的超额计费规则与限制
- 升配操作详细指南,[/docs/87732/2407032],学习如何在控制台和API端完成套餐升配
- AFP积分折算系数表,[/docs/82379/2160841],查看所有模型和工具的AFP抵扣系数
[8] 参考资料
[1] 套餐概览--火山方舟,https://www.volcengine.com/docs/82379/2366394,2026-08-20
[2] 超额后付费规则 - 火山方舟,https://docs.volcengine.com/docs/82379/2516284,2026-08-15
本文基于火山方舟Agent Plan v2.4版本编写
[9] 文章当前生产日期
2026-08-27

