{ "name": "tts", "display_name": "语音合成", "description": "介绍如何使用语音合成API合成音频", "domain": "ai", "api_version": "2019-08-23", "endpoint": "tts.tencentcloudapi.com", "actions": [ { "name": "CreateTtsTask", "description": "本接口服务对10万字符以内的文本进行语音合成，异步返回音频结果。满足一次性合成较长文本的客户需求，如阅读播报、新闻媒体等场景。 支持音频格式：mp3,wav,pcm 支持音频采样率：16000 Hz, 8000 Hz 支持中文普通话、英文、中英文混读、粤语合成 支持语速、音量设置 支持回调或轮询的方式获取结果，结果获取请参考 长文本语音合成结果查询。 提交长文本语音合成请求后，合\ufffd...", "status": "online", "parameters": [ { "name": "Text", "type": "string", "required": true, "description": "合成语音的源文本，按UTF-8编码统一计算，最多支持10万字符", "example": "你好" }, { "name": "Volume", "type": "float", "required": false, "description": "音量大小，范围[-10，10]，对应音量大小。默认为0，代表正常音量，值越大音量越高。", "example": "1.0" }, { "name": "Speed", "type": "float", "required": false, "description": "语速，范围：[-2，6]，分别对应不同语速：-2代表0.6倍-1代表0.8倍0代表1.0倍（默认）1代表1.2倍2代表1.5倍6代表2.5倍如果需要更细化的语速，可以保留小数点后 2 位，例如0.5/1.25/2.81等。参数值与实际语速转换，可参考代码示例", "example": "1.0" }, { "name": "ProjectId", "type": "integer", "required": false, "description": "项目id，用户自定义，默认为0。", "example": "0" }, { "name": "ModelType", "type": "integer", "required": false, "description": "模型类型，1-默认模型。", "example": "1" }, { "name": "VoiceType", "type": "integer", "required": false, "description": "音色 ID，价格请参见购买指南。完整的音色 ID 列表请参见音色列表。", "example": "101008" }, { "name": "PrimaryLanguage", "type": "integer", "required": false, "description": "主语言类型：1-中文（默认）2-英文", "example": "1" }, { "name": "SampleRate", "type": "integer", "required": false, "description": "音频采样率：16000：16k（默认）8000：8k", "example": "16000" }, { "name": "Codec", "type": "string", "required": false, "description": "返回音频格式，可取值：mp3（默认），wav，pcm", "example": "wav" }, { "name": "CallbackUrl", "type": "string", "required": false, "description": "回调 URL，用户自行搭建的用于接收识别结果的服务URL。如果用户使用轮询方式获取识别结果，则无需提交该参数。回调说明", "example": "http://www.callback.com/tts_call" }, { "name": "EnableSubtitle", "type": "boolean", "required": false, "description": "是否开启时间戳功能，默认为false。", "example": "true" }, { "name": "VoiceoverDialogueSplit", "type": "boolean", "required": false, "description": "旁白与对白文本解析，分别合成相应风格（仅适用于旁对白音色10510000、100510000），默认 false", "example": "false" }, { "name": "EmotionCategory", "type": "string", "required": false, "description": "控制合成音频的情感，仅支持多情感音色使用。取值: neutral(中性)、sad(悲伤)、happy(高兴)、angry(生气)、fear(恐惧)、news(新闻)、story(故事)、radio(广播)、poetry(诗歌)、call(客服)、sajiao(撒娇)、disgusted(厌恶)、amaze(震惊)、peaceful(平静)、exciting(兴奋)、aojiao(傲娇)、jieshuo(解说)", "example": "neutral" }, { "name": "EmotionIntensity", "type": "integer", "required": false, "description": "控制合成音频情感程度，取值范围为[50,200],默认为100；只有EmotionCategory不为空时生效。", "example": "100" } ], "required": [ "Text" ] }, { "name": "DescribeTtsTaskStatus", "description": "在调用长文本语音合成请求接口后，有回调和轮询两种方式获取识别结果。 当采用回调方式时，合成完毕后会将结果通过 POST 请求的形式通知到用户在请求时填写的回调 URL，具体请参见 长文本语音合成结果查询 。 当采用轮询方式时，需要主动提交任务ID来轮询识别结果，共有任务成功、等待、执行中和失败四种结果，具体信息请参见下文说明。", "status": "online", "parameters": [ { "name": "TaskId", "type": "string", "required": true, "description": "任务id", "example": "ed461a019355c5cd1ce31ab4dfb8cb12" } ], "required": [ "TaskId" ] }, { "name": "TextToVoice", "description": "腾讯云语音合成技术（TTS）可以将任意文本转化为语音，实现让机器和应用张口说话。 腾讯TTS技术可以应用到很多场景，比如，移动APP语音播报新闻；智能设备语音提醒；依靠网上现有节目或少量录音，快速合成明星语音，降低邀约成本；支持车载导航语音合成的个性化语音播报。 基础合成支持 SSML，语法详见 [SSML 标记语言](https://cloud.tencent.com/document/product/1073/49575)。 默认接...", "status": "online", "parameters": [ { "name": "Text", "type": "string", "required": true, "description": "合成语音的源文本，按UTF-8编码统一计算。 中文最大支持150个汉字（全角标点符号算一个汉字）；英文最大支持500个字母（半角标点符号算一个字母）。", "example": "你好" }, { "name": "SessionId", "type": "string", "required": true, "description": "一次请求对应一个SessionId，会原样返回，建议传入类似于uuid的字符串防止重复。", "example": "session-1234" }, { "name": "Volume", "type": "float", "required": false, "description": "音量大小，范围[-10，10]，对应音量大小。默认为0，代表正常音量，值越大音量越高。", "example": "1.0" }, { "name": "Speed", "type": "float", "required": false, "description": "语速，范围：[-2，6]，分别对应不同语速：-2代表0.6倍-1代表0.8倍0代表1.0倍（默认）1代表1.2倍2代表1.5倍6代表2.5倍如果需要更细化的语速，可以保留小数点后 2 位，例如0.5/1.25/2.81等。参数值与实际语速转换，可参考[代码示例](https://sdk-1300466766.cos.ap-shanghai.myqcloud.com/sample/speed_sample.tar.gz)", "example": "1.0" }, { "name": "ProjectId", "type": "integer", "required": false, "description": "项目id，用户自定义，默认为0。", "example": "0" }, { "name": "ModelType", "type": "integer", "required": false, "description": "模型类型，1-默认模型。", "example": "1" }, { "name": "VoiceType", "type": "integer", "required": false, "description": "音色 ID，包括精品音色、大模型音色与基础版复刻音色。不同音色价格有差异，详情请参见[购买指南](https://cloud.tencent.com/document/product/1073/34112)。完整的音色 ID 列表请参见[音色列表](https://cloud.tencent.com/document/product/1073/92668)。若使用一句话版声音复刻，请填入固定值“200000000”。", "example": "0" }, { "name": "FastVoiceType", "type": "string", "required": false, "description": "一句话版声音复刻音色ID，使用一句话版声音复刻音色时需填写。", "example": "WCHN-766926cXXXXXXXX5e76537fc" }, { "name": "PrimaryLanguage", "type": "integer", "required": false, "description": "主语言类型：1-中文（默认）2-英文", "example": "1" }, { "name": "SampleRate", "type": "integer", "required": false, "description": "音频采样率： 24000：24k（部分音色支持，请参见[音色列表](https://cloud.tencent.com/document/product/1073/92668)） 16000：16k（默认） 8000：8k", "example": "16000" }, { "name": "Codec", "type": "string", "required": false, "description": "返回音频格式，可取值：wav（默认），mp3，pcm", "example": "wav" }, { "name": "EnableSubtitle", "type": "boolean", "required": false, "description": "是否开启时间戳功能，默认为false。", "example": "true" }, { "name": "SegmentRate", "type": "integer", "required": false, "description": "断句敏感阈值，默认值为：0，取值范围：[0,1,2]。该值越大越不容易断句，模型会更倾向于仅按照标点符号断句。此参数建议不要随意调整，可能会影响合成效果。", "example": "0" }, { "name": "EmotionCategory", "type": "string", "required": false, "description": "控制合成音频的情感，仅支持多情感音色使用。取值: neutral(中性)、sad(悲伤)、happy(高兴)、angry(生气)、fear(恐惧)、news(新闻)、story(故事)、radio(广播)、poetry(诗歌)、call(客服)、sajiao(撒娇)、disgusted(厌恶)、amaze(震惊)、peaceful(平静)、exciting(兴奋)、aojiao(傲娇)、jieshuo(解说) 示例值：neutral", "example": "neutral" }, { "name": "EmotionIntensity", "type": "integer", "required": false, "description": "控制合成音频情感程度，取值范围为[50,200],默认为100；只有EmotionCategory不为空时生效；", "example": "100" } ], "required": [ "Text", "SessionId" ] } ] }