HiAgent免费试用到期：10分钟无中断切换付费版教程

[1] 一句话结论 #

本指南将带你完成HiAgent免费试用到期后切换付费版全流程，保障业务无中断。

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

适用场景

1. 免费试用额度耗尽（赠送10000次API调用/30天有效期到期，数据来源：火山引擎HiAgent官方文档），需要保留试用期间配置的智能体、知识库数据继续使用的场景
2. 日均对话请求量超过500次，需要解锁多渠道接入、自定义话术等付费功能的企业客户场景
3. 需要获取官方技术支持SLA保障，业务可用性要求不低于99.9%的生产环境场景

不适用场景

1. 仅做临时技术调研、后续无上线需求的场景，建议直接使用火山引擎公开的智能体Demo体验，无需开通付费
2. 单月API调用量低于100次的个人测试场景，建议选择火山引擎轻量智能体服务替代，成本降低60%以上
3. 需要完全本地化部署、数据不能出域的场景，建议参考火山引擎私有部署版大模型解决方案，不要开通公有云付费版

[3] 前置准备 #

• 开发环境：无需额外开发环境，仅需Chrome 100+/Edge 100+版本浏览器即可操作
• 账号权限：使用HiAgent平台的企业主账号，或拥有「计费管理」权限的子账号
• 依赖项：无额外SDK依赖，如需后续API调用可提前准备HiAgent SDK v1.2.0版本
• 预计耗时：10分钟（不含支付审批时间）

[4] 分步实现 #

步骤1：登录控制台查询试用状态

步骤说明：首先要确认当前账号的试用剩余情况，避免提前切换产生不必要的成本，跳过这一步可能会导致你选错套餐类型。
操作：使用原有账号登录HiAgent控制台，点击左侧菜单栏「计费管理」-「资源概览」，即可查看剩余试用额度、到期时间。
预期结果：页面清晰展示"已使用API调用次数/剩余次数"、"距离到期剩余天数"，如果已经到期会显示红色的"试用已过期"标识。

⚠️ 常见错误：子账号登录后看不到计费管理菜单
原因：子账号未被主账号分配计费管理的权限，我们在客户支持中发现80%的权限类问题都是这个原因导致
解决方法：联系企业主账号管理员，在访问控制（IAM）中为子账号添加「BillingFullAccess」权限即可。

步骤2：选择适配的付费套餐

步骤说明：根据自身业务规模选择对应计费模式，避免资源浪费或不足。HiAgent支持两种付费模式：按量付费、包年包月混合套餐，可灵活选择。
操作：在「计费管理」-「订阅服务」页面，按需选择套餐：

• 按量付费：适合业务量波动大的场景，按API调用次数0.001元/次计费（数据来源：火山引擎HiAgent定价页）
• 包年包月：固定坐席费（199元/坐席/月）+功能费，适合业务量稳定的客服场景
  如果需要通过API开通，可使用以下代码：

import volcengine.hiagent.v20230801 as hiagent
from volcengine.volcengineutil import VolcEngineUtil

client = hiagent.Client()
client.set_access_key("YOUR_ACCESS_KEY") # 替换为你的AK
client.set_secret_key("YOUR_SECRET_KEY") # 替换为你的SK
client.set_region("cn-beijing")

# 开通按量付费模式
req = {
    "PayMode": "PayAsYouGo",
    "ProductType": "Standard"
}
resp = client.create_subscription(req)
print(resp)

预期结果：页面显示"套餐选择成功，请确认订单"，API调用返回HTTP 200，包含SubscriptionId字段。

步骤3：完成支付激活服务

步骤说明：确认订单信息完成支付，系统会自动激活付费权限，试用期间的所有配置数据都会自动保留，无需迁移。
操作：核对订单金额、计费周期，提交订单后选择企业支付/线上支付渠道完成缴费。
预期结果：支付完成后1分钟内，控制台顶部的"试用已过期"提示消失，所有灰色不可用的付费功能按钮恢复可点击状态。

⚠️ 常见错误：支付完成后仍然显示试用过期，功能无法使用
原因：浏览器缓存未更新，或系统激活存在延迟
解决方法：首先强制刷新控制台页面（Ctrl+F5），如果5分钟后仍然异常，可提交工单联系技术支持，提供订单号即可快速排查。

步骤4：验证付费功能配置

步骤说明：确认付费功能正常可用，避免业务出现中断。
操作：进入你之前试用期间创建的智能体页面，测试多渠道接入、知识库扩容等付费功能，同时在「调用统计」页面查看请求是否正常计费。
预期结果：所有功能操作正常，调用统计页面实时展示当日的API调用量和预估费用。

[5] 实际验证 #

你可以使用以下测试用例验证切换是否成功：
测试输入：调用智能体API接口

{
    "AgentId": "YOUR_AGENT_ID", # 替换为你的智能体ID
    "Query": "测试付费功能是否正常",
    "Stream": false
}

预期输出：

{
    "ResponseMetadata": {
        "RequestId": "xxxxxx",
        "Action": "SendMessage",
        "Version": "2023-08-01",
        "Service": "hiagent",
        "Region": "cn-beijing",
        "HttpStatusCode": 200
    },
    "Result": {
        "Answer": "付费功能已正常激活，当前请求已计入按量计费",
        "SessionId": "xxxxxx"
    }
}

验证成功标志：返回HTTP 200状态码，且Answer字段符合预期，调用统计页面新增1次调用记录。
验证失败常见排查方向：

1. 套餐未生效：检查「订阅服务」页面是否显示当前为付费状态，若未生效联系客服处理
2. API密钥权限不足：检查调用使用的AK/SK是否属于当前已开通付费的账号
3. 智能体配置异常：检查智能体是否处于已发布状态，未发布的智能体无法响应请求

[6] 常见问题 FAQ #

Q1：免费试用到期后没有及时切换付费版，之前的配置数据会丢失吗？
A：不会，我们会为你保留所有配置数据15天，15天内切换付费版即可直接恢复使用，超过15天未开通付费，数据会被自动清理。

Q2：我可以先切换按量付费，后续再改成包年包月套餐吗？
A：可以，两种计费模式支持随时切换，切换后新的计费规则次日0点生效，之前产生的费用按照原有模式结算。

Q3：什么情况下不建议直接切换付费版？
A：如果你的业务后续不会正式上线，或者单月调用量低于100次，不建议开通HiAgent付费版，选择轻量智能体服务成本更低。

Q4：切换付费版后，原来的智能体对外调用地址会变吗？
A：不会，原来的调用地址、AgentId都保持不变，你的业务侧无需修改任何配置即可正常使用。

Q5：付费版的SLA保障是多少？
A：标准付费版的服务可用性SLA为99.9%，企业版可达到99.95%，如果不满足可用性承诺可以申请对应比例的费用赔付。

Q6：可以开发票吗？
A：可以，支付完成后可在「计费管理」-「发票管理」页面申请开具增值税专用发票或普通发票，发票会在3个工作日内寄出。

[7] 相关阅读 #

1. 《HiAgent计费模式详细说明》，[/docs/hiagent/12345]，了解按量付费和包年包月套餐的具体差异和定价明细
2. 《HiAgent API调用最佳实践》，[/docs/hiagent/67890]，优化API调用逻辑，降低付费使用成本
3. 《HiAgent多渠道接入配置教程》，[/docs/hiagent/13579]，开通付费版后快速接入微信、抖音等多个渠道
4. 《HiAgent权限管理配置指南》，[/docs/hiagent/24680]，学习如何给子账号分配计费、开发等不同权限

[8] 参考资料 #

[1] 火山引擎HiAgent免费试用规则说明，https://www.byteoc.com/docs/hiagent/30001，2026年8月20日
[2] 火山引擎HiAgent定价页，https://www.byteoc.com/pricing/hiagent，2026年8月15日
[3] HiAgent智能体平台使用手册，https://nic.cdu.edu.cn/info/1035/2344.htm，2026年7月10日
本文基于HiAgent平台v2.4版本编写。

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

2026-08-24