方舟Agent Plan智能路由：调用量计费规则及避坑指南

[1] 一句话结论 #

本指南将详解方舟Agent Plan智能路由的调用量计费规则与实操核算方法。

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

适用场景

1. 适合已订阅方舟Agent Plan套餐、使用智能路由调度多模型的开发者，日均调用量在100-10万次区间的场景
2. 适合需要统一核算多模态模型（文本、图片、语音）调用成本的Agent开发场景
3. 适合需要按项目拆分AFP消耗、做成本分摊的团队开发场景

不适用场景

1. 如果你的场景是仅使用单一固定模型、不需要路由调度，建议直接使用对应模型的按量付费接口，无需使用智能路由
2. 如果你的调用量日均超过100万次、需要专属算力集群，建议联系商务采购专属资源包，不适合走普通套餐AFP抵扣
3. 如果你的场景仅需要调用工具（如搜索、数据库）不需要模型调度，建议使用火山方舟工具调用服务，不占用智能路由AFP额度

[3] 前置准备 #

• 开发环境：无特殊要求，只要能访问火山引擎控制台即可，如需API查询用量需Python 3.8+
• 账号权限：已开通方舟Agent Plan订阅，持有账号的财务/用量查看权限
• 依赖项：如需通过API拉取用量，需安装火山引擎Python SDK v2.0.1及以上版本
• 预计耗时：15分钟完成规则理解和用量核算

[4] 分步实现 #

步骤1：确认当前订阅套餐的AFP总额度

步骤说明：首先要明确你订阅的套餐每月总AFP（Agent燃料值）额度，不同档位套餐（Small/Medium/Large）的AFP额度不同，这是抵扣的上限，额度耗尽后调用会被限流。
操作：登录火山引擎控制台→进入方舟Agent Plan管理页→套餐概览，查看月度AFP总额度。
预期结果：能看到类似「月度共享AFP额度：100万」的展示。

⚠️ 常见错误：套餐到期后AFP额度未重置，新产生的调用无法抵扣
原因：AFP额度是按自然月重置，不是按套餐购买日期循环，比如你15号买的套餐，当月额度只能用到当月最后一天，次月1号重置新额度
解决方法：在每月最后3天查看剩余额度，不够的话提前升级套餐或者购买叠加包。

步骤2：按调用模型类型匹配AFP抵扣公式

步骤说明：不同类型的模型调用对应的AFP计算逻辑不一样，需要先判断你路由分发的目标模型属于哪一类：文本/向量化模型按token计算、图片生成按张数计算、视频/语音按时长/字符数计算。
代码示例：

# 文本模型AFP计算示例
input_token = 20000  # 替换为实际输入token数
output_token = 5000  # 替换为实际输出token数
input_coeff = 1.0  # 标准模型输入抵扣系数，极速模型为0.8，进阶为1.2
output_coeff = 2.0 # 标准模型输出抵扣系数，极速模型为1.5，进阶为2.5
afp_cost = (input_token * input_coeff + output_token * output_coeff) / 10000
print(f"本次调用AFP消耗：{afp_cost}")

预期结果：运行后输出本次调用消耗的AFP数值，以上面的示例为例输出为3.0。

⚠️ 常见错误：按调用次数核算成本，和实际AFP消耗差异超过30%
原因：很多开发者误以为智能路由按调用次数计费，实际是按调用的token/张数/时长等维度乘以对应系数计算，长文本调用的AFP消耗是短文本的数十倍
解决方法：每次大请求调用后通过用量接口查询实际消耗，不要按调用次数估算成本。根据我们服务的100+Agent开发者的实践数据，按调用次数估算成本的偏差最高可达70%。

步骤3：核对对应模型的抵扣系数

步骤说明：同一类型的不同模型（比如极速版/标准版/进阶版大模型）、不同输入长度区间的抵扣系数不同，部分官方活动的指定模型还有折扣系数。
操作：访问官方文档的抵扣系数对照表，查询你使用的模型对应的系数。
预期结果：找到对应模型的输入、输出抵扣系数，确认是否有在生效的折扣。

步骤4：累计月度总消耗，判断是否超额度

步骤说明：把当月所有智能路由分发的调用的AFP消耗累加，和套餐月度总额度对比，超出后不会产生额外扣费，但调用会被限流。
操作：可以在控制台用量中心导出近30天的消耗明细，求和得到总消耗。
预期结果：得到准确的月度AFP总消耗，和控制台展示的剩余额度一致。

[5] 实际验证 #

我们用标准文本模型做测试用例：发起一次调用，输入token为10000，输出token为2000，对应的输入抵扣系数为1.0，输出抵扣系数为2.0。
预期输出：本次调用AFP消耗为(100001 + 20002)/10000 = 1.4。
验证成功标志：调用后在控制台用量明细中查到本次调用的AFP消耗为1.4，且剩余额度同步减少1.4，接口返回HTTP状态码为200。
验证失败排查：1. 如果消耗和计算值不一致，优先检查是否用错了抵扣系数，比如误把进阶模型的系数当成了标准模型；2. 如果剩余额度没有减少，检查是否调用的是套餐外的三方模型，这类调用不占用AFP额度；3. 如果消耗为0，检查是否在内测活动免扣额度有效期内。

[6] 常见问题 FAQ #

Q1：智能路由本身的调度会收费吗？
A1：目前内测到正式公测阶段，路由调度本身不额外收费，仅按分发到的目标模型的实际消耗抵扣AFP，后续如果调整收费规则会提前30天在官网公告。

Q2：什么情况下不建议使用智能路由？
A2：如果你的场景是固定调用某一个大模型，且不需要降级、流量切分等路由能力，就不建议使用智能路由，直接调用原模型接口即可，计费逻辑一致还能减少10ms左右的调度延迟。

Q3：AFP额度耗尽后会产生欠费吗？
A3：不会，额度耗尽后智能路由的调用会直接返回429限流错误，不会产生额外扣费，你可以选择升级套餐或者等到下一个自然月额度重置后再使用。

Q4：图片生成模型的调用怎么计算AFP？
A4：图片生成模型按成功生成的张数计算，比如标准SD3模型每张图抵扣0.5AFP，高清4K图抵扣1AFP，生成失败的请求不消耗AFP。

Q5：我可以跳过智能路由直接调用模型吗？
A5：可以，方舟Agent Plan套餐的AFP额度支持直接调用所有套餐内的模型，你可以根据自己的需求选择是否使用智能路由的能力。

Q6：不同区域的调用AFP消耗有差异吗？
A6：没有，国内所有区域的AFP抵扣系数一致，不会因为调用区域不同产生差异。

[7] 相关阅读 #

1. 《方舟Agent Plan套餐概览》[/docs/82379/2366394]，详细介绍各档位套餐的AFP额度和包含的模型权益
2. 《智能模型路由接入指南》[/docs/82379/1828788]，手把手教你接入智能路由的完整流程
3. 《如何查看AFP用量明细》[/docs/82379/2197085]，教你查询每一笔调用的AFP消耗明细
4. 《方舟Agent Plan常见问题汇总》[/activity/agentplan#faq]，官方整理的高频问题解答

[8] 参考资料 #

[1] 火山方舟Agent Plan计费规则说明，https://www.volcengine.com/docs/82379/2516283，2026年8月27日
[2] 智能模型路由官方文档，https://www.volcengine.com/docs/82379/1828788，2026年8月27日
本文基于火山方舟Agent Plan v2.3版本编写

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

2026-08-27