功能描述
创建语音合成模板。
授权说明
服务开通
使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶。
使用该功能需提前通过控制台或接口开通智能语音服务 。详情请参见 开通智能语音服务。
使用限制
请求
请求示例
POST /template HTTP/1.1Host: <BucketName-APPID>.ci.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>Content-Length: <length>Content-Type: application/xml<body>
请求头
请求体
该请求操作的实现需要有如下请求体。
<Request><Tag>Tts</Tag><Name>TemplateName</Name><Mode>Sync</Mode><Codec>pcm</Codec><VoiceType>aixiaoxing</VoiceType><Volume>2</Volume><Speed>200</Speed><Emotion>arousal</Emotion></Request>
具体数据描述如下:
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 |
Request | 无 | 保存请求的容器 | Container | 是 |
Container 类型
Request
的具体数据描述如下:节点名称(关键字) | 父节点 | 描述 | 类型 | 默认值 | 是否必选 |
Tag | Request | 模板类型:Tts | String | 无 | 是 |
Name | Request | 模板名称,仅支持中文、英文、数字、_、-和*,长度不超过 64 | String | 无 | 是 |
Mode | Request | 处理模式 Asyc(异步合成) Sync(同步合成) | String | Asyc | 否 |
Codec | Request | 音频格式,支持 wav、mp3、pcm | String | 当 Mode= Sync 时,
默认值为 wav 当 Mode= Asyc 时,默认值为 pcm | 否 |
VoiceType | Request | 音色,取值和限制介绍请见下表 | String | ruxue | 否 |
Volume | Request | 音量,取值范围 [-10,10] | String | 0 | 否 |
Speed | Request | 语速,取值范围 [50,200] | String | 100 | 否 |
Emotion | Request | 情绪,不同音色支持的情绪不同,详见下表 | String | 无 | 否 |
支持的音色
名称 | Voice 参数值 | Sync(同步合成) | Asyc(异步合成) |
茹雪 | ruxue | 支持 | 支持 |
爱小楠 | aixiaonan | 不支持 | 支持 |
爱小星 | aixiaoxing | 支持 | 支持 |
爱小诚 | aixiaocheng | 支持 | 支持 |
爱小雪 | aixiaoxue | 支持 | 支持 |
爱小璐 | aixiaolu | 支持 | 支持 |
爱小栋 | aixiaodong | 支持 | 支持 |
爱小聊 | aixiaoliao | 不支持 | 支持 |
爱小倩 | aixiaoqian | 支持 | 支持 |
爱小阳 | aixiaoyang | 支持 | 支持 |
Alice | alice | 支持 | 支持 |
音色说明
名称 | Voice 参数值 | 类型 | 适用场景 | 支持语言 | 声音品质 |
茹雪 | ruxue | 标准女声 | 通用场景 | 中文及中英文混合 | 标准版 |
爱小楠 | aixiaonan | 甜美女声 | 通用/社交场景 | 中文及中英文混合 | 精品版 |
爱小星 | aixiaoxing | 元气男声 | 通用/解说场景 | 中文及中英文混合 | 精品版 |
爱小诚 | aixiaocheng | 标准男声 | 通用场景 | 中文及中英文混合 | 标准版 |
爱小雪 | aixiaoxue | 标准女声 | 通用/客服场景 | 中文及中英文混合 | 标准版 |
爱小璐 | aixiaolu | 阅读女声 | 通用/有声书场景 | 中文及中英文混合 | 标准版 |
爱小栋 | aixiaodong | 新闻男声 | 通用/新闻播报场景 | 中文及中英文混合 | 标准版 |
爱小聊 | aixiaoliao | 情绪女声 | 通用/社交场景 | 中文及中英文混合 | 精品版 |
爱小倩 | aixiaoqian | 元气女声 | 通用/社交场景 | 中文及中英文混合 | 精品版 |
爱小阳 | aixiaoyang | 广播男声 | 通用/新闻播报场景 | 中文及中英文混合 | 标准版 |
Alice | alice | 英文女声 | 通用场景 | 英文 | 标准版 |
音色支持情绪说明
名称 | Voice 参数值 | 情绪分类 |
爱小星 | aixiaoxing | neutral(中性)、arousal(兴奋) |
爱小诚 | aixiaocheng | neutral(中性)、newscast(广播) |
爱小雪 | aixiaoxue | neutral(中性)、newscast(广播)、customer-service(客服) |
爱小璐 | aixiaolu | neutral(中性)、story(故事)、customer-service(客服) |
爱小栋 | aixiaodong | neutral(中性)、newscast(广播) |
爱小阳 | aixiaoyang | neutral(中性)、newscast(广播) |
响应
响应头
响应体
该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:
<Response><RequestId>NjQ0NGNlNDZfMThhYTk0MGFfY*********</RequestId><Template><Tag>Tts</Tag><TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId><Name>TemplateName</Name><BucketId>test-1234567890</BucketId><Category>Custom</Category><TtsTpl><Mode>Sync</Mode><Codec>pcm</Codec><VoiceType>aixiaoxing</VoiceType><Volume>2</Volume><Speed>200</Speed><Emotion>arousal</Emotion></TtsTpl><CreateTime>2020-08-05T11:35:24+0800</CreateTime><UpdateTime>2020-08-31T16:15:20+0800</UpdateTime></Template></Response>
具体的数据内容如下:
节点名称(关键字) | 父节点 | 描述 | 类型 |
Response | 无 | 保存结果的容器 | Container |
Container 节点
Response
的内容:节点名称(关键字) | 父节点 | 描述 | 类型 |
Template | Response | 保存模板详情的容器 | Container |
RequestId | Response | 请求的唯一 ID | String |
Container 节点
Template
的内容:节点名称(关键字) | 父节点 | 描述 | 类型 |
TemplateId | Response.Template | 模板 ID | String |
Name | Response.Template | 模板名称 | String |
BucketId | Response.Template | 模板所属存储桶 | String |
Category | Response.Template | 模板属性,Custom 或者 Official | String |
Tag | Response.Template | 模板类型,Tts | String |
UpdateTime | Response.Template | 更新时间 | String |
CreateTime | Response.Template | 创建时间 | String |
TtsTpl | Response.Template | 详细的模板参数 | Container |
Container节点 TtsTpl 的内容:
节点名称(关键字) | 父节点 | 描述 |
Mode | Response.Template.TtsTpl | 同请求体中的 Request.Mode |
Codec | Response.Template.TtsTpl | 同请求体中的 Request.Codec |
VoiceType | Response.Template.TtsTpl | 同请求体中的 Request.VoiceType |
Volume | Response.Template.TtsTpl | 同请求体中的 Request.Volume |
Speed | Response.Template.TtsTpl | 同请求体中的 Request.Speed |
Emotion | Response.Template.TtsTpl | 同请求体中的 Request.Emotion |
错误码
实际案例
请求
POST /template HTTP/1.1Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****Host: test-1234567890.ci.ap-beijing.myqcloud.comContent-Length: 1666Content-Type: application/xml<Request><Tag>Tts</Tag><Name>TemplateName</Name><Mode>Sync</Mode><Codec>pcm</Codec><VoiceType>ruxue</VoiceType><Volume>2</Volume><Speed>200</Speed></Request>
响应
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 100Connection: keep-aliveDate: Thu, 14 Jul 2022 12:37:29 GMTServer: tencent-cix-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****<Response><RequestId>NjQ0NGNlNDZfMThhYTk0MGFfY*********</RequestId><Template><Tag>Tts</Tag><TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId><Name>TemplateName</Name><BucketId>test-1234567890</BucketId><Category>Custom</Category><TtsTpl><Mode>Sync</Mode><Codec>pcm</Codec><VoiceType>aixiaoxing</VoiceType><Volume>2</Volume><Speed>200</Speed><Emotion>arousal</Emotion></TtsTpl><CreateTime>2020-08-05T11:35:24+0800</CreateTime><UpdateTime>2020-08-31T16:15:20+0800</UpdateTime></Template></Response>