tencentcloud-sdk-nodejs 3.0.269 → 3.0.270

package/tencentcloud/tts/v20190823/models.js

@@ -59,25 +59,210 @@ class TextToVoiceResponse extends  AbstractModel {
 }
 
 /**
- * TextToVoice请求参数结构体
+ * CreateTtsTask返回参数结构体
  * @class
  */
-class TextToVoiceRequest extends  AbstractModel {
+class CreateTtsTaskResponse extends  AbstractModel {
     constructor(){
         super();
 
         /**
-         * 合成语音的源文本，按UTF-8编码统一计算。
-中文最大支持110个汉字（全角标点符号算一个汉字）；英文最大支持350个字母（半角标点符号算一个字母）。
+         * 任务 id
+         * @type {CreateTtsTaskRespData || null}
+         */
+        this.Data = null;
+
+        /**
+         * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
          * @type {string || null}
          */
-        this.Text = null;
+        this.RequestId = null;
+
+    }
+
+    /**
+     * @private
+     */
+    deserialize(params) {
+        if (!params) {
+            return;
+        }
+
+        if (params.Data) {
+            let obj = new CreateTtsTaskRespData();
+            obj.deserialize(params.Data)
+            this.Data = obj;
+        }
+        this.RequestId = 'RequestId' in params ? params.RequestId : null;
+
+    }
+}
+
+/**
+ * DescribeTtsTaskStatus返回参数结构体
+ * @class
+ */
+class DescribeTtsTaskStatusResponse extends  AbstractModel {
+    constructor(){
+        super();
 
         /**
-         * 一次请求对应一个SessionId，会原样返回，建议传入类似于uuid的字符串防止重复。
+         * 任务状态返回
+         * @type {DescribeTtsTaskStatusRespData || null}
+         */
+        this.Data = null;
+
+        /**
+         * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
          * @type {string || null}
          */
-        this.SessionId = null;
+        this.RequestId = null;
+
+    }
+
+    /**
+     * @private
+     */
+    deserialize(params) {
+        if (!params) {
+            return;
+        }
+
+        if (params.Data) {
+            let obj = new DescribeTtsTaskStatusRespData();
+            obj.deserialize(params.Data)
+            this.Data = obj;
+        }
+        this.RequestId = 'RequestId' in params ? params.RequestId : null;
+
+    }
+}
+
+/**
+ * 异步合成请求的返回数据
+ * @class
+ */
+class CreateTtsTaskRespData extends  AbstractModel {
+    constructor(){
+        super();
+
+        /**
+         * 任务ID，可通过此ID在轮询接口获取合成状态与结果。注意：TaskId数据类型为string
+         * @type {string || null}
+         */
+        this.TaskId = null;
+
+    }
+
+    /**
+     * @private
+     */
+    deserialize(params) {
+        if (!params) {
+            return;
+        }
+        this.TaskId = 'TaskId' in params ? params.TaskId : null;
+
+    }
+}
+
+/**
+ * 获取异步合成结果的返回参数
+ * @class
+ */
+class DescribeTtsTaskStatusRespData extends  AbstractModel {
+    constructor(){
+        super();
+
+        /**
+         * 任务标识。
+         * @type {string || null}
+         */
+        this.TaskId = null;
+
+        /**
+         * 任务状态码，0：任务等待，1：任务执行中，2：任务成功，3：任务失败。
+         * @type {number || null}
+         */
+        this.Status = null;
+
+        /**
+         * 任务状态，waiting：任务等待，doing：任务执行中，success：任务成功，failed：任务失败。
+         * @type {string || null}
+         */
+        this.StatusStr = null;
+
+        /**
+         * 合成音频COS地址（链接有效期1天）。
+         * @type {string || null}
+         */
+        this.ResultUrl = null;
+
+        /**
+         * 失败原因说明。
+         * @type {string || null}
+         */
+        this.ErrorMsg = null;
+
+    }
+
+    /**
+     * @private
+     */
+    deserialize(params) {
+        if (!params) {
+            return;
+        }
+        this.TaskId = 'TaskId' in params ? params.TaskId : null;
+        this.Status = 'Status' in params ? params.Status : null;
+        this.StatusStr = 'StatusStr' in params ? params.StatusStr : null;
+        this.ResultUrl = 'ResultUrl' in params ? params.ResultUrl : null;
+        this.ErrorMsg = 'ErrorMsg' in params ? params.ErrorMsg : null;
+
+    }
+}
+
+/**
+ * DescribeTtsTaskStatus请求参数结构体
+ * @class
+ */
+class DescribeTtsTaskStatusRequest extends  AbstractModel {
+    constructor(){
+        super();
+
+        /**
+         * 任务id
+         * @type {string || null}
+         */
+        this.TaskId = null;
+
+    }
+
+    /**
+     * @private
+     */
+    deserialize(params) {
+        if (!params) {
+            return;
+        }
+        this.TaskId = 'TaskId' in params ? params.TaskId : null;
+
+    }
+}
+
+/**
+ * CreateTtsTask请求参数结构体
+ * @class
+ */
+class CreateTtsTaskRequest extends  AbstractModel {
+    constructor(){
+        super();
+
+        /**
+         * 合成语音的源文本，按UTF-8编码统一计算，最多支持10万字符
+         * @type {string || null}
+         */
+        this.Text = null;
 
         /**
          * 模型类型，1-默认模型。
@@ -87,7 +272,6 @@ class TextToVoiceRequest extends  AbstractModel {
 
         /**
          * 音量大小，范围：[0，10]，分别对应11个等级的音量，默认为0，代表正常音量。没有静音选项。
-输入除以上整数之外的其他参数不生效，按默认值处理。
          * @type {number || null}
          */
         this.Volume = null;
@@ -105,7 +289,112 @@ class TextToVoiceRequest extends  AbstractModel {
         this.ProjectId = null;
 
         /**
-         * 普通音色<li>0-云小宁，亲和女声(默认)</li><li>1-云小奇，亲和男声</li><li>2-云小晚，成熟男声</li><li>4-云小叶，温暖女声</li><li>5-云小欣，情感女声</li><li>6-云小龙，情感男声</li><li>7-云小曼，客服女声</li><li>1001-智瑜，情感女声</li><li>1002-智聆，通用女声</li><li>1003-智美，客服女声</li><li>1050-WeJack，英文男声</li><li>1051-WeRose，英文女声</li>精品音色<br>精品音色拟真度更高，价格不同于普通音色，查看[购买指南](https://cloud.tencent.com/product/tts/pricing)<br><li>101001-智瑜，情感女声（精品）</li><li>101002-智聆，通用女声（精品）</li><li>101003-智美，客服女声（精品）</li><li>101004-智云，通用男声</li><li>101005-智莉，通用女声</li><li>101006-智言，助手女声</li><li>101007-智娜，客服女声</li><li>101008-智琪，客服女声</li><li>101009-智芸，知性女声</li><li>101010-智华，通用男声</li><li>101011-智燕，新闻女声</li><li>101012-智丹，新闻女声</li><li>101013-智辉，新闻男声</li><li>101014-智宁，新闻男声</li><li>101015-智萌，男童声</li><li>101016-智甜，女童声</li><li>101017-智蓉，情感女声</li><li>101018-智靖，情感男声</li><li>101019-智彤，粤语女声</li><li>101050-WeJack，英文男声（精品）</li><li>101051-WeRose，英文女声（精品）</li><li>102000-贝蕾，客服女声</li><li>102001-贝果，客服女声</li><li>102002-贝紫，粤语女声</li><li>102003-贝雪，新闻女声</li>
+         * 标准音色<li>10510000-智逍遥，旁对白阅读风格男声</li><li>1001-智瑜，情感女声</li><li>1002-智聆，通用女声</li><li>1003-智美，客服女声</li><li>1004-智云，通用男声</li><li>1005-智莉，通用女声</li><li>1007-智娜，客服女声</li><li>1008-智琪，客服女声</li><li>1009-智芸，知性女声</li><li>1010-智华，通用男声</li><li>1017-智蓉，情感女声</li><li>1018-智靖，情感男声</li><li>1050-WeJack，英文男声</li><li>1051-WeRose，英文女声</li>精品音色<br>精品音色拟真度更高，价格不同于标准音色，查看[购买指南](https://cloud.tencent.com/product/tts/pricing)<br><li>100510000-智逍遥，旁对白阅读风格男声（精品）</li><li>101001-智瑜，情感女声（精品）</li><li>101002-智聆，通用女声（精品）</li><li>101003-智美，客服女声（精品）</li><li>101004-智云，通用男声（精品）</li><li>101005-智莉，通用女声（精品）</li><li>101006-智言，助手女声</li><li>101007-智娜，客服女声（精品）</li><li>101008-智琪，客服女声（精品）</li><li>101009-智芸，知性女声（精品）</li><li>101010-智华，通用男声（精品）</li><li>101011-智燕，新闻女声</li><li>101012-智丹，新闻女声</li><li>101013-智辉，新闻男声</li><li>101014-智宁，新闻男声</li><li>101015-智萌，男童声</li><li>101016-智甜，女童声</li><li>101017-智蓉，情感女声（精品）</li><li>101018-智靖，情感男声（精品）</li><li>101019-智彤，粤语女声</li><li>101050-WeJack，英文男声（精品）</li><li>101051-WeRose，英文女声（精品）</li>
+         * @type {number || null}
+         */
+        this.VoiceType = null;
+
+        /**
+         * 主语言类型：<li>1-中文（默认）</li><li>2-英文</li>
+         * @type {number || null}
+         */
+        this.PrimaryLanguage = null;
+
+        /**
+         * 音频采样率：<li>16000：16k（默认）</li><li>8000：8k</li>
+         * @type {number || null}
+         */
+        this.SampleRate = null;
+
+        /**
+         * 返回音频格式，可取值：mp3（默认），wav，pcm
+         * @type {string || null}
+         */
+        this.Codec = null;
+
+        /**
+         * 回调 URL，用户自行搭建的用于接收识别结果的服务URL。如果用户使用轮询方式获取识别结果，则无需提交该参数。[回调说明](https://cloud.tencent.com/document/product/1073/55746)
+         * @type {string || null}
+         */
+        this.CallbackUrl = null;
+
+        /**
+         * 旁白与对白文本解析，分别合成相应风格（仅适用于旁对白音色），默认 false
+         * @type {boolean || null}
+         */
+        this.VoiceoverDialogueSplit = null;
+
+    }
+
+    /**
+     * @private
+     */
+    deserialize(params) {
+        if (!params) {
+            return;
+        }
+        this.Text = 'Text' in params ? params.Text : null;
+        this.ModelType = 'ModelType' in params ? params.ModelType : null;
+        this.Volume = 'Volume' in params ? params.Volume : null;
+        this.Speed = 'Speed' in params ? params.Speed : null;
+        this.ProjectId = 'ProjectId' in params ? params.ProjectId : null;
+        this.VoiceType = 'VoiceType' in params ? params.VoiceType : null;
+        this.PrimaryLanguage = 'PrimaryLanguage' in params ? params.PrimaryLanguage : null;
+        this.SampleRate = 'SampleRate' in params ? params.SampleRate : null;
+        this.Codec = 'Codec' in params ? params.Codec : null;
+        this.CallbackUrl = 'CallbackUrl' in params ? params.CallbackUrl : null;
+        this.VoiceoverDialogueSplit = 'VoiceoverDialogueSplit' in params ? params.VoiceoverDialogueSplit : null;
+
+    }
+}
+
+/**
+ * TextToVoice请求参数结构体
+ * @class
+ */
+class TextToVoiceRequest extends  AbstractModel {
+    constructor(){
+        super();
+
+        /**
+         * 合成语音的源文本，按UTF-8编码统一计算。
+中文最大支持150个汉字（全角标点符号算一个汉字）；英文最大支持500个字母（半角标点符号算一个字母）。
+         * @type {string || null}
+         */
+        this.Text = null;
+
+        /**
+         * 一次请求对应一个SessionId，会原样返回，建议传入类似于uuid的字符串防止重复。
+         * @type {string || null}
+         */
+        this.SessionId = null;
+
+        /**
+         * 音量大小，范围：[0，10]，分别对应11个等级的音量，默认为0，代表正常音量。没有静音选项。
+         * @type {number || null}
+         */
+        this.Volume = null;
+
+        /**
+         * 语速，范围：[-2，2]，分别对应不同语速：<li>-2代表0.6倍</li><li>-1代表0.8倍</li><li>0代表1.0倍（默认）</li><li>1代表1.2倍</li><li>2代表1.5倍</li>如果需要更细化的语速，可以保留小数点后一位，例如0.5 1.1 1.8等。<br>
+         * @type {number || null}
+         */
+        this.Speed = null;
+
+        /**
+         * 项目id，用户自定义，默认为0。
+         * @type {number || null}
+         */
+        this.ProjectId = null;
+
+        /**
+         * 模型类型，1-默认模型。
+         * @type {number || null}
+         */
+        this.ModelType = null;
+
+        /**
+         * 标准音色<li>10510000-智逍遥，阅读男声</li><li>1001-智瑜，情感女声</li><li>1002-智聆，通用女声</li><li>1003-智美，客服女声</li><li>1004-智云，通用男声</li><li>1005-智莉，通用女声</li><li>1007-智娜，客服女声</li><li>1008-智琪，客服女声</li><li>1009-智芸，知性女声</li><li>1010-智华，通用男声</li><li>1017-智蓉，情感女声</li><li>1018-智靖，情感男声</li><li>1050-WeJack，英文男声</li><li>1051-WeRose，英文女声</li>精品音色<br>精品音色拟真度更高，价格不同于标准音色，查看[购买指南](https://cloud.tencent.com/product/tts/pricing)<br><li>100510000-智逍遥，阅读男声</li><li>101001-智瑜，情感女声</li><li>101002-智聆，通用女声</li><li>101003-智美，客服女声</li><li>101004-智云，通用男声</li><li>101005-智莉，通用女声</li><li>101006-智言，助手女声</li><li>101007-智娜，客服女声</li><li>101008-智琪，客服女声</li><li>101009-智芸，知性女声</li><li>101010-智华，通用男声</li><li>101011-智燕，新闻女声</li><li>101012-智丹，新闻女声</li><li>101013-智辉，新闻男声</li><li>101014-智宁，新闻男声</li><li>101015-智萌，男童声</li><li>101016-智甜，女童声</li><li>101017-智蓉，情感女声</li><li>101018-智靖，情感男声</li><li>101019-智彤，粤语女声</li><li>101020-智刚，新闻男声</li><li>101021-智瑞，新闻男声</li><li>101022-智虹，新闻女声</li><li>101023-智萱，聊天女声</li><li>101024-智皓，聊天男声</li><li>101025-智薇，聊天女声</li><li>101026-智希，通用女声</li><li>101027-智梅，通用女声</li><li>101028-智洁，通用女声</li><li>101029-智凯，通用男声</li><li>101030-智柯，通用男声</li><li>101031-智奎，通用男声</li><li>101032-智芳，通用女声</li><li>101033-智蓓，客服女声</li><li>101034-智莲，通用女声</li><li>101035-智依，通用女声</li><li>101040-智川，四川女声</li><li>101050-WeJack，英文男声</li><li>101051-WeRose，英文女声</li>
          * @type {number || null}
          */
         this.VoiceType = null;
@@ -139,10 +428,10 @@ class TextToVoiceRequest extends  AbstractModel {
         }
         this.Text = 'Text' in params ? params.Text : null;
         this.SessionId = 'SessionId' in params ? params.SessionId : null;
-        this.ModelType = 'ModelType' in params ? params.ModelType : null;
         this.Volume = 'Volume' in params ? params.Volume : null;
         this.Speed = 'Speed' in params ? params.Speed : null;
         this.ProjectId = 'ProjectId' in params ? params.ProjectId : null;
+        this.ModelType = 'ModelType' in params ? params.ModelType : null;
         this.VoiceType = 'VoiceType' in params ? params.VoiceType : null;
         this.PrimaryLanguage = 'PrimaryLanguage' in params ? params.PrimaryLanguage : null;
         this.SampleRate = 'SampleRate' in params ? params.SampleRate : null;
@@ -153,6 +442,12 @@ class TextToVoiceRequest extends  AbstractModel {
 
 module.exports = {
     TextToVoiceResponse: TextToVoiceResponse,
+    CreateTtsTaskResponse: CreateTtsTaskResponse,
+    DescribeTtsTaskStatusResponse: DescribeTtsTaskStatusResponse,
+    CreateTtsTaskRespData: CreateTtsTaskRespData,
+    DescribeTtsTaskStatusRespData: DescribeTtsTaskStatusRespData,
+    DescribeTtsTaskStatusRequest: DescribeTtsTaskStatusRequest,
+    CreateTtsTaskRequest: CreateTtsTaskRequest,
     TextToVoiceRequest: TextToVoiceRequest,
 
 }

package/tencentcloud/tts/v20190823/tts_client.js

@@ -17,6 +17,12 @@
 const models = require("./models");
 const AbstractClient = require('../../common/abstract_client')
 const TextToVoiceResponse = models.TextToVoiceResponse;
+const CreateTtsTaskResponse = models.CreateTtsTaskResponse;
+const DescribeTtsTaskStatusResponse = models.DescribeTtsTaskStatusResponse;
+const CreateTtsTaskRespData = models.CreateTtsTaskRespData;
+const DescribeTtsTaskStatusRespData = models.DescribeTtsTaskStatusRespData;
+const DescribeTtsTaskStatusRequest = models.DescribeTtsTaskStatusRequest;
+const CreateTtsTaskRequest = models.CreateTtsTaskRequest;
 const TextToVoiceRequest = models.TextToVoiceRequest;
 
 
@@ -30,6 +36,38 @@ class TtsClient extends AbstractClient {
         super("tts.tencentcloudapi.com", "2019-08-23", credential, region, profile);
     }
     
+    /**
+     * 本接口服务对10万字符以内的文本进行语音合成，异步返回音频结果。满足一次性合成较长文本的客户需求，如阅读播报、新闻媒体等场景。
+
+<li>支持音频格式：mp3,wav,pcm</li>
+<li>支持音频采样率：16000 Hz, 8000 Hz</li>
+<li>支持中文普通话、英文、中英文混读、粤语合成</li>
+<li>支持语速、音量设置</li>
+<li>支持回调或轮询的方式获取结果，结果获取请参考 长文本语音合成结果查询。</li>
+<li>长文本语音合成任务完成后，合成音频结果在服务端可保存24小时</li>
+     * @param {CreateTtsTaskRequest} req
+     * @param {function(string, CreateTtsTaskResponse):void} cb
+     * @public
+     */
+    CreateTtsTask(req, cb) {
+        let resp = new CreateTtsTaskResponse();
+        this.request("CreateTtsTask", req, resp, cb);
+    }
+
+    /**
+     * 在调用长文本语音合成请求接口后，有回调和轮询两种方式获取识别结果。
+
+<li>当采用回调方式时，合成完毕后会将结果通过 POST 请求的形式通知到用户在请求时填写的回调 URL，具体请参见 长文本语音合成结果查询 。</li>
+<li>当采用轮询方式时，需要主动提交任务ID来轮询识别结果，共有任务成功、等待、执行中和失败四种结果，具体信息请参见下文说明。</li>
+     * @param {DescribeTtsTaskStatusRequest} req
+     * @param {function(string, DescribeTtsTaskStatusResponse):void} cb
+     * @public
+     */
+    DescribeTtsTaskStatus(req, cb) {
+        let resp = new DescribeTtsTaskStatusResponse();
+        this.request("DescribeTtsTaskStatus", req, resp, cb);
+    }
+
     /**
      * 腾讯云语音合成技术（TTS）可以将任意文本转化为语音，实现让机器和应用张口说话。
 腾讯TTS技术可以应用到很多场景，比如，移动APP语音播报新闻；智能设备语音提醒；依靠网上现有节目或少量录音，快速合成明星语音，降低邀约成本；支持车载导航语音合成的个性化语音播报。