方舟Agent Plan三方工具集成流量费：按AFP统一抵扣无额外收费

[1] 一句话结论 #

本指南将详解方舟Agent Plan第三方工具集成的流量计费规则及成本核算方法。

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

适用场景

1. 已购买方舟Agent Plan套餐，需要集成多类第三方工具开发Agent应用的开发者；
2. 单月工具调用量在10万次以内，希望统一核算算力+流量成本的中小团队；
3. 以文本/多模态模型调用为核心，附带少量联网/图片生成工具调用的场景。

不适用场景

1. 仅需要使用单一第三方工具、不需要大模型能力的场景，建议直接采购对应工具的独立套餐；
2. 单月图片/视频生成调用量超1万次的重计算场景，建议单独采购火山引擎智能创意平台资源，成本可降低约30%（数据来源于我们2026年Q2客户成本测算案例）；
3. 需要按流量单独出具发票的企业合规场景，建议走定制化计费方案。

[3] 前置准备 #

• 已开通火山引擎方舟Agent Plan账号，具备套餐查看与成本管理权限；
• 已完成至少1个第三方工具的接入配置；
• 准备好对应版本的方舟SDK：Python 3.8+/Go 1.18+，SDK v2.1.0及以上；
• 预计耗时15分钟完成规则熟悉与成本测算。

[4] 分步实现 #

步骤1：查询当前套餐AFP总额度

步骤说明：方舟Agent Plan所有资源（含第三方工具流量、算力）统一以AFP（Agent燃料值）作为计费单位，无额外流量费，所有工具共享套餐内的AFP总额度，因此首先需要明确当前套餐的可用额度。
代码/命令：

from volcengine.ark import ArkClient

client = ArkClient(api_key="YOUR_API_KEY")
# 查询当前套餐额度
quota = client.get_afp_quota()
print(quota)

预期结果：返回当前套餐的月/周/5小时三重AFP限额，以及剩余可用额度，示例如下：

{"monthly_quota": 100000, "weekly_quota": 25000, "five_hour_quota": 2000, "remaining": 98500}

⚠️ 常见错误：以为第三方工具会单独扣费，额度耗尽后继续调用被拦截
原因：方舟Agent Plan所有资源统一用AFP计量，没有超额后付费机制，任意一个周期的额度耗尽都会直接拦截所有调用
解决方法：提前配置额度告警，或者根据预估消耗购买更高配置的套餐

步骤2：按工具类型核算单次调用AFP消耗

步骤说明：不同类型的第三方工具调用按对应规则折算AFP，无需单独计算流量成本，具体折算规则可参考官方文档，避免错误预估成本。
代码/命令：

# 文本类工具AFP计算示例
def calc_text_afp(input_token: int, output_token: int, input_coef: float=0.25, output_coef: float=0.5) -> float:
    # input_coef为输入token抵扣系数，不同模型系数不同，极速模型低至0.25
    return (input_token * input_coef + output_token * output_coef) / 10000

# 图片生成工具AFP计算示例
def calc_image_afp(image_count: int) -> int:
    # 单张图片基础消耗99AFP
    return image_count * 99

# 计算1次文本工具调用消耗，输入1000token，输出2000token
print(calc_text_afp(1000, 2000)) # 输出：0.125

预期结果：得到单次调用的AFP消耗值，可批量预估月/周消耗总量。

⚠️ 常见错误：联网搜索工具调用被扣了AFP
原因：内置联网搜索工具Beta期每月赠送50-800次免费额度，超出后才会抵扣AFP，免费额度按套餐等级分配
解决方法：在控制台「资源管理」页面查看当月免费联网调用剩余量，超出前可临时减少非必要联网调用

步骤3：核算多工具共享额度的消耗

步骤说明：所有第三方工具共享月/周/5小时三重限额，任意一个限额耗尽都会触发调用拦截，因此需要按最短周期（5小时）预估消耗，避免高峰期额度耗尽影响业务。
预期结果：得到每个周期的预估消耗值，对比当前套餐的周期限额，判断是否会触发额度限制，若预估消耗超过限额，可提前申请临时额度提升或者调整调用策略。

步骤4：配置AFP剩余量告警规则

步骤说明：为了避免额度耗尽导致业务中断，需要在控制台配置AFP剩余量告警，提前收到通知调整策略。
操作示例：登录方舟控制台→进入「成本管理」→「告警配置」→添加告警规则，设置剩余额度低于20%时发送飞书/短信通知。
预期结果：告警规则配置成功，当AFP剩余量低于阈值时，管理员会收到通知。

[5] 实际验证 #

测试用例：调用1次内置联网搜索工具，输入token1000，输出token2000，输入抵扣系数0.25，输出抵扣系数0.5，当月免费联网额度还剩10次。
预期输出：本次调用AFP消耗为0，剩余免费联网额度变为9，HTTP状态码返回200，返回示例如下：

{"code": 200, "data": {"result": "xxx", "afp_consume": 0, "free_network_call_remaining": 9}}

验证成功标志：返回结果中afp_consume字段符合预期，状态码为200，工具返回结果正常。
验证失败常见原因及排查方法：1. afp_consume不为0：检查当月免费联网调用额度是否已经耗尽；2. 返回403状态码：检查5小时AFP额度是否已经用完；3. 抵扣量和预期不符：核对对应工具的抵扣系数是否和官方文档一致。

[6] 常见问题 FAQ #

Q1：第三方工具的外网流量会单独收费吗？
A：不会，所有流量和算力消耗都统一折算为AFP从套餐额度里扣除，没有额外的流量费，数据来源于火山引擎官方计费文档¹。

Q2：我可以跳过AFP抵扣规则查看直接接入工具吗？
A：不建议，不同工具的抵扣系数差异很大，比如极速文本模型系数仅0.25，进阶文本模型系数可达3，如果不提前核算很容易快速耗尽额度。

Q3：什么情况下不建议使用Agent Plan的三方工具集成？
A：如果你的场景只有图片生成需求，不需要大模型能力，就不建议用，建议单独购买图片生成服务，成本会低30%左右，数据来源于我们2026年Q2客户成本测算案例。

Q4：AFP额度耗尽后会产生欠费吗？
A：不会，额度耗尽后所有调用会直接被拦截，不会产生额外费用，等待下一个周期（5小时/周/月）自动重置即可。

Q5：不同套餐的抵扣系数不一样吗？
A：抵扣系数是按工具类型统一的，和套餐等级无关，套餐等级只影响总AFP额度和免费联网调用额度。

[7] 相关阅读 #

1. 《方舟Agent Plan套餐购买指南》[/docs/82379/1925114]，快速了解不同套餐的AFP额度差异
2. 《第三方工具接入开发文档》[/docs/82379/2160841]，详细指导如何接入自定义第三方工具
3. 《AFP抵扣系数官方说明》[/docs/82379/2516287]，查看最新的全工具抵扣系数表
4. 《成本告警配置教程》[/docs/82379/2479130]，手把手教你配置AFP额度告警

[8] 参考资料 #

[1] 套餐内AFP抵扣规则，https://docs.volcengine.com/docs/82379/2516287?lang=zh，2026-08-28
[2] 方舟Agent Plan套餐概览，https://docs.volcengine.com/docs/82379/1925114，2026-08-28
本文基于火山方舟Agent Plan v2.3版本编写

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

2026-08-28