tencentcloud-sdk-asr 3.0.657 → 3.0.658

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 303a769949f2d3bb0588f8e9c2a42ddf8cc5fa36
-  data.tar.gz: 21407167aaafd229550f6933bc93955cb3fcdf16
+  metadata.gz: f2938aa23f1beb05e22f8c5bd504d2c930bef2da
+  data.tar.gz: 210e69d2d967e92677f3183d27662adcdfd638f3
 SHA512:
-  metadata.gz: 11fe04abeae72f591ce8428ee377af21c60b22cb95245aa17b8a3b701b2c18aab7ca64dd670f26a1433d26cb9f6ddd664a991079505cfcab06eea5b4845b0ca6
-  data.tar.gz: 42704855bf83495e7d30ec187c82927ae1d52bddf37ba473ade43eb76593d191299a7aeb57d9f465ab51dcae1250e28f80bf4dbca9ce5c3468b143e6ff2a36a2
+  metadata.gz: b6580aa7eb2c90ca62684616f328c1452858e7fe791b29e3aeb816220465571a12b4b19b7b7cffc8a05872f82bd8eaa712f050c6fcb13d1f0e9e2a5a97a4c5e8
+  data.tar.gz: 1b74af38efc8b484f411179b129b45ab94eeec2af85d9c884c228ac28d08d23c402f41dd617f96a9fc7e72d262ba48a21d867a43beeb8881a1b4ef2de0bb84b5

data/lib/VERSION

@@ -1 +1 @@
-3.0.657
+3.0.658

data/lib/v20190614/models.rb

@@ -295,7 +295,7 @@ module TencentCloud
         # **注意：电话通讯场景，请务必使用以下8k引擎**
         # • 8k_zh：中文电话通讯；
         # • 8k_en：英文电话通讯；
-        # 如您有电话通讯场景识别需求，但发现需求语种仅支持16k，可将8k音频传入下方16k引擎，亦能获取识别结果。但**16k引擎并非基于电话通讯数据训练，无法承诺此种调用方式的识别效果，需由您自行验证识别结果是否可用**。
+        # 如您有电话通讯场景识别需求，但发现需求语种仅支持16k，可将8k音频传入下方16k引擎，亦能获取识别结果。但**16k引擎并非基于电话通讯数据训练，无法承诺此种调用方式的识别效果，需由您自行验证识别结果是否可用**
 
         # 通用场景引擎：
         # **注意：除电话通讯场景以外的其它识别场景，请务必使用以下16k引擎**
@@ -323,15 +323,17 @@ module TencentCloud
         # 2：双声道（仅支持8k电话音频，且双声道应分别为通话双方）
 
         # 注意：
-        # • 16k音频：仅支持单声道识别，**需设置ChannelNum=1**
+        # • 16k音频：仅支持单声道识别，**需设置ChannelNum=1**；
         # • 8k电话音频：支持单声道、双声道识别，**建议设置ChannelNum=2，即双声道**。双声道能够物理区分说话人、避免说话双方重叠产生的识别错误，能达到最好的说话人分离效果和识别效果。设置双声道后，将自动区分说话人，因此**无需再开启说话人分离功能**，相关参数（**SpeakerDiarization、SpeakerNumber**）使用默认值即可
         # @type ChannelNum: Integer
-        # @param ResTextFormat: 识别结果返回形式
-        # 0： 识别结果文本(含分段时间戳)；
-        # 1：词级别粒度的[详细识别结果](https://cloud.tencent.com/document/api/1093/37824#SentenceDetail)(不含标点，含语速值)；
-        # 2：词级别粒度的详细识别结果（包含标点、语速值）；
-        # 3: 标点符号分段，包含每段时间戳，特别适用于字幕场景（包含词级时间、标点、语速值）
-        # 4：【增值付费功能】对识别结果按照语义分段，并展示词级别粒度的详细识别结果，仅支持8k_zh、16k_zh引擎，需购买对应资源包使用（注意：如果账号后付费功能开启并使用此功能，将[自动计费](https://cloud.tencent.com/document/product/1093/35686)）
+        # @param ResTextFormat: 识别结果返回样式
+        # 0：基础识别结果（仅包含有效人声时间戳，无词粒度的[详细识别结果](https://cloud.tencent.com/document/api/1093/37824#SentenceDetail)）；
+        # 1：基础识别结果之上，增加词粒度的[详细识别结果](https://cloud.tencent.com/document/api/1093/37824#SentenceDetail)（包含词级别时间戳、语速值，**不含标点**）；
+        # 2：基础识别结果之上，增加词粒度的[详细识别结果](https://cloud.tencent.com/document/api/1093/37824#SentenceDetail)（包含词级别时间戳、语速值和标点）；
+        # 3：基础识别结果之上，增加词粒度的[详细识别结果](https://cloud.tencent.com/document/api/1093/37824#SentenceDetail)（包含词级别时间戳、语速值和标点），且识别结果按标点符号分段，**适用字幕场景**；
+        # 4：**【增值付费功能】**基础识别结果之上，增加词粒度的[详细识别结果](https://cloud.tencent.com/document/api/1093/37824#SentenceDetail)（包含词级别时间戳、语速值和标点），且识别结果按nlp语义分段，**适用会议、庭审记录转写等场景**，仅支持8k_zh/16k_zh引擎
+
+        # 注意：如果传入参数值4，需确保账号已购买[语义分段资源包](https://cloud.tencent.com/document/product/1093/35686#97ae4aa0-29a0-4066-9f07-ccaf8856a16b)，或账号开启后付费；**若当前账号已开启后付费功能，并传入参数值4，将[自动计费](https://cloud.tencent.com/document/product/1093/35686#d912167d-ffd5-41a9-8b1c-2e89845a6852)）**
         # @type ResTextFormat: Integer
         # @param SourceType: 语音数据来源
         # 0：语音 URL；
@@ -339,7 +341,7 @@ module TencentCloud
         # @type SourceType: Integer
         # @param SpeakerDiarization: 是否开启说话人分离
         # 0：不开启；
-        # 1：开启（仅支持8k_zh/16k_zh，且ChannelNum=1时可用）；
+        # 1：开启（仅支持以下引擎：8k_zh/16k_zh/16k_ms/16k_en/16k_id，且ChannelNum=1时可用）；
         # 默认值为 0
 
         # 注意：
@@ -350,40 +352,91 @@ module TencentCloud
         # 0：自动分离（最多分离出20个人）；
         # 1-10：指定人数分离；
         # 默认值为 0
-
-        # 注意：此功能结果仅供参考
         # @type SpeakerNumber: Integer
-        # @param CallbackUrl: 回调 URL：用户自行搭建的用于接收识别结果的服务URL。回调格式和内容详见：[录音识别回调说明](https://cloud.tencent.com/document/product/1093/52632)
-        # 如果用户使用轮询方式获取识别结果，则无需提交该参数。
+        # @param CallbackUrl: 回调 URL
+        # 用户自行搭建的用于接收识别结果的服务URL
+        # 回调格式和内容详见：[录音识别回调说明](https://cloud.tencent.com/document/product/1093/52632)
+
+        # 注意：
+        # 如果用户使用轮询方式获取识别结果，则无需提交该参数
         # @type CallbackUrl: String
-        # @param Url: 语音的URL地址，需要公网环境浏览器可下载。当 SourceType 值为 0 时须填写该字段，为 1 时不需要填写。注意：请确保录音文件时长在5个小时之内，否则可能识别失败。请保证文件的下载速度，否则可能下载失败。
+        # @param Url: 语音URL的地址（需要公网环境浏览器可下载）
+        # **当 SourceType 值为 0 时须填写该字段，为 1 时不需要填写**
+
+        # 注意：
+        # 1. 请确保录音文件时长在5个小时（含）之内，否则可能识别失败；
+        # 2. 请保证文件的下载速度，否则可能下载失败
         # @type Url: String
-        # @param Data: 语音数据base64编码，当SourceType 值为1时必须填写，为0可不写。音频数据要小于5MB。
+        # @param Data: 语音数据base64编码
+        # **当 SourceType 值为 1 时须填写该字段，为 0 时不需要填写**
+
+        # 注意：音频数据要小于5MB（含）
         # @type Data: String
-        # @param DataLen: 数据长度，非必填（此数据长度为数据未进行base64编码时的数据长度）。
+        # @param DataLen: 数据长度（此数据长度为数据未进行base64编码时的长度）
         # @type DataLen: Integer
-        # @param ConvertNumMode: 是否进行阿拉伯数字智能转换（目前支持中文普通话引擎）。0：不转换，直接输出中文数字，1：根据场景智能转换为阿拉伯数字，3: 打开数学相关数字转换。默认值为 1。
+        # @param ConvertNumMode: 阿拉伯数字智能转换（目前仅支持8k_zh/16k_zh引擎）
+        # 0：不转换，直接输出中文数字；
+        # 1：根据场景智能转换为阿拉伯数字；
+        # 3：打开数学相关数字转换（如：阿尔法转写为α）；
+        # 默认值为 1
         # @type ConvertNumMode: Integer
-        # @param FilterDirty: 是否过滤脏词（目前支持中文普通话引擎）。0：不过滤脏词；1：过滤脏词；2：将脏词替换为 * 。默认值为 0。
+        # @param FilterDirty: 脏词过滤（目前仅支持8k_zh/16k_zh引擎）
+        # 0：不过滤脏词；
+        # 1：过滤脏词；
+        # 2：将脏词替换为 * ；
+        # 默认值为 0
         # @type FilterDirty: Integer
-        # @param HotwordId: 热词表id。如不设置该参数，自动生效默认热词表；如设置了该参数，那么将生效对应的热词表。
+        # @param HotwordId: 热词表id
+        # 如不设置该参数，将自动生效默认热词表；
+        # 如设置该参数，将生效对应id的热词表；
+        # 点击这里查看[热词表配置方法](https://cloud.tencent.com/document/product/1093/40996)
         # @type HotwordId: String
-        # @param CustomizationId: 自学习模型 id。如设置了该参数，将生效对应的自学习模型。
+        # @param CustomizationId: 自学习定制模型 id
+        # 如设置了该参数，将生效对应id的自学习定制模型；
+        # 点击这里查看[自学习定制模型配置方法](https://cloud.tencent.com/document/product/1093/38416)
         # @type CustomizationId: String
-        # @param Extra: 附加参数(该参数无意义，忽略即可)
+        # @param Extra: 附加参数**（该参数无意义，忽略即可）**
         # @type Extra: String
-        # @param FilterPunc: 是否过滤标点符号（目前支持中文普通话引擎）。 0：不过滤，1：过滤句末标点，2：过滤所有标点。默认值为 0。
+        # @param FilterPunc: 标点符号过滤（目前仅支持8k_zh/16k_zh引擎）
+        # 0：不过滤标点；
+        # 1：过滤句末标点；
+        # 2：过滤所有标点；
+        # 默认值为 0
         # @type FilterPunc: Integer
-        # @param FilterModal: 是否过滤语气词（目前支持中文普通话引擎）。0：不过滤语气词；1：部分过滤；2：严格过滤 。默认值为 0。
+        # @param FilterModal: 语气词过滤（目前支持8k_zh/16k_zh引擎）
+        # 0：不过滤语气词；
+        # 1：过滤部分语气词；
+        # 2：严格过滤语气词；
+        # 默认值为 0
         # @type FilterModal: Integer
-        # @param EmotionalEnergy: 情绪能量值，取值为音量分贝值/10。取值范围：[1,10]。值越高情绪越强烈。0:不开启，1:开启
+        # @param EmotionalEnergy: 情绪能量值
+        # 取值为音量分贝值/10，取值范围：[1,10]，值越高情绪越强烈
+        # 0：不开启；
+        # 1：开启；
+        # 默认值为0
         # @type EmotionalEnergy: Integer
-        # @param ReinforceHotword: 热词增强功能。1:开启后（仅支持8k_zh,16k_zh），将开启同音替换功能，同音字、词在热词中配置。举例：热词配置“蜜制”并开启增强功能后，与“蜜制”同拼音（mizhi）的“秘制”的识别结果会被强制替换成“蜜制”。因此建议客户根据自己的实际情况开启该功能。
+        # @param ReinforceHotword: 热词增强功能（仅支持8k_zh/16k_zh引擎）
+        # 1：开启热词增强功能
+
+        # 注意：热词增强功能开启后，将对传入的热词表id开启同音替换功能，可以在这里查看[热词表配置方法](https://cloud.tencent.com/document/product/1093/40996)。效果举例：在热词表中配置“蜜制”一词，并开启增强功能，与“蜜制”（mìzhì）同音同调的“秘制”（mìzhì）的识别结果会被强制替换成“蜜制”。**建议客户根据实际的业务需求开启该功能**
         # @type ReinforceHotword: Integer
-        # @param SentenceMaxLength: 单标点最多字数，取值范围：[6，40]。默认为0，不开启该功能。该参数可用于字幕生成场景，控制单行字幕最大字数（设置ResTextFormat为3，解析返回的ResultDetail列表，通过结构中FinalSentence获取单个标点断句结果）。
+        # @param SentenceMaxLength: 单标点最多字数
+        # **可控制单行字幕最大字数，适用于字幕生成场景**，取值范围：[6，40]
+        # 0：不开启该功能；
+        # 默认值为0
+
+        # 注意：需设置ResTextFormat为3，解析返回的ResultDetail列表，通过结构中FinalSentence获取单个标点断句结果
         # @type SentenceMaxLength: Integer
-        # @param EmotionRecognition: 情绪识别能力(目前支持16k_zh) 默认为0，不开启。 1：开启情绪识别但是不会在文本展示“情绪标签”， 2：开启情绪识别并且在文本展示“情绪标签”。（该功能需要设置ResTextFormat 大于0）
-        # 注意：本功能为增值服务，购买对应套餐包后，将参数设置为1或2时方可按对应方式生效，并消耗套餐包对应资源。参数设置为0时无需购买套餐包，也不会消耗对应资源。
+        # @param EmotionRecognition: **【增值付费功能】**情绪识别能力（目前仅支持16k_zh）
+        # 0：不开启；
+        # 1：开启情绪识别，但不在文本展示情绪标签；
+        # 2：开启情绪识别，并且在文本展示情绪标签（**该功能需要设置ResTextFormat 大于0**）
+        # 默认值为0
+
+        # 注意：
+        # 1. **本功能为增值服务**，需将参数设置为1或2时方可按对应方式生效；
+        # 2. 如果传入参数值1或2，需确保账号已购买[情绪识别资源包](https://cloud.tencent.com/document/product/1093/35686#97ae4aa0-29a0-4066-9f07-ccaf8856a16b)，或账号开启后付费；**若当前账号已开启后付费功能，并传入参数值4，将[自动计费](https://cloud.tencent.com/document/product/1093/35686#d912167d-ffd5-41a9-8b1c-2e89845a6852)）**；
+        # 3. 参数设置为0时，无需购买资源包，也不会消耗情绪识别对应资源
         # @type EmotionRecognition: Integer
 
         attr_accessor :EngineModelType, :ChannelNum, :ResTextFormat, :SourceType, :SpeakerDiarization, :SpeakerNumber, :CallbackUrl, :Url, :Data, :DataLen, :ConvertNumMode, :FilterDirty, :HotwordId, :CustomizationId, :Extra, :FilterPunc, :FilterModal, :EmotionalEnergy, :ReinforceHotword, :SentenceMaxLength, :EmotionRecognition

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-asr
 version: !ruby/object:Gem::Version
-  version: 3.0.657
+  version: 3.0.658
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-12 00:00:00.000000000 Z
+date: 2023-09-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common