tencentcloud-sdk-python-intl-en 3.1.99__tar.gz → 3.1.101__tar.gz

{tencentcloud_sdk_python_intl_en-3.1.99/tencentcloud_sdk_python_intl_en.egg-info → tencentcloud_sdk_python_intl_en-3.1.101}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-intl-en
-Version: 3.1.99
+Version: 3.1.101
 Summary: Tencent Cloud SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python-intl-en
 Author: Tencent Cloud

{tencentcloud_sdk_python_intl_en-3.1.99 → tencentcloud_sdk_python_intl_en-3.1.101}/tencentcloud/__init__.py

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

{tencentcloud_sdk_python_intl_en-3.1.99 → tencentcloud_sdk_python_intl_en-3.1.101}/tencentcloud/asr/v20190614/asr_client.py

@@ -27,16 +27,16 @@ class AsrClient(AbstractClient):
 
 
     def CreateRecTask(self, request):
-        r"""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)
+        r"""This API can be used to recognize audio content with a long duration in recording files. For product pricing, see [Billing Overview (Online Version)](https://www.tencentcloud.com/zh/document/product/1118/43352)
         - 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.
+        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.)
+        - Supported languages: See the description of **EngineModelType** in this document.
+        - 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.
+        - 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).
+        - 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`
@@ -60,8 +60,8 @@ class AsrClient(AbstractClient):
 
     def DescribeTaskStatus(self, request):
         r"""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).
+        - **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 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).

{tencentcloud_sdk_python_intl_en-3.1.99 → tencentcloud_sdk_python_intl_en-3.1.101}/tencentcloud/asr/v20190614/asr_client_async.py

@@ -31,16 +31,16 @@ class AsrClient(AbstractClient):
             opts: Dict = None,
     ) -> models.CreateRecTaskResponse:
         """
-        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)
+        This API can be used to recognize audio content with a long duration in recording files. For product pricing, see [Billing Overview (Online Version)](https://www.tencentcloud.com/zh/document/product/1118/43352)
         - 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.
+        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.)
+        - Supported languages: See the description of **EngineModelType** in this document.
+        - 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.
+        - 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).
+        - 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).
         """
         
         kwargs = {}
@@ -59,8 +59,8 @@ class AsrClient(AbstractClient):
     ) -> models.DescribeTaskStatusResponse:
         """
         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).
+        - **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 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).

{tencentcloud_sdk_python_intl_en-3.1.99 → tencentcloud_sdk_python_intl_en-3.1.101}/tencentcloud/asr/v20190614/models.py

@@ -26,53 +26,50 @@ class CreateRecTaskRequest(AbstractModel):
     def __init__(self):
         r"""
         :param _EngineModelType: Engine model type.
-Each recognition engine adopts a specific billing plan. Engines marked with "large model version" adopt the large model billing plan. For product billing instructions, [click here] (https://intl.cloud.tencent.com/document/product/1093/35686?from_cn_redirect=1).
+Each recognition engine adopts a specific billing plan. Engines marked with "large model version" adopt the large model billing plan. For product billing instructions, [click here](https://www.tencentcloud.com/zh/document/product/1118/43352).
 
 
-Note: If you want to recognize telecommunication audio but find that a 16k engine is required, you can use a 16k engine as described below for recognition. However, ** the 16k engines are not trained for recognizing telecommunication audio. Therefore, the recognition results cannot be guaranteed. You need to check whether the recognition results can be used. **
+Note: If you want to recognize telecommunication audio but find that a 16k engine is required, you can use a 16k engine as described below for recognition. However, **the 16k engines are not trained for recognizing telecommunication audio. Therefore, the recognition results cannot be guaranteed. You need to check whether the recognition results can be used.**
 
 Engines for general scenarios:
-** Note: Use 16k engines for scenarios other than telecommunication. **
-** 16k_zh_large: ** Engine (large model version) for Mandarin, Chinese dialects, and English. This engine supports recognizing audio in Chinese, English, and [various Chinese dialects] (https://intl.cloud.tencent.com/document/product/1093/35682?from_cn_redirect=1). It has a large number of parameters, enhanced performance, and greatly improved recognition accuracy for low-quality audio with loud noise, too much echo, low voice volume, or faint voices. [Click here] (https://console.cloud.tencent.com/asr/demonstrate) to compare the recognition performance of the 16k_zh engine and this one.
-** 16k_multi_lang: ** Engine (large model version) for multiple languages. This engine supports recognizing audio in English, Japanese, Korean, Arabic, Filipino, French, Hindi, Indonesian, Malay, Portuguese, Spanish, Thai, Turkish, Vietnamese, and German (sentence-level or paragraph-level).
-** 16k_zh-PY: ** Engine for Chinese, English, and Cantonese. The engine supports recognizing audio in Mandarin, English, and Cantonese at the same time.
-** 16k_ms: ** Engine for Malay.
-** 16k_id: ** Engine for Indonesian.
-** 16k_th: ** Engine for Thai.
+**Note: Use 16k engines for scenarios other than telecommunication.**
+**16k_zh_large:** Engine (large model version) for Mandarin, Chinese dialects, and English. This engine supports recognizing audio in Chinese, English. It has a large number of parameters, enhanced performance, and greatly improved recognition accuracy for low-quality audio with loud noise, too much echo, low voice volume, or faint voices. [Click here](https://console.cloud.tencent.com/asr/demonstrate) to compare the recognition performance of the 16k_zh engine and this one.
+**16k_multi_lang:** Engine (large model version) for multiple languages. This engine supports recognizing audio in English, Japanese, Korean, Arabic, Filipino, French, Hindi, Indonesian, Malay, Portuguese, Spanish, Thai, Turkish, Vietnamese, and German (sentence-level or paragraph-level).
+**16k_zh-PY:** Engine for Chinese, English, and Cantonese. The engine supports recognizing audio in Mandarin, English, and Cantonese at the same time.
+**16k_ms:** Engine for Malay.
+**16k_id:** Engine for Indonesian.
+**16k_th:** Engine for Thai.
         :type EngineModelType: str
         :param _ChannelNum: Number of recognition channels.
-1: Mono. (16k engines only support mono. ** Do no t** set to stereo.)
+1: Mono. (16k engines only support mono.**Do no t** set to stereo.)
 2: Stereo. (Stereo is supported only for 8k engines, and the two channels should correspond to the respective communication parties.)
 
 Note:
-16k engines: Only support mono. ** ChannelNum should be set to 1 **.
-8k engines: Support both mono and stereo. ** It is recommended to set ChannelNum to 2 (indicating stereo) **. Stereo can physically distinguish speakers to avoid recognition mistakes caused by overlapping speech. It can provide the best speaker separation and recognition effects. Once stereo is set, the speakers are automatically separated. ** You do not need to enable the speaker separation feature **. You can use the default values for related parameters (** SpeakerDiarization and SpeakerNumber **). For speakerId in the returned ResultDetail, the value 0 represents the left channel, and the value 1 represents the right channel.
+16k engines: Only support mono.**ChannelNum should be set to 1.**
+8k engines: Support both mono and stereo. **It is recommended to set ChannelNum to 2 (indicating stereo)**. Stereo can physically distinguish speakers to avoid recognition mistakes caused by overlapping speech. It can provide the best speaker separation and recognition effects. Once stereo is set, the speakers are automatically separated. **You do not need to enable the speaker separation feature**. You can use the default values for related parameters (**SpeakerDiarization and SpeakerNumber**). For speakerId in the returned ResultDetail, the value 0 represents the left channel, and the value 1 represents the right channel.
         :type ChannelNum: int
         :param _ResTextFormat: Format of the returned recognition result.
-0: The basic recognition result (containing only valid voice timestamps but no word-level [detailed recognition result] (https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail)).
-1: The basic recognition result and word-level [detailed recognition result] (https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps and speech speed value but ** no punctuation **).
-2: The basic recognition result and word-level [detailed recognition result] (https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps, speech speed value, and ** punctuation **).
-3: The basic recognition result and word-level [detailed recognition result] (https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps, speech speed value, and ** punctuation **). The recognition results are segmented by punctuation. ** This format applies to subtitle scenarios **.
-4: ** [Value-added paid feature] ** The basic recognition result and word-level [detailed recognition result] (https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps, speech speed value, and ** punctuation **). The recognition results are segmented by NLP semantics. ** This format applies to scenarios such as meeting and court record transcription ** and is supported only for 8k_zh and 16k_zh engines.
-5: ** [Value-added paid feature] ** Basic recognition result and word-level [detailed recognition result] (https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps, speech speed value, and ** punctuation **). The oral-to-written transcription result is also output, which has excluded modal particles and consecutive identical words, optimized expressions, and corrected speech mistakes. ** This format applies to scenarios of generating minutes for online and offline meetings** and is supported only for 8k_zh and 16k_zh engines.
+0: The basic recognition result (containing only valid voice timestamps but no word-level [detailed recognition result](https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail)).
+1: The basic recognition result and word-level [detailed recognition result](https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps and speech speed value but **no punctuation**).
+2: The basic recognition result and word-level [detailed recognition result](https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps, speech speed value, and **punctuation**).
+3: The basic recognition result and word-level [detailed recognition result](https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps, speech speed value, and **punctuation**). The recognition results are segmented by punctuation. **This format applies to subtitle scenarios**.
+4: **[Value-added paid feature]** The basic recognition result and word-level [detailed recognition result](https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps, speech speed value, and **punctuation**). The recognition results are segmented by NLP semantics. **This format applies to scenarios such as meeting and court record transcription** and is supported only for 8k_zh and 16k_zh engines.
+5: **[Value-added paid feature]** Basic recognition result and word-level [detailed recognition result](https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps, speech speed value, and **punctuation**). The oral-to-written transcription result is also output, which has excluded modal particles and consecutive identical words, optimized expressions, and corrected speech mistakes. **This format applies to scenarios of generating minutes for online and offline meetings** and is supported only for 8k_zh and 16k_zh engines.
 
-Notes:
-If this parameter is set to 4, make sure that a [semantics-based segmentation resource package] (https://intl.cloud.tencent.com/document/product/1093/35686?from_cn_redirect=1#97ae4aa0-29a0-4066-9f07-ccaf8856a16b) is purchased for your account or that your account has enabled post-payment. ** If post-payment is enabled and this parameter is set to 4, [automatic billing] (https://intl.cloud.tencent.com/document/product/1093/35686?from_cn_redirect=1#d912167d-ffd5-41a9-8b1c-2e89845a6852) will apply **.
-If this parameter is set to 5, make sure that an [oral-to-written resource package] (https://intl.cloud.tencent.com/document/product/1093/35686?from_cn_redirect=1#97ae4aa0-29a0-4066-9f07-ccaf8856a16b) is purchased for your account or that your account has enabled post-payment. ** If post-payment is enabled and this parameter is set to 5, [automatic billing] (https://intl.cloud.tencent.com/document/product/1093/35686?from_cn_redirect=1#d912167d-ffd5-41a9-8b1c-2e89845a6852) will apply **.
         :type ResTextFormat: int
         :param _SourceType: Audio source.
 0: Audio URL.
 1: Local audio file (body of the POST request)
         :type SourceType: int
         :param _Data: Audio file Base64 code.
-** This parameter is required if SourceType is set to 1. Otherwise, it can be left blank. **
+**This parameter is required if SourceType is set to 1. Otherwise, it can be left blank.**
 
 Note: The audio data size cannot exceed 5 MB.
         :type Data: str
         :param _DataLen: Data length (before Base64 encoding)
         :type DataLen: int
         :param _Url: Audio URL. (The audio should be downloadable via a public network browser.)
-** This parameter is required if SourceType is set to 0. Otherwise, it can be left blank. **
+**This parameter is required if SourceType is set to 0. Otherwise, it can be left blank.**
 
 Notes:
 1. Make sure that the total audio duration of recording files does not exceed 5 hours. Otherwise, recognition may fail.
@@ -81,7 +78,7 @@ Notes:
         :param _CallbackUrl: Callback URL
 
 User-defined service URL for receiving recognition results.
-For the callback format and content, see [Callback Description] (https://intl.cloud.tencent.com/document/product/1093/52632?from_cn_redirect=1).
+For the callback format and content, see [Callback Description](https://intl.cloud.tencent.com/document/product/1093/52632?from_cn_redirect=1).
 
 Notes:
 
@@ -94,10 +91,10 @@ Notes:
 The default value is 0.
 
 Note:
-If an 8k engine is used and ChannelNum is set to 2 (stereo), use the default values for corresponding parameters as stated in the ** ChannelNum ** parameter description.
+If an 8k engine is used and ChannelNum is set to 2 (stereo), use the default values for corresponding parameters as stated in the **ChannelNum** parameter description.
         :type SpeakerDiarization: int
         :param _SpeakerNumber: Number of speakers to be separated.
-** Speaker separation must be enabled. Otherwise, this parameter does not take effect. ** Value range: 0-10.
+**Speaker separation must be enabled. Otherwise, this parameter does not take effect.** Value range: 0-10.
 0: Automatic separation. (Up to 20 speakers can be separated.)
 1-10: Specify the number of speakers.
 The default value is 0.
@@ -125,7 +122,7 @@ The default value is 1.
         :param _FilterDirty: Dirty word filtering (supported only for engines for recognizing audio in Mandarin).
 0: Do not filter out dirty words.
 1: Filter out dirty words.
-2: Replace dirty words with *.
+2: Replace dirty words with .
 The default value is 0.
         :type FilterDirty: int
         :param _FilterPunc: Punctuation filtering (supported only for engines for recognizing audio in Mandarin).
@@ -141,13 +138,13 @@ The default value is 0.
 The default value is 0.
         :type FilterModal: int
         :param _SentenceMaxLength: The maximum number of characters per line (supported only for engines for recognizing audio in Mandarin). A punctuation mark is added if this limit is reached.
-** This parameter can control the maximum number of characters per line, which applies to subtitle generation scenarios. ** Value range: [6,40].
+**This parameter can control the maximum number of characters per line, which applies to subtitle generation scenarios.** Value range: [6,40].
 0: Disable this feature.
 The default value is 0.
 
 Note: To enable this feature, ResTextFormat should be set to 3. The recognition result can be obtained from FinalSentence by parsing the list in the returned ResultDetail.
         :type SentenceMaxLength: int
-        :param _Extra: Additional parameter. ** (This parameter is meaningless. Ignore it.) **
+        :param _Extra: Additional parameter. **(This parameter is meaningless. Ignore it.)**
         :type Extra: str
         :param _HotwordList: Temporary term list. This parameter is used to improve the recognition accuracy.
 
@@ -203,19 +200,19 @@ Notes:
     @property
     def EngineModelType(self):
         r"""Engine model type.
-Each recognition engine adopts a specific billing plan. Engines marked with "large model version" adopt the large model billing plan. For product billing instructions, [click here] (https://intl.cloud.tencent.com/document/product/1093/35686?from_cn_redirect=1).
+Each recognition engine adopts a specific billing plan. Engines marked with "large model version" adopt the large model billing plan. For product billing instructions, [click here](https://www.tencentcloud.com/zh/document/product/1118/43352).
 
 
-Note: If you want to recognize telecommunication audio but find that a 16k engine is required, you can use a 16k engine as described below for recognition. However, ** the 16k engines are not trained for recognizing telecommunication audio. Therefore, the recognition results cannot be guaranteed. You need to check whether the recognition results can be used. **
+Note: If you want to recognize telecommunication audio but find that a 16k engine is required, you can use a 16k engine as described below for recognition. However, **the 16k engines are not trained for recognizing telecommunication audio. Therefore, the recognition results cannot be guaranteed. You need to check whether the recognition results can be used.**
 
 Engines for general scenarios:
-** Note: Use 16k engines for scenarios other than telecommunication. **
-** 16k_zh_large: ** Engine (large model version) for Mandarin, Chinese dialects, and English. This engine supports recognizing audio in Chinese, English, and [various Chinese dialects] (https://intl.cloud.tencent.com/document/product/1093/35682?from_cn_redirect=1). It has a large number of parameters, enhanced performance, and greatly improved recognition accuracy for low-quality audio with loud noise, too much echo, low voice volume, or faint voices. [Click here] (https://console.cloud.tencent.com/asr/demonstrate) to compare the recognition performance of the 16k_zh engine and this one.
-** 16k_multi_lang: ** Engine (large model version) for multiple languages. This engine supports recognizing audio in English, Japanese, Korean, Arabic, Filipino, French, Hindi, Indonesian, Malay, Portuguese, Spanish, Thai, Turkish, Vietnamese, and German (sentence-level or paragraph-level).
-** 16k_zh-PY: ** Engine for Chinese, English, and Cantonese. The engine supports recognizing audio in Mandarin, English, and Cantonese at the same time.
-** 16k_ms: ** Engine for Malay.
-** 16k_id: ** Engine for Indonesian.
-** 16k_th: ** Engine for Thai.
+**Note: Use 16k engines for scenarios other than telecommunication.**
+**16k_zh_large:** Engine (large model version) for Mandarin, Chinese dialects, and English. This engine supports recognizing audio in Chinese, English. It has a large number of parameters, enhanced performance, and greatly improved recognition accuracy for low-quality audio with loud noise, too much echo, low voice volume, or faint voices. [Click here](https://console.cloud.tencent.com/asr/demonstrate) to compare the recognition performance of the 16k_zh engine and this one.
+**16k_multi_lang:** Engine (large model version) for multiple languages. This engine supports recognizing audio in English, Japanese, Korean, Arabic, Filipino, French, Hindi, Indonesian, Malay, Portuguese, Spanish, Thai, Turkish, Vietnamese, and German (sentence-level or paragraph-level).
+**16k_zh-PY:** Engine for Chinese, English, and Cantonese. The engine supports recognizing audio in Mandarin, English, and Cantonese at the same time.
+**16k_ms:** Engine for Malay.
+**16k_id:** Engine for Indonesian.
+**16k_th:** Engine for Thai.
         :rtype: str
         """
         return self._EngineModelType
@@ -227,12 +224,12 @@ Engines for general scenarios:
     @property
     def ChannelNum(self):
         r"""Number of recognition channels.
-1: Mono. (16k engines only support mono. ** Do no t** set to stereo.)
+1: Mono. (16k engines only support mono.**Do no t** set to stereo.)
 2: Stereo. (Stereo is supported only for 8k engines, and the two channels should correspond to the respective communication parties.)
 
 Note:
-16k engines: Only support mono. ** ChannelNum should be set to 1 **.
-8k engines: Support both mono and stereo. ** It is recommended to set ChannelNum to 2 (indicating stereo) **. Stereo can physically distinguish speakers to avoid recognition mistakes caused by overlapping speech. It can provide the best speaker separation and recognition effects. Once stereo is set, the speakers are automatically separated. ** You do not need to enable the speaker separation feature **. You can use the default values for related parameters (** SpeakerDiarization and SpeakerNumber **). For speakerId in the returned ResultDetail, the value 0 represents the left channel, and the value 1 represents the right channel.
+16k engines: Only support mono.**ChannelNum should be set to 1.**
+8k engines: Support both mono and stereo. **It is recommended to set ChannelNum to 2 (indicating stereo)**. Stereo can physically distinguish speakers to avoid recognition mistakes caused by overlapping speech. It can provide the best speaker separation and recognition effects. Once stereo is set, the speakers are automatically separated. **You do not need to enable the speaker separation feature**. You can use the default values for related parameters (**SpeakerDiarization and SpeakerNumber**). For speakerId in the returned ResultDetail, the value 0 represents the left channel, and the value 1 represents the right channel.
         :rtype: int
         """
         return self._ChannelNum
@@ -244,16 +241,13 @@ Note:
     @property
     def ResTextFormat(self):
         r"""Format of the returned recognition result.
-0: The basic recognition result (containing only valid voice timestamps but no word-level [detailed recognition result] (https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail)).
-1: The basic recognition result and word-level [detailed recognition result] (https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps and speech speed value but ** no punctuation **).
-2: The basic recognition result and word-level [detailed recognition result] (https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps, speech speed value, and ** punctuation **).
-3: The basic recognition result and word-level [detailed recognition result] (https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps, speech speed value, and ** punctuation **). The recognition results are segmented by punctuation. ** This format applies to subtitle scenarios **.
-4: ** [Value-added paid feature] ** The basic recognition result and word-level [detailed recognition result] (https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps, speech speed value, and ** punctuation **). The recognition results are segmented by NLP semantics. ** This format applies to scenarios such as meeting and court record transcription ** and is supported only for 8k_zh and 16k_zh engines.
-5: ** [Value-added paid feature] ** Basic recognition result and word-level [detailed recognition result] (https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps, speech speed value, and ** punctuation **). The oral-to-written transcription result is also output, which has excluded modal particles and consecutive identical words, optimized expressions, and corrected speech mistakes. ** This format applies to scenarios of generating minutes for online and offline meetings** and is supported only for 8k_zh and 16k_zh engines.
+0: The basic recognition result (containing only valid voice timestamps but no word-level [detailed recognition result](https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail)).
+1: The basic recognition result and word-level [detailed recognition result](https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps and speech speed value but **no punctuation**).
+2: The basic recognition result and word-level [detailed recognition result](https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps, speech speed value, and **punctuation**).
+3: The basic recognition result and word-level [detailed recognition result](https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps, speech speed value, and **punctuation**). The recognition results are segmented by punctuation. **This format applies to subtitle scenarios**.
+4: **[Value-added paid feature]** The basic recognition result and word-level [detailed recognition result](https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps, speech speed value, and **punctuation**). The recognition results are segmented by NLP semantics. **This format applies to scenarios such as meeting and court record transcription** and is supported only for 8k_zh and 16k_zh engines.
+5: **[Value-added paid feature]** Basic recognition result and word-level [detailed recognition result](https://intl.cloud.tencent.com/document/api/1093/37824?from_cn_redirect=1#SentenceDetail) (containing word-level timestamps, speech speed value, and **punctuation**). The oral-to-written transcription result is also output, which has excluded modal particles and consecutive identical words, optimized expressions, and corrected speech mistakes. **This format applies to scenarios of generating minutes for online and offline meetings** and is supported only for 8k_zh and 16k_zh engines.
 
-Notes:
-If this parameter is set to 4, make sure that a [semantics-based segmentation resource package] (https://intl.cloud.tencent.com/document/product/1093/35686?from_cn_redirect=1#97ae4aa0-29a0-4066-9f07-ccaf8856a16b) is purchased for your account or that your account has enabled post-payment. ** If post-payment is enabled and this parameter is set to 4, [automatic billing] (https://intl.cloud.tencent.com/document/product/1093/35686?from_cn_redirect=1#d912167d-ffd5-41a9-8b1c-2e89845a6852) will apply **.
-If this parameter is set to 5, make sure that an [oral-to-written resource package] (https://intl.cloud.tencent.com/document/product/1093/35686?from_cn_redirect=1#97ae4aa0-29a0-4066-9f07-ccaf8856a16b) is purchased for your account or that your account has enabled post-payment. ** If post-payment is enabled and this parameter is set to 5, [automatic billing] (https://intl.cloud.tencent.com/document/product/1093/35686?from_cn_redirect=1#d912167d-ffd5-41a9-8b1c-2e89845a6852) will apply **.
         :rtype: int
         """
         return self._ResTextFormat
@@ -278,7 +272,7 @@ If this parameter is set to 5, make sure that an [oral-to-written resource packa
     @property
     def Data(self):
         r"""Audio file Base64 code.
-** This parameter is required if SourceType is set to 1. Otherwise, it can be left blank. **
+**This parameter is required if SourceType is set to 1. Otherwise, it can be left blank.**
 
 Note: The audio data size cannot exceed 5 MB.
         :rtype: str
@@ -303,7 +297,7 @@ Note: The audio data size cannot exceed 5 MB.
     @property
     def Url(self):
         r"""Audio URL. (The audio should be downloadable via a public network browser.)
-** This parameter is required if SourceType is set to 0. Otherwise, it can be left blank. **
+**This parameter is required if SourceType is set to 0. Otherwise, it can be left blank.**
 
 Notes:
 1. Make sure that the total audio duration of recording files does not exceed 5 hours. Otherwise, recognition may fail.
@@ -321,7 +315,7 @@ Notes:
         r"""Callback URL
 
 User-defined service URL for receiving recognition results.
-For the callback format and content, see [Callback Description] (https://intl.cloud.tencent.com/document/product/1093/52632?from_cn_redirect=1).
+For the callback format and content, see [Callback Description](https://intl.cloud.tencent.com/document/product/1093/52632?from_cn_redirect=1).
 
 Notes:
 
@@ -343,7 +337,7 @@ Notes:
 The default value is 0.
 
 Note:
-If an 8k engine is used and ChannelNum is set to 2 (stereo), use the default values for corresponding parameters as stated in the ** ChannelNum ** parameter description.
+If an 8k engine is used and ChannelNum is set to 2 (stereo), use the default values for corresponding parameters as stated in the **ChannelNum** parameter description.
         :rtype: int
         """
         return self._SpeakerDiarization
@@ -355,7 +349,7 @@ If an 8k engine is used and ChannelNum is set to 2 (stereo), use the default val
     @property
     def SpeakerNumber(self):
         r"""Number of speakers to be separated.
-** Speaker separation must be enabled. Otherwise, this parameter does not take effect. ** Value range: 0-10.
+**Speaker separation must be enabled. Otherwise, this parameter does not take effect.** Value range: 0-10.
 0: Automatic separation. (Up to 20 speakers can be separated.)
 1-10: Specify the number of speakers.
 The default value is 0.
@@ -450,7 +444,7 @@ The default value is 1.
         r"""Dirty word filtering (supported only for engines for recognizing audio in Mandarin).
 0: Do not filter out dirty words.
 1: Filter out dirty words.
-2: Replace dirty words with *.
+2: Replace dirty words with .
 The default value is 0.
         :rtype: int
         """
@@ -493,7 +487,7 @@ The default value is 0.
     @property
     def SentenceMaxLength(self):
         r"""The maximum number of characters per line (supported only for engines for recognizing audio in Mandarin). A punctuation mark is added if this limit is reached.
-** This parameter can control the maximum number of characters per line, which applies to subtitle generation scenarios. ** Value range: [6,40].
+**This parameter can control the maximum number of characters per line, which applies to subtitle generation scenarios.** Value range: [6,40].
 0: Disable this feature.
 The default value is 0.
 
@@ -508,7 +502,7 @@ Note: To enable this feature, ResTextFormat should be set to 3. The recognition
 
     @property
     def Extra(self):
-        r"""Additional parameter. ** (This parameter is meaningless. Ignore it.) **
+        r"""Additional parameter. **(This parameter is meaningless. Ignore it.)**
         :rtype: str
         """
         return self._Extra
@@ -613,7 +607,7 @@ class CreateRecTaskResponse(AbstractModel):
     def __init__(self):
         r"""
         :param _Data: Returned result of the recording recognition request, containing the task ID required for querying the result.
-** Note: The task ID is valid for 24 hours, and duplicate task IDs of different dates may exist. Do not use task ID as the unique ID in your business system. **
+**Note: The task ID is valid for 24 hours, and duplicate task IDs of different dates may exist. Do not use task ID as the unique ID in your business system.**
 
         :type Data: :class:`tencentcloud.asr.v20190614.models.Task`
         :param _RequestId: The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.
@@ -625,7 +619,7 @@ class CreateRecTaskResponse(AbstractModel):
     @property
     def Data(self):
         r"""Returned result of the recording recognition request, containing the task ID required for querying the result.
-** Note: The task ID is valid for 24 hours, and duplicate task IDs of different dates may exist. Do not use task ID as the unique ID in your business system. **
+**Note: The task ID is valid for 24 hours, and duplicate task IDs of different dates may exist. Do not use task ID as the unique ID in your business system.**
 
         :rtype: :class:`tencentcloud.asr.v20190614.models.Task`
         """
@@ -662,7 +656,7 @@ class DescribeTaskStatusRequest(AbstractModel):
     def __init__(self):
         r"""
         :param _TaskId: Task ID obtained from the CreateRecTask API, which is used to obtain the task status and results.
-** Note: A task is valid for 24 hours. Do not query the results with the tasks that have existed for more than 24 hours. **
+**Note: A task is valid for 24 hours. Do not query the results with the tasks that have existed for more than 24 hours.**
         :type TaskId: int
         """
         self._TaskId = None
@@ -670,7 +664,7 @@ class DescribeTaskStatusRequest(AbstractModel):
     @property
     def TaskId(self):
         r"""Task ID obtained from the CreateRecTask API, which is used to obtain the task status and results.
-** Note: A task is valid for 24 hours. Do not query the results with the tasks that have existed for more than 24 hours. **
+**Note: A task is valid for 24 hours. Do not query the results with the tasks that have existed for more than 24 hours.**
         :rtype: int
         """
         return self._TaskId
@@ -1136,22 +1130,22 @@ Note: This field may return null, indicating that no valid values can be obtaine
 
 
 class Task(AbstractModel):
-    r"""Returned data of the [recording recognition] (https://intl.cloud.tencent.com/document/product/1093/37823?from_cn_redirect=1#3.-.E8.BE.93.E5.87.BA.E5.8F.82.E6.95.B0) or [asynchronous real-time audio recognition] (https://intl.cloud.tencent.com/document/product/1093/52061?from_cn_redirect=1#3.-.E8.BE.93.E5.87.BA.E5.8F.82.E6.95.B0) request.
+    r"""Returneddata of the [recording recognition](https://intl.cloud.tencent.com/document/product/1093/37823?from_cn_redirect=1#3.-.E8.BE.93.E5.87.BA.E5.8F.82.E6.95.B0) request.
 
     """
 
     def __init__(self):
         r"""
-        :param _TaskId: Task ID. This ID can be used to obtain the recognition status and results through polling. The data type of TaskId is ** uint64 **.
-** Note: The task ID is valid for 24 hours, and duplicate task IDs of different dates may exist. Do not use task ID as the unique ID in your business system. **
+        :param _TaskId: Task ID. This ID can be used to obtain the recognition status and results through polling. The data type of TaskId is uint64 .
+Note: The task ID is valid for 24 hours, and duplicate task IDs of different dates may exist. Do not use task ID as the unique ID in your business system. 
         :type TaskId: int
         """
         self._TaskId = None
 
     @property
     def TaskId(self):
-        r"""Task ID. This ID can be used to obtain the recognition status and results through polling. The data type of TaskId is ** uint64 **.
-** Note: The task ID is valid for 24 hours, and duplicate task IDs of different dates may exist. Do not use task ID as the unique ID in your business system. **
+        r"""Task ID. This ID can be used to obtain the recognition status and results through polling. The data type of TaskId is uint64 .
+Note: The task ID is valid for 24 hours, and duplicate task IDs of different dates may exist. Do not use task ID as the unique ID in your business system. 
         :rtype: int
         """
         return self._TaskId
@@ -1174,7 +1168,7 @@ class Task(AbstractModel):
 
 
 class TaskStatus(AbstractModel):
-    r"""[Response parameters for obtaining recording recognition results] (https://intl.cloud.tencent.com/document/product/1093/37822?from_cn_redirect=1#3.-.E8.BE.93.E5.87.BA.E5.8F.82.E6.95.B0)
+    r"""[Response parameters for obtaining recording recognition results](https://intl.cloud.tencent.com/document/product/1093/37822?from_cn_redirect=1#3.-.E8.BE.93.E5.87.BA.E5.8F.82.E6.95.B0)
 
     """
 

{tencentcloud_sdk_python_intl_en-3.1.99 → tencentcloud_sdk_python_intl_en-3.1.101}/tencentcloud/batch/v20170312/batch_client.py

@@ -379,6 +379,29 @@ class BatchClient(AbstractClient):
                 raise TencentCloudSDKException(type(e).__name__, str(e))
 
 
+    def DescribeJobMonitorData(self, request):
+        r"""Query the resource usage monitoring information of Job task instances. This API only supports querying elastic node tasks and undeleted jobs. Computing environment tasks are not currently supported. This interface only supports querying the resource utilization of Job instances within a time range.
+
+        :param request: Request instance for DescribeJobMonitorData.
+        :type request: :class:`tencentcloud.batch.v20170312.models.DescribeJobMonitorDataRequest`
+        :rtype: :class:`tencentcloud.batch.v20170312.models.DescribeJobMonitorDataResponse`
+
+        """
+        try:
+            params = request._serialize()
+            headers = request.headers
+            body = self.call("DescribeJobMonitorData", params, headers=headers)
+            response = json.loads(body)
+            model = models.DescribeJobMonitorDataResponse()
+            model._deserialize(response["Response"])
+            return model
+        except Exception as e:
+            if isinstance(e, TencentCloudSDKException):
+                raise
+            else:
+                raise TencentCloudSDKException(type(e).__name__, str(e))
+
+
     def DescribeJobSubmitInfo(self, request):
         r"""This API is used to query the submission information of the specified job, with the return including the job submission information used as input parameters in the JobId and SubmitJob APIs.
 

{tencentcloud_sdk_python_intl_en-3.1.99 → tencentcloud_sdk_python_intl_en-3.1.101}/tencentcloud/batch/v20170312/batch_client_async.py

@@ -303,6 +303,24 @@ class BatchClient(AbstractClient):
         
         return await self.call_and_deserialize(**kwargs)
         
+    async def DescribeJobMonitorData(
+            self,
+            request: models.DescribeJobMonitorDataRequest,
+            opts: Dict = None,
+    ) -> models.DescribeJobMonitorDataResponse:
+        """
+        Query the resource usage monitoring information of Job task instances. This API only supports querying elastic node tasks and undeleted jobs. Computing environment tasks are not currently supported. This interface only supports querying the resource utilization of Job instances within a time range.
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeJobMonitorData"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeJobMonitorDataResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
     async def DescribeJobSubmitInfo(
             self,
             request: models.DescribeJobSubmitInfoRequest,