为什么要用模板变量 如果每次发送语音通知都把完整文本写死，批量场景下会非常笨重，也不利于合规审核。互亿无线语音通知支持 TTS 文本转语音与模板变量机制：先在控制台报备一个带占位符的模板，调用接口时再传入具体变量值，平台自动替换后合成语音播…
为什么要用模板变量
如果每次发送语音通知都把完整文本写死，批量场景下会非常笨重，也不利于合规审核。互亿无线语音通知支持 TTS 文本转语音与模板变量机制：先在控制台报备一个带占位符的模板，调用接口时再传入具体变量值，平台自动替换后合成语音播报，从而实现千人千面的个性化通知，例如播报用户姓名、订单号、金额等。
使用流程
模板变量的使用分为报备与调用两步，整体流程清晰。
- 报备模板：在控制台新建语音模板，用占位符标识可变部分，例如"尊敬的 ${name}，您的订单 ${order_no} 已发货"。模板报备约 2 小时审核通过，免报备签名、仅需报备模板。
- 调用接口传变量：发送请求时，在 account、password、mobile 基础上，把 content 填为已审核通过的模板内容，并按约定格式传入变量值。
- 平台合成播报：TTS 引擎将替换后的文本合成为语音，支持多音色、无需自行录音，单条模板支持 1 到 500 字。
调用示例
POST https://api.ihuyi.com/voice/vm
account=ID&password=KEY&mobile=13800138000&content=尊敬的${name}，您的订单${order_no}已发货提交成功返回 {"code":2,"msg":"提交成功"}，表示任务已受理，实际播报文本由平台根据变量值替换后生成。
最佳实践
- 变量内容务必来自可信数据源，避免把用户未授权的隐私信息带入播报。
- 单个变量长度不宜过长，整条播报建议控制在约 70 字，对应约 20 秒通话，避免超长计费与收听疲劳。
- 批量发送时配合自定义变量，可在一次任务中让每个用户听到自己的专属内容。
模板报备与变量格式详情见 https://www.ihuyi.com/doc/voice/vm/api ，各语言调用代码示例见 https://www.ihuyi.com/doc/voice/vm/demo 。