简介
本文档提供关于语音合成模板接口的 API 概览和 SDK 示例代码。
注意
创建语音合成模板
功能说明
创建语音合成模板。
方法原型
public Guzzle\\Service\\Resource\\Model createVoiceTtsTemplate(array $args = array());
请求示例
<?phprequire dirname(__FILE__, 2) . '/vendor/autoload.php';$secretId = "SECRETID"; //替换为用户的 secretId，请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi$secretKey = "SECRETKEY"; //替换为用户的 secretKey，请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi$region = "ap-beijing"; //替换为用户的 region，已创建桶归属的 region 可以在控制台查看，https://console.cloud.tencent.com/cos5/bucket$cosClient = new Qcloud\\Cos\\Client(array('region' => $region,'schema' => 'https', //协议头部，默认为http'credentials'=> array('secretId' => $secretId ,'secretKey' => $secretKey)));try {// 创建语音合成模板 https://cloud.tencent.com/document/product/460/84499$result = $cosClient->createVoiceTtsTemplate(array('Bucket' => 'examplebucket-125000000', //存储桶名称，由BucketName-Appid 组成，可以在COS控制台查看 https://console.cloud.tencent.com/cos5/bucket'Tag' => 'Tts','Name' => 'TemplateName','Mode' => 'Sync','Codec' => 'pcm','VoiceType' => 'aixiaoxing','Volume' => '2','Speed' => '200','Emotion' => 'arousal',));// 请求成功print_r($result);} catch (\\Exception $e) {// 请求失败echo($e);}
参数说明
Request 中的具体数据描述如下：
节点名称（关键字） | 父节点 | 描述 | 类型 | 是否必选 | 限制 |
Tag | Request | 模板类型：Tts | String | 是 | Tts |
Name | Request | 模板名称，仅支持中文、英文、数字、_、-和* | String | 是 | 无 |
Mode | Request | 处理模式，默认值 Asyc | String | 否 | Asyc（异步合成）、Sync（同步合成） |
Codec | Request | 音频格式，默认值 wav（同步）/pcm（异步） | String | 否 | wav、mp3、pcm |
VoiceType | Request | 音色，默认值 ruxue | String | 否 | 详见下表 |
Volume | Request | 音量，默认值0 | String | 否 | [-10,10] |
Speed | Request | 语速，默认值100 | String | 否 | [50,200] |
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(广播) |
返回结果示例
GuzzleHttp\\Command\\Result Object([RequestId] => NjRjNzjZfYNjRjMjIxODBfMzUxNGSIOJOIDAJOIDg=[ContentType] => application/xml[ContentLength] => 642[Template] => Array([State] => Normal[TemplateId] => t156d57c7a00f19asf798sd7f89s7f2e646[Name] => TemplateName[BucketId] => examplebucket-1250000000[Category] => Custom[Tag] => Tts[UpdateTime] => 2023-07-31T16:01:42+0800[CreateTime] => 2023-07-31T16:01:42+0800[TtsTpl] => Array([Mode] => Sync[Codec] => pcm[VoiceType] => aixiaoxing[Volume] => 2[Speed] => 200[Emotion] => arousal))[Bucket] => examplebucket-1250000000[Location] => examplebucket-1250000000.ci.ap-guangzhou.myqcloud.com/template)
更新语音合成模板
功能说明
更新语音合成模板。
方法原型
public Guzzle\\Service\\Resource\\Model updateVoiceTtsTemplate(array $args = array());
请求示例
<?phprequire dirname(__FILE__, 2) . '/vendor/autoload.php';$secretId = "SECRETID"; //替换为用户的 secretId，请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi$secretKey = "SECRETKEY"; //替换为用户的 secretKey，请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi$region = "ap-beijing"; //替换为用户的 region，已创建桶归属的 region 可以在控制台查看，https://console.cloud.tencent.com/cos5/bucket$cosClient = new Qcloud\\Cos\\Client(array('region' => $region,'schema' => 'https', //协议头部，默认为http'credentials'=> array('secretId' => $secretId ,'secretKey' => $secretKey)));try {// 更新语音合成模板 https://cloud.tencent.com/document/product/460/84758$result = $cosClient->updateVoiceTtsTemplate(array('Bucket' => 'examplebucket-125000000', //存储桶名称，由BucketName-Appid 组成，可以在COS控制台查看 https://console.cloud.tencent.com/cos5/bucket'Key' => '', // TemplateId'Tag' => 'Tts','Name' => 'TemplateName','Mode' => 'Sync','Codec' => 'pcm','VoiceType' => 'aixiaoxing','Volume' => '2','Speed' => '200','Emotion' => 'arousal',));// 请求成功print_r($result);} catch (\\Exception $e) {// 请求失败echo($e);}
参数说明
Request 中的具体数据描述如下：
节点名称（关键字） | 父节点 | 描述 | 类型 | 是否必选 |
Request | 无 | Container | 是 |
返回结果示例
GuzzleHttp\\Command\\Result Object([RequestId] => NjRjNzNjRjMjIxODBfMzUxNGSIOJOIDAJOIDg=[ContentType] => application/xml[ContentLength] => 639[Template] => Array([State] => Normal[TemplateId] => t156d5pc7a00f19asf798sd7f89s7f2e646[Name] => TemplateName[BucketId] => examplebucket-1250000000[Category] => Custom[Tag] => Tts[UpdateTime] => 2023-07-31T16:05:06+0800[CreateTime] => 2023-07-31T16:01:42+0800[TtsTpl] => Array([Mode] => Sync[Codec] => pcm[VoiceType] => aixiaoxing[Volume] => 2[Speed] => 200[Emotion] => arousal))[Key] => t156d5pc7a00f19asf798sd7f89s7f2e646[Bucket] => examplebucket-1250000000[Location] => examplebucket-1250000000.ci.ap-guangzhou.myqcloud.com/template/t156d5pc7a00f19asf798sd7f89s7f2e646)
