AgentKit收费规则：调用API需额外支付网关费用

[1] 一句话结论 #

本指南将详解火山引擎AgentKit收费规则，明确API调用的付费要求与计费逻辑。

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

适用场景

1. 适合使用AgentKit搭建智能体、日均API调用量1000次以上的ToB服务场景，可享受内置的流量管控、日志审计能力。
2. 适合需要统一管理Agent工具调用、多模型路由的中大型开发团队，降低自研编排层的研发成本。

不适用场景

1. 仅需要直接调用大模型API、不需要Agent编排能力的场景，建议直接使用火山引擎方舟大模型服务，无需支付AgentKit网关费用。
2. 个人开发者日均调用量低于100次的测试场景，建议先使用开源Agent框架搭建原型，待业务上量后再接入AgentKit商用服务。

[3] 前置准备 #

• 火山引擎账号已完成企业实名认证，已开通AgentKit服务权限
• 已安装AgentKit Python SDK v1.2.0+ 或 Java SDK v2.1.0+
• 准备好具备计费查询权限的AccessKey密钥对
• 预计阅读+实操耗时15分钟

[4] 分步实现 #

步骤1：查询账户计费状态

步骤说明：首先确认你的AgentKit服务处于公测还是商用阶段，不同阶段计费规则差异较大，跳过这一步可能会导致你对产生的账单毫无预期。
代码示例：

from volcengine.agentkit import AgentKitClient

# 初始化客户端
client = AgentKitClient(
    access_key="YOUR_ACCESS_KEY", # 替换为你的AccessKey
    secret_key="YOUR_SECRET_KEY"  # 替换为你的SecretKey
)

# 查询账户计费状态
resp = client.get_account_billing_info()
print("计费状态：", resp["billing_status"])

预期结果：返回billing_status字段为commercial表示已进入商用计费阶段，返回beta表示仍在公测免费期。

⚠️ 常见错误：误以为所有账户都有免费公测期，商用后突然产生大额账单
原因：2026年5月27日后新开通的AgentKit服务默认直接进入商用阶段，没有免费公测额度
解决方法：开通服务后第一时间调用上述接口查询计费状态，商用新用户可在控制台领取首月10元免费额度用于测试。

步骤2：配置计费阈值告警

步骤说明：设置合理的计费告警可以避免调用量突增导致的超额支出，跳过这一步可能出现月末账单远超预期的情况。
操作流程：登录火山引擎控制台→进入费用中心→选择告警配置→新增告警规则，选择「AgentKit」产品，设置网关日请求数告警阈值（建议设置为日常调用量的120%），通知方式选择短信+邮件。
预期结果：配置完成后，当日网关调用量达到阈值的80%、100%时会分别收到提醒通知。

⚠️ 常见错误：只计算AgentKit网关费用，忽略底层大模型Token消耗费用
原因：AgentKit的收费仅包含智能体运行、工具调用、网关三大组件，调用大模型产生的Token费用会单独计入方舟大模型服务账单
解决方法：分别为AgentKit和方舟大模型服务设置独立的计费告警，两类费用会分开出账、独立结算。

步骤3：查询实时账单明细

步骤说明：通过API查询实时账单可以核对调用量与费用是否匹配，避免出现错账、漏账的情况。
代码示例：

# 查询指定时间段的账单明细
resp = client.get_bill_detail(
    start_date="2026-08-01",
    end_date="2026-08-24"
)

print("网关调用总费用：", resp["gateway_fee"])
print("智能体运行总费用：", resp["agent_runtime_fee"])
print("工具调用总费用：", resp["tool_fee"])

预期结果：返回对应时间段内各计费项的明细和总费用，其中网关费用按每千次请求0.025元计算，数据来源为火山引擎官方计费文档¹。

[5] 实际验证 #

测试用例：连续调用1000次AgentKit CreateSession网关API

• 输入：构造合法的CreateSession请求，循环调用1000次
• 预期输出：账单明细中网关请求数新增1000次，对应费用增加0.025元，所有请求返回HTTP 200状态码

验证成功标志：费用中心的AgentKit账单与实际调用量完全匹配，无异常扣费项。

验证失败排查方法：

1. 账单没有对应调用记录：检查请求是否命中限流被拒绝，被限流拒绝的请求不计入计费；
2. 费用比预期高：检查是否调用了付费工具组件，工具调用会按照调用次数单独计费，不计入网关费用；
3. 账单延迟：实时账单最多有15分钟的延迟，若调用后立刻查询不到可等待15分钟后重试。

[6] 常见问题 FAQ #

Q1：AgentKit调用API需要额外付费吗？
A：是的，API调用属于网关计费项，每千次请求定价0.025元，与底层大模型Token费用分开计费、独立出账。

Q2：什么情况下不建议使用AgentKit？
A：如果你的场景仅需要直接调用大模型API，不需要Agent编排、工具调用管理、多模型路由能力，不建议使用AgentKit，直接使用方舟大模型服务可以节省网关费用。

Q3：公测期的账户调用API也需要付费吗？
A：2026年5月27日前开通的公测期账户，公测期间网关调用、智能体运行均免费，仅需支付底层大模型的Token消耗费用，公测结束后会自动转为商用计费。

Q4：我可以跳过AgentKit网关，自己代理API请求吗？
A：可以，自行代理请求的话不需要支付网关费用，但会丢失AgentKit自带的流量管控、降级熔断、日志审计、多租户隔离等能力。

Q5：AgentKit有没有包年包月的计费模式？
A：目前仅支持按量后付费模式，没有包年包月选项，月调用量超过1亿次的客户可以联系商务申请阶梯折扣，最高可享受30%的费用优惠。

[7] 相关阅读 #

1. AgentKit官方开发指南 [/docs/86681/2085688]，包含完整的API调用示例和参数说明
2. 火山引擎费用中心使用教程 [/docs/6528/106510]，教你如何设置计费告警和导出明细账单
3. 方舟大模型服务收费标准 [/docs/8458/2070726]，了解底层大模型Token计费规则

[8] 参考资料 #

[1] 计费项--AgentKit-火山引擎，https://www.volcengine.com/docs/86681/2480915?lang=zh，2026-08-24
[2] 【计费公告】AgentKit商用公告，https://www.volcengine.com/docs/86681/2484346?lang=zh，2026-08-24
本文基于火山引擎AgentKit v2.0版本编写。

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

2026-08-24