tencentcloud-sdk-python-intl-en 3.0.1095__py2.py3-none-any.whl → 3.0.1097__py2.py3-none-any.whl

tencentcloud/__init__.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-__version__ = '3.0.1095'
+__version__ = '3.0.1097'

tencentcloud/asr/v20190614/asr_client.py

@@ -0,0 +1,87 @@
+# -*- coding: utf8 -*-
+# Copyright (c) 2017-2021 THL A29 Limited, a Tencent company. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+
+from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException
+from tencentcloud.common.abstract_client import AbstractClient
+from tencentcloud.asr.v20190614 import models
+
+
+class AsrClient(AbstractClient):
+    _apiVersion = '2019-06-14'
+    _endpoint = 'asr.tencentcloudapi.com'
+    _service = 'asr'
+
+
+    def CreateRecTask(self, request):
+        """This API can be used to recognize audio content with a long duration in recording files. If you want to use ASR with UI, visit [the trial console] (https://console.cloud.tencent.com/asr/demonstrate). For product pricing, see [Billing Overview (Online Version)] (https://intl.cloud.tencent.com/document/product/1093/35686?from_cn_redirect=1)
+        - Default frequency limit: 20 requests/second. This limit only applies to submitted requests but not the response time.
+        Response time: The API adopts asynchronous callback and does not return results in real time. Recognition results will be returned within 3 hours at most. ** In most cases, audio with a duration of 1 hour can be recognized in 1 to 3 minutes. ** Note: The response time does not include the audio download time and will not apply to scenarios where recordings with a total audio duration of over 1,000 hours or over 20,000 requests are submitted within 30 minutes.
+        - Audio formats: WAV, MP3, M4A, FLV, MP4, WMA, 3GP, AMR, AAC, OGG (Opus), and FLAC.
+        - Supported languages: See the description of ** EngineModelType ** in this document or go to [Product Features] (https://intl.cloud.tencent.com/document/product/1093/35682?from_cn_redirect=1) for details.
+        - Audio submission method: This API supports ** audio URLs and local audio files **. It is recommended to use [Tencent Cloud COS] (https://intl.cloud.tencent.com/document/product/436/38484?from_cn_redirect=1) to store audio files, generate URLs, and submit requests. This method does not incur public network or downstream traffic fees but can speed up task processing. (Set the public read and private write permissions for COS buckets or URLs to be externally accessible.)
+        - Audio restrictions: For a single URL, the audio duration cannot exceed 5 hours, and the file size cannot exceed 1 GB. For a local audio file, the file size cannot exceed 5 MB.
+        - Obtain recognition results: Results can be obtained through ** callback or polling **. See [Result Query] (https://intl.cloud.tencent.com/document/product/1093/37822?from_cn_redirect=1) for details.
+        - Recognition result retention period: Recognition results are retained on the server for 24 hours.
+        - For the signature method, see the content related to the signature method v3 in [Public Parameters] (https://intl.cloud.tencent.com/document/api/1093/35640?from_cn_redirect=1).
+
+        :param request: Request instance for CreateRecTask.
+        :type request: :class:`tencentcloud.asr.v20190614.models.CreateRecTaskRequest`
+        :rtype: :class:`tencentcloud.asr.v20190614.models.CreateRecTaskResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("CreateRecTask", params, headers=headers)
+            response = json.loads(body)
+            model = models.CreateRecTaskResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
+    def DescribeTaskStatus(self, request):
+        """The recognition results can be obtained through callback or polling after the recording recognition request API is called.
+        - ** Note: A task is valid for 24 hours. Do not query the results with tasks that have existed for more than 24 hours or use task ID as the unique business ID because duplicate TaskIds of different dates may exist. **
+        - For the callback method, the results will be sent by using a POST request to the callback URL specified in the request after the recognition is completed. For more details, see [Callback Description] (https://intl.cloud.tencent.com/document/product/1093/52632?from_cn_redirect=1).
+        - For the polling method, you need to actively provide the task ID to poll for recognition results. There are four possible results: success, waiting, in progress, and failure. For detailed information, see the content below.
+        - The request method is HTTP POST, and Content-Type is "application/json; charset=utf-8".
+        - For the signature method, see the content related to the signature method v3 in [Public Parameters](https://intl.cloud.tencent.com/document/api/1093/35640?from_cn_redirect=1).
+        - Default request frequency limit: 50 requests/second. If you want to increase the request frequency limit, submit a [ticket](https://console.cloud.tencent.com/workorder/category).
+
+        :param request: Request instance for DescribeTaskStatus.
+        :type request: :class:`tencentcloud.asr.v20190614.models.DescribeTaskStatusRequest`
+        :rtype: :class:`tencentcloud.asr.v20190614.models.DescribeTaskStatusResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeTaskStatus", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeTaskStatusResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))

tencentcloud/asr/v20190614/errorcodes.py

@@ -0,0 +1,66 @@
+# -*- coding: utf8 -*-
+# Copyright (c) 2017-2021 THL A29 Limited, a Tencent company. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+# Authentication error occurred.
+AUTHFAILURE_INVALIDAUTHORIZATION = 'AuthFailure.InvalidAuthorization'
+
+# Authentication error occurred.
+FAILEDOPERATION_CHECKAUTHINFOFAILED = 'FailedOperation.CheckAuthInfoFailed'
+
+# Failed to download the audio file.
+FAILEDOPERATION_ERRORDOWNFILE = 'FailedOperation.ErrorDownFile'
+
+# Recognition failed.
+FAILEDOPERATION_ERRORRECOGNIZE = 'FailedOperation.ErrorRecognize'
+
+# Incorrect task ID.
+FAILEDOPERATION_NOSUCHTASK = 'FailedOperation.NoSuchTask'
+
+# Services are stopped due to overdue payments. Top up your Tencent Cloud account first.
+FAILEDOPERATION_SERVICEISOLATE = 'FailedOperation.ServiceIsolate'
+
+# The resource package is used up. Purchase a new one or enable post-payment.
+FAILEDOPERATION_USERHASNOAMOUNT = 'FailedOperation.UserHasNoAmount'
+
+# The resource package is used up. Enable post-payment or purchase a new resource package.
+FAILEDOPERATION_USERHASNOFREEAMOUNT = 'FailedOperation.UserHasNoFreeAmount'
+
+# The service is not enabled. Enable it in the Tencent Cloud ASR console.
+FAILEDOPERATION_USERNOTREGISTERED = 'FailedOperation.UserNotRegistered'
+
+# Failed to download the audio file.
+INTERNALERROR_ERRORDOWNFILE = 'InternalError.ErrorDownFile'
+
+# Failed to access the database.
+INTERNALERROR_FAILACCESSDATABASE = 'InternalError.FailAccessDatabase'
+
+# Failed to access Redis.
+INTERNALERROR_FAILACCESSREDIS = 'InternalError.FailAccessRedis'
+
+# Parameter error.
+INVALIDPARAMETER = 'InvalidParameter'
+
+# Invalid parameter value.
+INVALIDPARAMETERVALUE = 'InvalidParameterValue'
+
+# Parameters are missing
+MISSINGPARAMETER = 'MissingParameter'
+
+# Requests are sent too frequently.
+REQUESTLIMITEXCEEDED_UINLIMITEXCEEDED = 'RequestLimitExceeded.UinLimitExceeded'
+
+# Unknown parameter.
+UNKNOWNPARAMETER = 'UnknownParameter'