tencentcloud-sdk-python-tsi 3.0.1179__tar.gz → 3.0.1257__tar.gz

{tencentcloud-sdk-python-tsi-3.0.1179 → tencentcloud-sdk-python-tsi-3.0.1257}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: tencentcloud-sdk-python-tsi
-Version: 3.0.1179
+Version: 3.0.1257
 Summary: Tencent Cloud Tsi SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud

{tencentcloud-sdk-python-tsi-3.0.1179 → tencentcloud-sdk-python-tsi-3.0.1257}/setup.py

@@ -8,7 +8,7 @@ ROOT = os.path.dirname(__file__)
 
 setup(
     name='tencentcloud-sdk-python-tsi',
-    install_requires=["tencentcloud-sdk-python-common==3.0.1179"],
+    install_requires=["tencentcloud-sdk-python-common==3.0.1257"],
     version=tencentcloud.__version__,
     description='Tencent Cloud Tsi SDK for Python',
     long_description=open('README.rst').read(),

{tencentcloud-sdk-python-tsi-3.0.1179 → tencentcloud-sdk-python-tsi-3.0.1257}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.0.1179'
+__version__ = '3.0.1257'

{tencentcloud-sdk-python-tsi-3.0.1179 → tencentcloud-sdk-python-tsi-3.0.1257}/tencentcloud/tsi/v20210325/models.py

@@ -39,6 +39,8 @@ class DisplayInfo(AbstractModel):
         :type EndTime: int
         :param _IsEnd:  当前句子是否已结束
         :type IsEnd: bool
+        :param _Audio: base64编码的wav/mp3音频数据
+        :type Audio: str
         """
         self._SeId = None
         self._SeVer = None
@@ -47,6 +49,7 @@ class DisplayInfo(AbstractModel):
         self._StartTime = None
         self._EndTime = None
         self._IsEnd = None
+        self._Audio = None
 
     @property
     def SeId(self):
@@ -104,6 +107,14 @@ class DisplayInfo(AbstractModel):
     def IsEnd(self, IsEnd):
         self._IsEnd = IsEnd
 
+    @property
+    def Audio(self):
+        return self._Audio
+
+    @Audio.setter
+    def Audio(self, Audio):
+        self._Audio = Audio
+
 
     def _deserialize(self, params):
         self._SeId = params.get("SeId")
@@ -113,6 +124,102 @@ class DisplayInfo(AbstractModel):
         self._StartTime = params.get("StartTime")
         self._EndTime = params.get("EndTime")
         self._IsEnd = params.get("IsEnd")
+        self._Audio = params.get("Audio")
+        memeber_set = set(params.keys())
+        for name, value in vars(self).items():
+            property_name = name[1:]
+            if property_name in memeber_set:
+                memeber_set.remove(property_name)
+        if len(memeber_set) > 0:
+            warnings.warn("%s fileds are useless." % ",".join(memeber_set))
+        
+
+
+class TTS(AbstractModel):
+    """同传TTS请求参数
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _Codec: 返回音频格式，可取值：wav，mp3，pcm
+        :type Codec: str
+        :param _VoiceType: 音色 ID，只包括标准音色（注，日文只有一个固定音色）。
+完整的音色 ID 列表请参见[音色列表](https://cloud.tencent.com/document/product/1073/92668)。
+        :type VoiceType: int
+        :param _Volume: 音量大小，范围[-10，10]，对应音量大小。默认为0，代表正常音量，值越大音量越高。
+        :type Volume: float
+        :param _Speed: 语速，范围：[-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)
+        :type Speed: float
+        :param _SampleRate: 音频采样率：
+
+- 16000：16k（默认）
+- 8000：8k
+        :type SampleRate: int
+        """
+        self._Codec = None
+        self._VoiceType = None
+        self._Volume = None
+        self._Speed = None
+        self._SampleRate = None
+
+    @property
+    def Codec(self):
+        return self._Codec
+
+    @Codec.setter
+    def Codec(self, Codec):
+        self._Codec = Codec
+
+    @property
+    def VoiceType(self):
+        return self._VoiceType
+
+    @VoiceType.setter
+    def VoiceType(self, VoiceType):
+        self._VoiceType = VoiceType
+
+    @property
+    def Volume(self):
+        return self._Volume
+
+    @Volume.setter
+    def Volume(self, Volume):
+        self._Volume = Volume
+
+    @property
+    def Speed(self):
+        return self._Speed
+
+    @Speed.setter
+    def Speed(self, Speed):
+        self._Speed = Speed
+
+    @property
+    def SampleRate(self):
+        return self._SampleRate
+
+    @SampleRate.setter
+    def SampleRate(self, SampleRate):
+        self._SampleRate = SampleRate
+
+
+    def _deserialize(self, params):
+        self._Codec = params.get("Codec")
+        self._VoiceType = params.get("VoiceType")
+        self._Volume = params.get("Volume")
+        self._Speed = params.get("Speed")
+        self._SampleRate = params.get("SampleRate")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -231,9 +338,19 @@ class TongChuanRecognizeRequest(AbstractModel):
         r"""
         :param _SessionUuid: 一段完整的语音对应一个SessionUuid
         :type SessionUuid: str
-        :param _Source: 音频中的语言类型，支持语言列表<li> zh : 中文 </li> <li> en : 英文 </li>
+        :param _Source: 源语言，支持：
+zh：中文
+en：英语
+ja：日语
+ko：韩语
+yue：粤语
         :type Source: str
-        :param _Target: 翻译目标语言类型，支持的语言列表<li> zh : 中文 </li> <li> en : 英文 </li>
+        :param _Target: 目标语言，各源语言的目标语言支持列表如下
+<li>zh（中文）：en（英语）、ja（日语）、ko（韩语）、yue（粤语）</li>
+<li>en（英语）：zh（中文）</li>
+<li>ja（日语）：zh（中文）</li>
+<li>ko（韩语）：zh（中文）</li>
+<li>yue（粤语）：zh（中文）</li>
         :type Target: str
         :param _AudioFormat: 语音编码类型，1-pcm
         :type AudioFormat: int
@@ -243,10 +360,12 @@ class TongChuanRecognizeRequest(AbstractModel):
         :type Utc: int
         :param _IsEnd: 是否最后一片语音分片，0-否，1-是
         :type IsEnd: int
-        :param _TranslateTime: 翻译时机，0 -不翻译 1 - 句子结束时翻译，2 - 句子实时翻译
+        :param _TranslateTime: 翻译时机，0-不翻译 2-句子实时翻译
         :type TranslateTime: int
         :param _Data: 语音分片内容进行 Base64 编码后的字符串。音频内容需包含有效并可识别的文本信息。
         :type Data: str
+        :param _TTS: TTS播报控制参数	
+        :type TTS: :class:`tencentcloud.tsi.v20210325.models.TTS`
         """
         self._SessionUuid = None
         self._Source = None
@@ -257,6 +376,7 @@ class TongChuanRecognizeRequest(AbstractModel):
         self._IsEnd = None
         self._TranslateTime = None
         self._Data = None
+        self._TTS = None
 
     @property
     def SessionUuid(self):
@@ -330,6 +450,14 @@ class TongChuanRecognizeRequest(AbstractModel):
     def Data(self, Data):
         self._Data = Data
 
+    @property
+    def TTS(self):
+        return self._TTS
+
+    @TTS.setter
+    def TTS(self, TTS):
+        self._TTS = TTS
+
 
     def _deserialize(self, params):
         self._SessionUuid = params.get("SessionUuid")
@@ -341,6 +469,9 @@ class TongChuanRecognizeRequest(AbstractModel):
         self._IsEnd = params.get("IsEnd")
         self._TranslateTime = params.get("TranslateTime")
         self._Data = params.get("Data")
+        if params.get("TTS") is not None:
+            self._TTS = TTS()
+            self._TTS._deserialize(params.get("TTS"))
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -385,9 +516,19 @@ class TongChuanSyncRequest(AbstractModel):
         r"""
         :param _SessionUuid: 一段完整的语音对应一个SessionUuid
         :type SessionUuid: str
-        :param _Source: 音频中的语言类型，支持语言列表<li> zh : 中文 </li> <li> en : 英文 </li>
+        :param _Source: 源语言，支持：
+zh：中文
+en：英语
+ja：日语
+ko：韩语
+yue：粤语
         :type Source: str
-        :param _Target: 翻译目标语言类型，支持的语言列表<li> zh : 中文 </li> <li> en : 英文 </li>
+        :param _Target: 目标语言，各源语言的目标语言支持列表如下
+<li>zh（中文）：en（英语）、ja（日语）、ko（韩语）、yue（粤语）</li>
+<li>en（英语）：zh（中文）</li>
+<li>ja（日语）：zh（中文）</li>
+<li>ko（韩语）：zh（中文）</li>
+<li>yue（粤语）：zh（中文）</li>
         :type Target: str
         :param _AudioFormat: 语音编码类型，1-pcm
         :type AudioFormat: int
@@ -397,10 +538,12 @@ class TongChuanSyncRequest(AbstractModel):
         :type Utc: int
         :param _IsEnd: 是否最后一片语音分片，0-否，1-是
         :type IsEnd: int
-        :param _TranslateTime: 翻译时机，0 -不翻译 1 - 句子结束时翻译，2 - 句子实时翻译
+        :param _TranslateTime: 翻译时机，0-不翻译 2-句子实时翻译
         :type TranslateTime: int
         :param _Data: 语音分片内容进行 Base64 编码后的字符串。音频内容需包含有效并可识别的文本信息。
         :type Data: str
+        :param _TTS: TTS播报控制参数
+        :type TTS: :class:`tencentcloud.tsi.v20210325.models.TTS`
         """
         self._SessionUuid = None
         self._Source = None
@@ -411,6 +554,7 @@ class TongChuanSyncRequest(AbstractModel):
         self._IsEnd = None
         self._TranslateTime = None
         self._Data = None
+        self._TTS = None
 
     @property
     def SessionUuid(self):
@@ -484,6 +628,14 @@ class TongChuanSyncRequest(AbstractModel):
     def Data(self, Data):
         self._Data = Data
 
+    @property
+    def TTS(self):
+        return self._TTS
+
+    @TTS.setter
+    def TTS(self, TTS):
+        self._TTS = TTS
+
 
     def _deserialize(self, params):
         self._SessionUuid = params.get("SessionUuid")
@@ -495,6 +647,9 @@ class TongChuanSyncRequest(AbstractModel):
         self._IsEnd = params.get("IsEnd")
         self._TranslateTime = params.get("TranslateTime")
         self._Data = params.get("Data")
+        if params.get("TTS") is not None:
+            self._TTS = TTS()
+            self._TTS._deserialize(params.get("TTS"))
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]

{tencentcloud-sdk-python-tsi-3.0.1179 → tencentcloud-sdk-python-tsi-3.0.1257}/tencentcloud/tsi/v20210325/tsi_client.py

@@ -50,7 +50,20 @@ class TsiClient(AbstractClient):
 
 
     def TongChuanRecognize(self, request):
-        """本接口提供上传音频，将音频进行语音识别并翻译成文本的服务，目前开放中英互译的同传服务。 待识别和翻译的音频文件格式是 pcm，pcm采样率要求16kHz、位深16bit、单声道、每个分片时长200ms~500ms，音频内语音清晰。
+        """本接口提供上传音频，将音频进行语音识别并翻译成文本的服务。
+        该接口需要配合[同传查询结果](https://cloud.tencent.com/document/product/1399/107636)接口使用，建议一个线程进行音频数据上传同时另外一个线程拉取同传结果。
+        如果需要同步接口，既上传音频的同时拉取同传结果，可以使用[同传上传音频并查询结果](https://cloud.tencent.com/document/product/1399/107634)接口。
+
+        -----------
+        ### 接口要求
+        集成该API时，需按照以下要求：
+
+        | 内容| 格式 |
+        | -------- | ------- |
+        | 音频格式  | pcm    |
+        | 音频属性 | <ul><li>采样率：16000Hz</li><li>采样精度：16bits</li><li>声道：单声道（mono）</li></ul> |
+        | 响应格式    | 统一采用 JSON 格式   |
+        | 数据发送    | 建议每200ms 发送200ms 时长的数据包，即1:1实时率，对应大小为6400字节。<br/><ol><li>音频发送速率过快超过1:1实时率或者音频数据包之间发送间隔超过6秒，可能导致引擎出错，后台将返回错误；</li><li>每次发送数据的大小不得小于 200ms时长 的数据包，且不得大于 500ms时长 的数据包；小于 200ms时长 的数据包会被丢弃，大于 500ms时长 的数据包会影响引擎的数据处理；</li><li>若最后一个音频数据包不足 200ms，需要使用空数据进行补齐；</li></ol> |
 
         :param request: Request instance for TongChuanRecognize.
         :type request: :class:`tencentcloud.tsi.v20210325.models.TongChuanRecognizeRequest`
@@ -73,7 +86,18 @@ class TsiClient(AbstractClient):
 
 
     def TongChuanSync(self, request):
-        """本接口提供上传音频，将音频进行语音识别并翻译成文本的服务，目前开放中英互译的同传服务。 待识别和翻译的音频文件格式是 pcm，pcm采样率要求16kHz、位深16bit、单声道、每个分片时长200ms~500ms，音频内语音清晰。
+        """本接口提供上传音频，将音频进行语音识别并翻译成文本的服务。
+
+        -----------
+        ### 接口要求
+        集成该API时，需按照以下要求：
+
+        | 内容| 格式 |
+        | -------- | ------- |
+        | 音频格式  | pcm    |
+        | 音频属性 | <ul><li>采样率：16000Hz</li><li>采样精度：16bits</li><li>声道：单声道（mono）</li></ul> |
+        | 响应格式    | 统一采用 JSON 格式   |
+        | 数据发送    | 建议每200ms 发送200ms 时长的数据包，即1:1实时率，对应大小为6400字节。<br/><ol><li>音频发送速率过快超过1:1实时率或者音频数据包之间发送间隔超过6秒，可能导致引擎出错，后台将返回错误；</li><li>每次发送数据的大小不得小于 200ms时长 的数据包，且不得大于 500ms时长 的数据包；小于 200ms时长 的数据包会被丢弃，大于 500ms时长 的数据包会影响引擎的数据处理；</li><li>若最后一个音频数据包不足 200ms，需要使用空数据进行补齐；</li></ol> |
 
         :param request: Request instance for TongChuanSync.
         :type request: :class:`tencentcloud.tsi.v20210325.models.TongChuanSyncRequest`

{tencentcloud-sdk-python-tsi-3.0.1179 → tencentcloud-sdk-python-tsi-3.0.1257}/tencentcloud_sdk_python_tsi.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 1.1
 Name: tencentcloud-sdk-python-tsi
-Version: 3.0.1179
+Version: 3.0.1257
 Summary: Tencent Cloud Tsi SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud

tencentcloud-sdk-python-tsi-3.0.1257/tencentcloud_sdk_python_tsi.egg-info/requires.txt

@@ -0,0 +1 @@
+tencentcloud-sdk-python-common==3.0.1257

tencentcloud-sdk-python-tsi-3.0.1179/tencentcloud_sdk_python_tsi.egg-info/requires.txt

@@ -1 +0,0 @@
-tencentcloud-sdk-python-common==3.0.1179