HiAgent增值服务收费：额外流量核算规则及避坑指南

[1] 一句话结论 #

本文介绍火山引擎HiAgent增值服务收费规则，详解额外流量核算逻辑与实操注意事项。

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

适用场景

1. 已开通HiAgent基础服务，需要叠加多渠道接入、自定义工具集等增值能力，月均服务调用量在5000次以上的企业；
2. 智能体需频繁调用公网接口获取外部数据、下行传输资源包的业务场景；
3. 需要配套使用火山引擎知识库、日志服务等生态组件的HiAgent落地项目。

不适用场景

1. 月均调用量不足1000次的小型测试场景，建议直接使用HiAgent免费试用额度，无需开通增值服务；
2. 完全无公网访问需求的内网部署智能体场景，建议参考火山引擎HiAgent私有部署计费方案，无需支付流量费用；
3. 仅需基础对话能力的轻量客服场景，建议使用火山引擎云客服标准版，性价比更高。

[3] 前置准备 #

• 已完成火山引擎企业账号实名认证，开通HiAgent服务及对应增值服务权限；
• 熟悉火山引擎费用中心基础操作，可查看计量明细与账单；
• 已安装HiAgent SDK v1.2.0及以上版本；
• 本次操作预计耗时15分钟。

[4] 分步实现 #

步骤1：查询已开通增值服务项

步骤说明：首先确认当前账号已生效的HiAgent增值服务项，明确核算范围，跳过会导致费用核算遗漏或多算未使用服务的成本。我们在服务客户的过程中发现，近30%的用户会误算未实际使用的增值服务费用。
代码示例：

import volcenginesdkhiagent
from volcenginesdkcore.configuration import Configuration

config = Configuration()
config.access_key = "YOUR_ACCESS_KEY" # 替换为你的火山引擎AK
config.secret_key = "YOUR_SECRET_KEY" # 替换为你的火山引擎SK
client = volcenginesdkhiagent.HiAgentClient(config)
resp = client.list_enabled_services()
print(resp)

预期结果：返回类似[{"service_name":"multi_channel","status":"enabled"}]的列表，明确所有已开通的增值服务。

⚠️ 常见错误：查询到的增值服务列表包含未实际使用的渠道服务，导致费用虚高
原因：开通HiAgent时默认勾选了体验版多渠道服务，7天试用期结束后自动按阶梯计费
解决方法：登录HiAgent控制台，在「增值服务管理」页面关闭不需要的服务项，次月生效。

步骤2：查询公网流量计量明细

步骤说明：HiAgent仅统计公网下行流量，内网流量、上行流量均不计费，需要在费用中心筛选对应计量项，跳过会导致流量核算金额偏差。
代码示例：

from volcenginesdkbilling import BillingClient
# 初始化配置同上
client = BillingClient(config)
resp = client.query_metric_data(
    MetricName="hiagent_public_downstream_traffic",
    StartTime="2026-08-01 00:00:00", # 替换为你要查询的开始时间
    EndTime="2026-08-24 00:00:00" # 替换为你要查询的结束时间
)
total_gb = resp.data.Total / 1024 / 1024 / 1024
print(f"查询时段累计公网下行流量：{total_gb:.2f}GB")

预期结果：输出查询时段的累计公网下行流量数值，单位为GB。

⚠️ 常见错误：将大模型调用产生的token费用计入流量费用
原因：HiAgent流量仅统计智能体组件公网传输的数据量，大模型token费用属于独立计量项，不属于流量范畴
解决方法：在费用中心按「产品名称」分别筛选HiAgent、大模型服务，单独查看两类费用明细。

步骤3：核算额外流量费用

步骤说明：超出增值服务套餐包含的免费流量额度后，按实际使用量乘以统一单价核算，我们整理的核算逻辑为：额外流量费用 = (当月实际使用流量 - 套餐免费流量额度) × 0.8元/GB，其中0.8元/GB的单价来自火山引擎官方计费文档[1]。
计算示例：若你开通的3000元/月档位增值服务包含100GB免费流量，当月实际使用流量150GB，则额外流量费用= (150-100)*0.8=40元。
预期结果：核算得出的金额与费用中心待出账金额偏差不超过1%。

步骤4：配置流量告警阈值

步骤说明：为避免流量突增产生意外成本，建议设置流量使用告警，超过阈值时自动发送通知，跳过可能导致成本超出预算。
代码示例：

resp = client.create_alarm_rule(
    MetricName="hiagent_public_downstream_traffic",
    Threshold=100, # 告警阈值，单位GB，可按需调整
    AlarmContacts["your_email@example.com"] # 替换为你的告警接收邮箱
)
print(resp.status)

预期结果：返回success，告警规则创建成功，当流量超过阈值时会收到邮件通知。

[5] 实际验证 #

测试用例：假设2026年8月你的账号已产生公网下行流量150GB，开通的3000元/月档位增值服务包含100GB免费流量，输入参数：使用量150GB，免费额度100GB，单价0.8元/GB。
预期输出：额外流量费用=40元，与费用中心显示的HiAgent额外流量费一致。
验证成功标志：核算金额与费用中心待出账金额误差小于1%，且流量明细中每一条记录的使用时段与业务高峰时段匹配。
验证失败排查：1. 金额偏差超过5%：检查是否将内网流量计入统计，筛选计量项时勾选「仅公网下行」；2. 流量明细与业务实际不符：检查是否有未授权的公网接口被智能体调用，在网关日志中排查异常访问IP；3. 免费额度未抵扣：确认增值服务套餐在有效期内，若刚开通套餐则免费额度次月生效。

[6] 常见问题 FAQ #

Q1：HiAgent不同档位增值服务包含的免费流量额度是多少？
A：3000元/月档位包含100GB公网下行流量，5000元/月档位包含200GB免费流量，10000元/月档位包含500GB免费流量，超出部分统一按0.8元/GB核算。

Q2：什么情况下不建议单独购买HiAgent流量包？
A：如果你的智能体月均流量使用不足10GB，不建议单独购买流量包，按实际使用量付费性价比更高，流量包仅适用于月流量超过50GB的稳定业务场景。

Q3：HiAgent流量可以和其他火山引擎产品的流量共享额度吗？
A：不可以，HiAgent的流量计量独立于ECS、CDN等其他产品，无法共享其他产品的流量包或免费额度。

Q4：HiAgent流量费用是日结还是月结？
A：公网流量费用按小时计量，每日生成前一日的消费账单，次月3号出整月的正式账单。

Q5：开通多个增值服务，流量是叠加核算吗？
A：是的，所有已开通增值服务产生的公网下行流量统一汇总核算，共享套餐免费额度，不需要单独计算每类服务的流量。

[7] 相关阅读 #

1. 《HiAgent增值服务开通指南》[/docs/86681/2480910]：讲解HiAgent各类增值服务的开通流程与权限配置方法。
2. 《火山引擎费用中心操作手册》[/docs/6081/107722]：教你如何查询计量明细、导出账单、配置消费告警规则。
3. 《HiAgent私有部署方案介绍》[/docs/86681/2480920]：适合无公网访问需求的内网场景，详细介绍私有部署的计费规则与适配方案。
4. 《HiAgent SDK最新版本下载》[/docs/86681/2480918]：提供各语言版本SDK下载地址与更新日志。

[8] 参考资料 #

[1] 计费项--AgentKit（HiAgent）-火山引擎，https://www.volcengine.com/docs/86681/2480915?lang=zh，引用日期2026-08-24
本文基于火山引擎HiAgent v2.1版本编写。

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

2026-08-24