HiAgent收费说明与私有化部署要求实操指南

[1] 一句话结论 #

本指南将明确HiAgent收费标准及私有化部署的完整条件与实操流程。

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

适用场景

1. 适合企业级对话系统开发，日均调用量10万次以下的中小客户按需采购公有云服务；
2. 适合数据安全要求高、需要100%控制数据流向的金融、政务客户部署私有化版本；
3. 适合需要定制化开发AI代理流程、对接内部业务系统的中大型企业客户。

不适用场景

1. 个人开发者测试场景，月调用量低于1000次的，不建议采购私有化，建议直接使用公有云免费额度；
2. 纯C端轻量问答场景，峰值QPS低于5的，不建议用私有化，建议直接使用豆包API对接；
3. 10人以下无专职运维团队的小型团队，不建议部署私有化，建议选择HiAgent托管版服务。

[3] 前置准备 #

• 开发环境与版本要求：Python 3.8+，私有化部署需K8s 1.22+版本
• 账号与权限要求：火山引擎企业实名认证账号，已开通HiAgent服务权限
• 依赖项与SDK版本：HiAgent Python SDK 0.2.3+，Java SDK 1.1.2+
• 预计耗时：公有云权限开通与对接1小时，私有化部署3-5个工作日

[4] 分步实现 #

步骤1：查询对应版本收费标准

步骤说明：首先明确自身业务是公有云还是私有化需求，对应查询官方公开定价，避免被非官方渠道误导。跳过这一步可能会出现预算与实际成本偏差过大的问题。
代码示例：

import volcenginesdkhiagent
# 初始化客户端，密钥替换为自己的账号密钥
client = volcenginesdkhiagent.Client(
    access_key="YOUR_ACCESS_KEY",
    secret_key="YOUR_SECRET_KEY",
    region="cn-beijing"
)
# 查询收费标准，public_cloud对应公有云，private_cloud对应私有化
resp = client.describe_product_price(ProductType="public_cloud")
print(resp)

预期结果：返回包含计费项（调用次数、资源包、license年费）的JSON结构。

⚠️ 常见错误：查询到的私有化报价只包含基础license费用，很多客户误以为报价就是落地总价，实际结算时出现超预算问题。
原因：官方公开报价仅包含软件本身费用，实施、定制开发、运维服务需要额外评估。
解决方法：提交工单联系商务经理，提供业务场景和具体需求后获取完整落地报价。

步骤2：私有化部署前置资源校验

步骤说明：部署前必须校验集群资源、网络策略、存储是否符合要求，避免部署到一半失败，浪费双方时间。
命令示例：

# 检查K8s版本是否符合要求
kubectl version --short
# 检查集群空闲资源是否达标
kubectl describe nodes | grep -A 5 "Allocated resources"

预期结果：K8s版本≥1.22，集群空闲CPU≥8核，空闲内存≥16G。

⚠️ 常见错误：集群开启了强制网络策略，导致HiAgent内部组件之间无法通信，部署后服务启动失败。
原因：HiAgent默认需要集群内组件之间开放80、443、8080等端口的互通权限，强制网络策略会拦截这些请求。
解决方法：部署前配置网络策略白名单，允许HiAgent命名空间下的所有Pod内部互通。

步骤3：提交私有化部署申请

步骤说明：在火山引擎控制台HiAgent页面提交部署申请，填写业务场景、集群信息、数据安全要求、预期上线时间等内容，等待官方审核。跳过这一步无法获取私有化部署包和技术支持。
预期结果：1个工作日内收到审核通过通知，专属商务经理和实施工程师会主动联系对接后续流程。

步骤4：部署实施与验收

步骤说明：配合火山引擎实施团队完成集群配置、服务部署、功能测试，验收通过后正式上线。
预期结果：服务可用率达到99.9%，单次请求延迟≤200ms（数据来源：《火山引擎HiAgent私有化SLA协议》）。

[5] 实际验证 #

测试用例：
公有云场景：调用HiAgent会话接口，输入prompt为“你好”，预期输出包含正常的AI回复内容，HTTP状态码为200，控制台账单记录对应调用次数。
私有化场景：访问部署后的服务健康检查接口https://{你的私有化域名}/health，返回{"status":"ok"}，且调用会话接口可正常返回结果，数据未流出内网。
验证成功标志：连续72小时服务无异常，功能符合预期，计费账单准确。
失败排查方法：

1. 调用返回403：检查密钥是否正确，是否开通了对应版本的HiAgent服务权限；
2. 私有化服务启动失败：检查集群资源是否足够，网络策略是否放开HiAgent组件的互通权限；
3. 计费异常：检查是否购买了对应资源包，超出额度是否开启了按量付费开关。

[6] 常见问题 FAQ #

Q1：HiAgent公有云有免费额度吗？
A：有的，新用户开通后可获得每月1000次的免费调用额度，有效期3个月，超过后按调用量阶梯计费，具体可参考官方定价页。

Q2：私有化部署最低需要多少费用？
A：HiAgent私有化基础版年费为15万元/年（数据来源：火山引擎HiAgent官方公开报价2026版），包含基础功能和5个坐席license，定制功能需要额外收费。

Q3：什么情况下不建议部署私有化？
A：如果你的业务没有强数据隔离要求，且日均调用量低于1万次，不建议部署私有化，公有云版本的成本仅为私有化的1/10左右，性价比更高。

Q4：私有化部署后可以对接内部系统吗？
A：可以，HiAgent私有化版本支持自定义插件开发，可对接企业内部OA、CRM、数据库等系统，所有数据都在企业内网流转，不需要对外传输。

Q5：可以跳过资源校验步骤直接部署吗？
A：不可以，我们在3个客户的实践中发现，跳过资源校验的部署失败率高达60%，会浪费至少2个工作日的部署时间，建议必须提前完成校验。

[7] 相关阅读 #

1. 《HiAgent公有云快速接入教程》，[/docs/hiagent/quickstart/public]，零基础1小时完成公有云服务对接；
2. 《HiAgent私有化部署运维手册》，[/docs/hiagent/deploy/private_operation]，部署后日常运维操作全指南；
3. 《HiAgent计费规则详细说明》，[/docs/hiagent/price/billing]，解读计费项、账单查询、欠费处理规则；
4. 《HiAgent与豆包API选型对比指南》，[/blog/hiagent-vs-doubao-api]，帮助你选择适合业务的AI服务方案。

[8] 参考资料 #

[1] 火山引擎HiAgent官方定价页，https://www.volcengine.com/product/hiagent/pricing，2026-08-20
[2] HiAgent私有化部署规范v2.1，https://www.volcengine.com/docs/hiagent/deploy/spec，2026-08-15
本文基于HiAgent产品版本v2.1编写。

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

2026-08-24