AgentKit按量计费模式：开通使用全流程指南

[1] 一句话结论 #

本指南将带你完成火山引擎AgentKit按量计费模式的开通配置与使用全流程。

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

适用场景

1. 适合日均智能体调用量在5000次以下、流量波动大的中小客户场景，无需预留资源，按实际使用付费。
2. 适合做短期POC验证、项目周期不超过3个月的测试场景，用完即可销毁实例，无长期成本负担。
3. 适合需要根据业务增长动态扩缩容的初创团队场景，无需提前预估容量，避免资源浪费。

不适用场景

1. 日均调用量稳定在10万次以上的规模化生产场景，建议选择包年包月预付费模式，成本可降低30%左右（数据来源：火山引擎AgentKit商用公告）。
2. 需要固定成本预算、不能接受浮动费用的政务/国企类项目，建议选择预留实例计费方案，锁定长期单价。
3. 仅需要单个简单对话机器人、不需要工具调用/多轮编排能力的场景，建议直接使用豆包大模型API，无需使用AgentKit。

[3] 前置准备 #

• 火山引擎账号已完成企业实名认证，个人实名仅支持试用功能，无法用于生产环境。
• 账户余额≥100元，避免开通后因余额不足导致服务关停。
• 已安装火山引擎Python SDK 2.1.0+ 或 Java SDK 1.3.0+，方便通过API管理资源。
• 预计全程操作耗时不超过15分钟。

[4] 分步实现 #

步骤1：开通AgentKit基础服务

步骤说明：首先需要开通智能体平台的基础访问权限，跳过这一步无法进入控制台配置计费模式，也无法调用相关API。
操作：登录火山引擎控制台，在顶部搜索框输入“智能体平台（VEI）”进入产品首页，点击页面顶部的“立即开通”按钮，等待服务自动初始化。

⚠️ 常见错误：点击开通后提示“权限不足无法开通”
原因：账号没有企业管理员分配的AgentKitFullAccess权限，或者未完成企业实名认证。
解决方法：联系企业账号管理员在IAM权限中心添加对应权限，或进入账号中心补全企业实名认证信息后重试。
预期结果：页面自动跳转到AgentKit工作台，顶部无开通提示，左侧导航栏完整显示实例管理、工具编排等功能入口。

步骤2：确认按量计费模式默认开启

步骤说明：2025年10月AgentKit正式商用后，新用户默认开通按量计费模式，无需额外手动切换，需要确认计费项规则是否符合业务预期。
操作：进入控制台左侧“费用管理-计费配置”页面，查看当前计费模式显示为“按量计费（按小时结算）”，同时核对运行时、工具调用、网关流量三个计费项的单价。

⚠️ 常见错误：计费配置页显示为“公测免费”但实际产生扣费
原因：公测免费额度仅针对2025年10月前申请的老用户，新用户默认直接按量计费，无免费额度。
解决方法：可以在费用中心的“优惠管理”页面查看新用户专属折扣，符合条件的可以提交工单申请抵扣首月最高500元的费用。
预期结果：计费配置页清晰展示三个计费项的公示单价，无“未开通计费”相关提示。

步骤3：创建首个按量计费智能体实例

步骤说明：实例进入运行状态后才会开始计费，创建时需要确认计费类型参数正确，避免误选预付费模式产生不必要的成本。
代码示例（Python）：

import volcengine.agentkit.v20250801 as agentkit
from volcengine.agentkit.v20250801.models import *

# 初始化客户端
client = agentkit.AgentkitClient()
client.set_ak("YOUR_ACCESS_KEY") # 替换为你的AK
client.set_sk("YOUR_SECRET_KEY") # 替换为你的SK
client.set_region("cn-beijing")

# 创建运行时实例请求
req = CreateRuntimeRequest()
req.Name = "测试按量计费实例"
req.ChargeType = "PostPaid" # 按量计费固定值，不可修改
req.Spec = "standard.small" # 实例规格，根据业务需求选择

# 发送请求
resp = client.create_runtime(req)
print("实例ID：", resp.Result.RuntimeId)

预期结果：接口返回状态码200，实例ID正常输出，控制台实例列表中显示实例状态为“运行中”，计费模式标注为“按量付费”。

步骤4：查看用量与扣费明细

步骤说明：按量计费按小时结算，每小时整点统计上一小时的用量并从账户余额自动扣费，需要定期核对用量避免超额。
操作：进入火山引擎费用中心，选择“账单管理-明细账单”，产品筛选“智能体平台（VEI）”，时间范围选择最近24小时，即可查看每小时的用量和扣费记录。
预期结果：账单明细中可以看到每个实例的运行时长、工具调用次数、出网流量三个维度的计费明细，扣费金额与公示单价计算结果一致。

[5] 实际验证 #

测试用例：调用你创建的智能体API接口，输入请求内容为“你好，介绍下AgentKit的按量计费规则”，请求头携带正确的AK/SK鉴权信息。
验证成功标志：1. 接口返回HTTP状态码200，响应体中包含智能体生成的正常回复内容；2. 1小时后费用中心明细账单中产生对应工具调用次数的扣费记录，金额为【需补充：工具调用单价】*实际调用次数。
排查方法：1. 如果接口返回403，检查AK/SK是否有对应实例的调用权限，实例是否处于运行状态；2. 如果账单没有对应记录，检查是否为当前小时的调用，结算最长延迟不超过2小时；3. 如果扣费金额异常，联系客服提交工单核对用量统计是否有误。

[6] 常见问题 FAQ #

Q1：开通按量计费模式需要单独申请吗？
A：不需要，2025年10月后新开通AgentKit服务的用户默认开启按量计费模式，不需要额外提交申请，创建实例时选择PostPaid计费类型即可使用。

Q2：按量计费可以随时切换为包年包月吗？
A：可以，你可以在实例列表中选择对应实例，点击“更改计费模式”，选择包年包月的时长支付后即可切换，切换后新的计费模式从下一个计费周期生效。

Q3：什么情况下不建议使用按量计费模式？
A：如果你的业务日均调用量稳定在10万次以上，且需要长期使用（超过6个月），不建议使用按量计费，包年包月模式的成本会比按量低30%左右（数据来源：火山引擎AgentKit商用公告）。

Q4：欠费后服务会立即关停吗？
A：不会，欠费后有24小时的缓冲期，缓冲期内服务可以正常使用，超过24小时仍未充值的话实例会被停止，停止后不再计费，保留7天数据，超过7天未续费实例会被释放。

Q5：我可以在开通后立即销毁实例避免扣费吗？
A：可以，按量计费实例按运行时长累计，最小计费单位是1小时，如果你创建实例后在1小时内销毁，仍然会收取1小时的运行费用，之后不再产生任何费用。

[7] 相关阅读 #

1. 《AgentKit计费规则详解》[/docs/86681/2480915]，介绍各个计费项的计算方式和单价标准
2. 《AgentKit OpenAPI参考文档》[/docs/86681/2085688]，提供所有接口的参数说明和调用示例
3. 《AgentKit欠费说明与续费指南》[/docs/86681/2480917]，讲解欠费后的处理流程和数据保留规则
4. 《AgentKit预付费模式开通指南》[/docs/86681/2480918]，介绍包年包月计费模式的开通方法和优惠政策

[8] 参考资料 #

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

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

2026-08-24