tencentcloud-sdk-python-intl-en 3.0.1102__py2.py3-none-any.whl → 3.0.1103__py2.py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of tencentcloud-sdk-python-intl-en might be problematic. Click here for more details.

@@ -1645,7 +1645,8 @@ Note: This field may return null, indicating that no valid values can be obtaine
1645
1645
  :param _Subtitle: The subtitle file.
1646
1646
  Note: This field may return null, indicating that no valid values can be obtained.
1647
1647
  :type Subtitle: :class:`tencentcloud.mps.v20190612.models.MediaInputInfo`
1648
- :param _SubtitleName: Subtitle name.
1648
+ :param _SubtitleName: Subtitle name.
1649
+ Note: supports Chinese characters, letters, digits, spaces, underscores (_), hyphens (-), periods (.), and parentheses. Max 64 characters.
1649
1650
  Note: This field may return null, indicating that no valid value can be obtained.
1650
1651
  :type SubtitleName: str
1651
1652
  """
@@ -1682,7 +1683,8 @@ Note: This field may return null, indicating that no valid values can be obtaine
1682
1683
 
1683
1684
  @property
1684
1685
  def SubtitleName(self):
1685
- """Subtitle name.
1686
+ """Subtitle name.
1687
+ Note: supports Chinese characters, letters, digits, spaces, underscores (_), hyphens (-), periods (.), and parentheses. Max 64 characters.
1686
1688
  Note: This field may return null, indicating that no valid value can be obtained.
1687
1689
  :rtype: str
1688
1690
  """
@@ -14819,15 +14821,18 @@ Default value: 0.
14819
14821
  :type DisableHigherVideoResolution: int
14820
14822
  :param _Comment: Template description. Length limit: 256 characters.
14821
14823
  :type Comment: str
14822
- :param _PureAudio: Whether it is an audio-only template. 0: video template. 1: audio-only template.When the value is 1:
14824
+ :param _PureAudio: Indicates whether it is audio-only. 0 means video template, 1 means audio-only template.
14825
+ When the value is 1.
14823
14826
  1. StreamInfos.N.RemoveVideo=1
14824
14827
  2. StreamInfos.N.RemoveAudio=0
14825
14828
  3. StreamInfos.N.Video.Codec=copy
14826
-
14827
- When the value is 0:
14828
-
14829
+ When the value is 0.
14829
14830
  1. StreamInfos.N.Video.Codec cannot be copy.
14830
14831
  2. StreamInfos.N.Video.Fps cannot be null.
14832
+
14833
+ Note:
14834
+
14835
+ This value only distinguishes template types. The task uses the values of RemoveAudio and RemoveVideo.
14831
14836
  :type PureAudio: int
14832
14837
  :param _SegmentType: HLS segment type. Valid values: <li>ts-segment: HLS+TS segment.</li> <li>ts-byterange: HLS+TS byte range.</li> <li>mp4-segment: HLS+MP4 segment.</li> <li>mp4-byterange: HLS+MP4 byte range.</li> <li>ts-packed-audio: TS+Packed audio.</li> <li>mp4-packed-audio: MP4+Packed audio.</li> Default value: ts-segment.
14833
14838
  Note: The HLS segment format for adaptive bitrate streaming is based on this field.
@@ -14919,15 +14924,18 @@ Default value: 0.
14919
14924
 
14920
14925
  @property
14921
14926
  def PureAudio(self):
14922
- """Whether it is an audio-only template. 0: video template. 1: audio-only template.When the value is 1:
14927
+ """Indicates whether it is audio-only. 0 means video template, 1 means audio-only template.
14928
+ When the value is 1.
14923
14929
  1. StreamInfos.N.RemoveVideo=1
14924
14930
  2. StreamInfos.N.RemoveAudio=0
14925
14931
  3. StreamInfos.N.Video.Codec=copy
14926
-
14927
- When the value is 0:
14928
-
14932
+ When the value is 0.
14929
14933
  1. StreamInfos.N.Video.Codec cannot be copy.
14930
14934
  2. StreamInfos.N.Video.Fps cannot be null.
14935
+
14936
+ Note:
14937
+
14938
+ This value only distinguishes template types. The task uses the values of RemoveAudio and RemoveVideo.
14931
14939
  :rtype: int
14932
14940
  """
14933
14941
  return self._PureAudio
@@ -31347,19 +31355,26 @@ class ModifyAdaptiveDynamicStreamingTemplateRequest(AbstractModel):
31347
31355
  <li>1: yes.</li>
31348
31356
  :type DisableHigherVideoResolution: int
31349
31357
  :param _StreamInfos: Parameter information of input streams for transcoding to adaptive bitrate streaming. Up to 10 streams can be input.
31350
- Note: the frame rate of each stream must be consistent; otherwise, the frame rate of the first stream is used as the output frame rate.
31358
+
31359
+ Note:
31360
+
31361
+ 1. The frame rate of each stream must be consistent; otherwise, the frame rate of the first stream is used as the output frame rate.
31362
+ 2. When modifying substream information, all field values must be fully modified and added; otherwise, fields not filled in will use default values.
31351
31363
  :type StreamInfos: list of AdaptiveStreamTemplate
31352
31364
  :param _Comment: Template description. Length limit: 256 characters.
31353
31365
  :type Comment: str
31354
- :param _PureAudio: Whether it is an audio-only template. 0: video template. 1: audio-only template.When the value is 1:
31366
+ :param _PureAudio: Indicates whether it is audio-only. 0 means video template, 1 means audio-only template.
31367
+ When the value is 1.
31355
31368
  1. StreamInfos.N.RemoveVideo=1
31356
31369
  2. StreamInfos.N.RemoveAudio=0
31357
31370
  3. StreamInfos.N.Video.Codec=copy
31358
-
31359
- When the value is 0:
31360
-
31371
+ When the value is 0.
31361
31372
  1. StreamInfos.N.Video.Codec cannot be copy.
31362
31373
  2. StreamInfos.N.Video.Fps cannot be null.
31374
+
31375
+ Note:
31376
+
31377
+ This value only distinguishes template types. The task uses the values of RemoveAudio and RemoveVideo.
31363
31378
  :type PureAudio: int
31364
31379
  :param _SegmentType: HLS segment type. Valid values: <li>ts-segment: HLS+TS segment.</li> <li>ts-byterange: HLS+TS byte range.</li> <li>mp4-segment: HLS+MP4 segment.</li> <li>mp4-byterange: HLS+MP4 byte range.</li> <li>ts-packed-audio: TS+Packed audio.</li> <li>mp4-packed-audio: MP4+Packed audio.</li> Default value: ts-segment.
31365
31380
  Note: The HLS segment format for adaptive bitrate streaming is based on this field.
@@ -31439,7 +31454,11 @@ Note: The HLS segment format for adaptive bitrate streaming is based on this fie
31439
31454
  @property
31440
31455
  def StreamInfos(self):
31441
31456
  """Parameter information of input streams for transcoding to adaptive bitrate streaming. Up to 10 streams can be input.
31442
- Note: the frame rate of each stream must be consistent; otherwise, the frame rate of the first stream is used as the output frame rate.
31457
+
31458
+ Note:
31459
+
31460
+ 1. The frame rate of each stream must be consistent; otherwise, the frame rate of the first stream is used as the output frame rate.
31461
+ 2. When modifying substream information, all field values must be fully modified and added; otherwise, fields not filled in will use default values.
31443
31462
  :rtype: list of AdaptiveStreamTemplate
31444
31463
  """
31445
31464
  return self._StreamInfos
@@ -31461,15 +31480,18 @@ Note: the frame rate of each stream must be consistent; otherwise, the frame rat
31461
31480
 
31462
31481
  @property
31463
31482
  def PureAudio(self):
31464
- """Whether it is an audio-only template. 0: video template. 1: audio-only template.When the value is 1:
31483
+ """Indicates whether it is audio-only. 0 means video template, 1 means audio-only template.
31484
+ When the value is 1.
31465
31485
  1. StreamInfos.N.RemoveVideo=1
31466
31486
  2. StreamInfos.N.RemoveAudio=0
31467
31487
  3. StreamInfos.N.Video.Codec=copy
31468
-
31469
- When the value is 0:
31470
-
31488
+ When the value is 0.
31471
31489
  1. StreamInfos.N.Video.Codec cannot be copy.
31472
31490
  2. StreamInfos.N.Video.Fps cannot be null.
31491
+
31492
+ Note:
31493
+
31494
+ This value only distinguishes template types. The task uses the values of RemoveAudio and RemoveVideo.
31473
31495
  :rtype: int
31474
31496
  """
31475
31497
  return self._PureAudio
@@ -43945,38 +43967,35 @@ second: indicates second
43945
43967
  Default value: frame
43946
43968
  Note: This field may return null, indicating that no valid value can be obtained.
43947
43969
  :type GopUnit: str
43948
- :param _FillType: Filling mode. When the configured aspect ratio parameter for video streams differs from the aspect ratio of the original video, the processing method for transcoding is "filling". Optional filling modes:
43949
- <li>stretch: Each frame is stretched to fill the entire screen, which may cause the transcoded video to be "flattened" or "stretched".</li>
43950
- <li>black: The aspect ratio of the video is kept unchanged, and the rest of the edges is filled with black.</li>
43951
- <li>white: The aspect ratio of the video is kept unchanged, and the rest of the edges is filled with white.</li>
43952
- <li>gauss: The aspect ratio of the video is kept unchanged, and the rest of the edges is filled with a Gaussian blur.</li>
43970
+ :param _FillType: Padding method. When the video stream configuration width and height parameters are inconsistent with the aspect ratio of the original video, the transcoding processing method is "padding". Optional filling method:
43971
+ <li> stretch: Stretch. The screenshot will be stretched frame by frame to match the aspect ratio of the source video, which may make the screenshot "shorter" or "longer";</li>
43972
+ <li>black: Fill with black. This option retains the aspect ratio of the source video for the screenshot and fills the unmatched area with black color blocks.</li>
43973
+ <li>white: Fill with white. This option retains the aspect ratio of the source video for the screenshot and fills the unmatched area with white color blocks.</li>
43974
+ <li>gauss: applies Gaussian blur to the uncovered area, without changing the image's aspect ratio.</li>
43953
43975
 
43954
43976
  <li>smarttailor: Video images are smartly selected to ensure proportional image cropping.</li>
43955
43977
  Default value: black.
43956
- Note: Only stretch and black are supported for adaptive bitrate streaming.
43957
43978
  :type FillType: str
43958
- :param _Vcrf: Control factor for constant video bitrate. Value range: [0, 51].
43959
- If this parameter is specified, the bitrate control mode for the CRF will be used for transcoding (the video bitrate will no longer take effect).
43960
- It is recommended not to specify this parameter if there are no special requirements.
43961
-
43962
- Note:
43963
- If Mode is set to ABR, the Vcrf value does not need to be configured.
43964
- If Mode is set to CBR, the Vcrf value does not need to be configured.
43979
+ :param _Vcrf: Specifies the constant bitrate control factor for the video. Value range: [0, 51]. Leaving this parameter blank sets it to "Automatic". It is recommended not to specify this parameter unless necessary.
43980
+ If the Mode parameter is set to VBR and the Vcrf value is also configured, MPS will process the video in VBR mode, considering both Vcrf and Bitrate parameters to balance video quality, bitrate, transcoding efficiency, and file size.
43981
+ If the Mode parameter is set to CRF, the Bitrate setting will be invalid, and encoding will be based on the Vcrf value.
43982
+ If the Mode parameter is set to ABR or CBR, the Vcrf value does not need to be configured.
43965
43983
  Note: This field may return null, indicating that no valid value can be obtained.
43966
43984
  :type Vcrf: int
43967
- :param _HlsTime: Average segment duration. Value range: (0-10], unit: second
43968
- Default value: 10
43985
+ :param _HlsTime: Average segment duration. Value range: (0-10], unit: second.
43986
+ This parameter will be set to automatic if not specified. The segment duration will be automatically selected based on the GOP and other characteristics of the video.
43969
43987
  Note: It can be used only in the container format of hls.
43970
43988
  Note: This field may return null, indicating that no valid value can be obtained.
43971
43989
  :type HlsTime: int
43972
43990
  :param _SegmentType: HLS segment type. Valid values:
43973
- <li>0: HLS+TS segment.</li>
43974
- <li>2: HLS+TS byte range.</li>
43975
- <li>7: HLS+MP4 segment.</li>
43976
- <li>5: HLS+MP4 byte range.</li>
43991
+ <li>0: HLS+TS segment</li>
43992
+ <li>2: HLS+TS byte range</li>
43993
+ <li>7: HLS+MP4 segment</li>
43994
+ <li>5: HLS+MP4 byte range</li>
43977
43995
  Default value: 0
43978
43996
 
43979
- Note: This field may return null, indicating that no valid values can be obtained.
43997
+ Note: This field is used for normal/TSC transcoding settings and does not apply to adaptive bitrate streaming. To configure the segment type for adaptive bitrate streaming, use the outer field.
43998
+ Note: This field may return null, indicating that no valid value can be obtained.
43980
43999
  :type SegmentType: int
43981
44000
  :param _FpsDenominator: Denominator of the frame rate.
43982
44001
  Note: The value must be greater than 0.
@@ -44038,34 +44057,37 @@ Note: This field may return null, indicating that no valid value can be obtained
44038
44057
  Leaving this value blank means it is not enabled by default.
44039
44058
  Note: This field may return null, indicating that no valid value can be obtained.
44040
44059
  :type Compress: int
44041
- :param _SegmentSpecificInfo: Special segment configuration
44060
+ :param _SegmentSpecificInfo: Segment duration at startup.
44042
44061
  Note: This field may return null, indicating that no valid value can be obtained.
44043
44062
  :type SegmentSpecificInfo: :class:`tencentcloud.mps.v20190612.models.SegmentSpecificInfo`
44044
- :param _ScenarioBased: Whether to enable scenario-based settings for the template
44045
- 0: disable
44063
+ :param _ScenarioBased: Whether the template enables scenario-based settings.
44064
+ 0: disable.
44046
44065
  1: enable
44047
44066
 
44048
44067
  Default value: 0
44049
44068
 
44069
+ Note: The values of SceneType and CompressType fields only take effect when this field value is 1.
44050
44070
  Note: This field may return null, indicating that no valid value can be obtained.
44051
44071
  :type ScenarioBased: int
44052
- :param _SceneType: Video scenario. Optional values:
44072
+ :param _SceneType: Video scenario. Valid values:
44053
44073
  normal: General transcoding scenario: General transcoding and compression scenario.
44054
44074
  pgc: PGC HD TV shows and movies: At the time of compression, focus is placed on the viewing experience of TV shows and movies and ROI encoding is performed according to their characteristics, while high-quality contents of videos and audio are retained.
44055
44075
  materials_video: HD materials: Scenario involving material resources, where requirements for image quality are extremely high and there are many transparent images, with almost no visual loss during compression.
44056
44076
  ugc: UGC content: It is suitable for a wide range of UGC/short video scenarios, with an optimized encoding bitrate for short video characteristics, improved image quality, and enhanced business QOS/QOE metrics.
44057
44077
  e-commerce_video: Fashion show/e-commerce: At the time of compression, emphasis is placed on detail clarity and ROI enhancement, with a particular focus on maintaining the image quality of the face region.
44058
44078
  educational_video: Education: At the time of compression, emphasis is placed on the clarity and readability of text and images to help students better understand the content, ensuring that the teaching content is clearly conveyed.
44059
- Default value: normal
44079
+ Default value: normal.
44080
+ Note: To use this value, the value of ScenarioBased must be 1; otherwise, this value will not take effect.
44060
44081
  Note: This field may return null, indicating that no valid value can be obtained.
44061
44082
  :type SceneType: str
44062
- :param _CompressType: Transcoding policy. Optional values:
44083
+ :param _CompressType: Transcoding policy. Valid values:
44063
44084
  ultra_compress: Extreme compression: Compared to standard compression, this policy can maximize bitrate compression while ensuring a certain level of image quality, thus greatly saving bandwidth and storage costs.
44064
- standard_compress: Comprehensively optimal: The compression ratio and image quality are balanced, and files are compressed as much as possible without a noticeable reduction in subjective image quality. Only audio and video TSC transcoding fees are charged for this policy.
44065
- high_compress: Bitrate priority: Priority is given to reducing file size, which may result in certain image quality loss. Only audio and video TSC transcoding fees are charged for this policy.
44066
- low_compress: Image quality priority: Priority is given to ensuring image quality, and the size of compressed files may be relatively large. Only audio and video TSC transcoding fees are charged for this policy.
44067
- Default value: standard_compress
44068
- Note: If you need to watch videos on TV, it is recommended no to use the ultra_compress policy. The billing standard for the ultra_compress policy is TSC transcoding + audio and video enhancement - artifacts removal.
44085
+ standard_compress: Comprehensively optimal: Balances compression ratio and image quality, compressing files as much as possible without a noticeable reduction in subjective image quality. Only audio and video TSC transcoding fees are charged for this policy.
44086
+ high_compress: Bitrate priority: Prioritizes reducing file size, which may result in certain image quality loss. Only audio and video TSC transcoding fees are charged for this policy.
44087
+ low_compress: Image quality priority: Prioritizes ensuring image quality, and the size of compressed files may be relatively large. Only audio and video TSC transcoding fees are charged for this policy.
44088
+ Default value: standard_compress.
44089
+ Note: If you need to watch videos on TV, it is recommended not to use the ultra_compress policy. The billing standard for the ultra_compress policy is TSC transcoding + audio and video enhancement - artifacts removal.
44090
+ Note: To use this value, the value of ScenarioBased must be 1; otherwise, this value will not take effect.
44069
44091
  Note: This field may return null, indicating that no valid value can be obtained.
44070
44092
  :type CompressType: str
44071
44093
  """
@@ -44224,15 +44246,14 @@ Note: This field may return null, indicating that no valid value can be obtained
44224
44246
 
44225
44247
  @property
44226
44248
  def FillType(self):
44227
- """Filling mode. When the configured aspect ratio parameter for video streams differs from the aspect ratio of the original video, the processing method for transcoding is "filling". Optional filling modes:
44228
- <li>stretch: Each frame is stretched to fill the entire screen, which may cause the transcoded video to be "flattened" or "stretched".</li>
44229
- <li>black: The aspect ratio of the video is kept unchanged, and the rest of the edges is filled with black.</li>
44230
- <li>white: The aspect ratio of the video is kept unchanged, and the rest of the edges is filled with white.</li>
44231
- <li>gauss: The aspect ratio of the video is kept unchanged, and the rest of the edges is filled with a Gaussian blur.</li>
44249
+ """Padding method. When the video stream configuration width and height parameters are inconsistent with the aspect ratio of the original video, the transcoding processing method is "padding". Optional filling method:
44250
+ <li> stretch: Stretch. The screenshot will be stretched frame by frame to match the aspect ratio of the source video, which may make the screenshot "shorter" or "longer";</li>
44251
+ <li>black: Fill with black. This option retains the aspect ratio of the source video for the screenshot and fills the unmatched area with black color blocks.</li>
44252
+ <li>white: Fill with white. This option retains the aspect ratio of the source video for the screenshot and fills the unmatched area with white color blocks.</li>
44253
+ <li>gauss: applies Gaussian blur to the uncovered area, without changing the image's aspect ratio.</li>
44232
44254
 
44233
44255
  <li>smarttailor: Video images are smartly selected to ensure proportional image cropping.</li>
44234
44256
  Default value: black.
44235
- Note: Only stretch and black are supported for adaptive bitrate streaming.
44236
44257
  :rtype: str
44237
44258
  """
44238
44259
  return self._FillType
@@ -44243,13 +44264,10 @@ Note: Only stretch and black are supported for adaptive bitrate streaming.
44243
44264
 
44244
44265
  @property
44245
44266
  def Vcrf(self):
44246
- """Control factor for constant video bitrate. Value range: [0, 51].
44247
- If this parameter is specified, the bitrate control mode for the CRF will be used for transcoding (the video bitrate will no longer take effect).
44248
- It is recommended not to specify this parameter if there are no special requirements.
44249
-
44250
- Note:
44251
- If Mode is set to ABR, the Vcrf value does not need to be configured.
44252
- If Mode is set to CBR, the Vcrf value does not need to be configured.
44267
+ """Specifies the constant bitrate control factor for the video. Value range: [0, 51]. Leaving this parameter blank sets it to "Automatic". It is recommended not to specify this parameter unless necessary.
44268
+ If the Mode parameter is set to VBR and the Vcrf value is also configured, MPS will process the video in VBR mode, considering both Vcrf and Bitrate parameters to balance video quality, bitrate, transcoding efficiency, and file size.
44269
+ If the Mode parameter is set to CRF, the Bitrate setting will be invalid, and encoding will be based on the Vcrf value.
44270
+ If the Mode parameter is set to ABR or CBR, the Vcrf value does not need to be configured.
44253
44271
  Note: This field may return null, indicating that no valid value can be obtained.
44254
44272
  :rtype: int
44255
44273
  """
@@ -44261,8 +44279,8 @@ Note: This field may return null, indicating that no valid value can be obtained
44261
44279
 
44262
44280
  @property
44263
44281
  def HlsTime(self):
44264
- """Average segment duration. Value range: (0-10], unit: second
44265
- Default value: 10
44282
+ """Average segment duration. Value range: (0-10], unit: second.
44283
+ This parameter will be set to automatic if not specified. The segment duration will be automatically selected based on the GOP and other characteristics of the video.
44266
44284
  Note: It can be used only in the container format of hls.
44267
44285
  Note: This field may return null, indicating that no valid value can be obtained.
44268
44286
  :rtype: int
@@ -44276,13 +44294,14 @@ Note: This field may return null, indicating that no valid value can be obtained
44276
44294
  @property
44277
44295
  def SegmentType(self):
44278
44296
  """HLS segment type. Valid values:
44279
- <li>0: HLS+TS segment.</li>
44280
- <li>2: HLS+TS byte range.</li>
44281
- <li>7: HLS+MP4 segment.</li>
44282
- <li>5: HLS+MP4 byte range.</li>
44297
+ <li>0: HLS+TS segment</li>
44298
+ <li>2: HLS+TS byte range</li>
44299
+ <li>7: HLS+MP4 segment</li>
44300
+ <li>5: HLS+MP4 byte range</li>
44283
44301
  Default value: 0
44284
44302
 
44285
- Note: This field may return null, indicating that no valid values can be obtained.
44303
+ Note: This field is used for normal/TSC transcoding settings and does not apply to adaptive bitrate streaming. To configure the segment type for adaptive bitrate streaming, use the outer field.
44304
+ Note: This field may return null, indicating that no valid value can be obtained.
44286
44305
  :rtype: int
44287
44306
  """
44288
44307
  return self._SegmentType
@@ -44452,7 +44471,7 @@ Note: This field may return null, indicating that no valid value can be obtained
44452
44471
 
44453
44472
  @property
44454
44473
  def SegmentSpecificInfo(self):
44455
- """Special segment configuration
44474
+ """Segment duration at startup.
44456
44475
  Note: This field may return null, indicating that no valid value can be obtained.
44457
44476
  :rtype: :class:`tencentcloud.mps.v20190612.models.SegmentSpecificInfo`
44458
44477
  """
@@ -44464,12 +44483,13 @@ Note: This field may return null, indicating that no valid value can be obtained
44464
44483
 
44465
44484
  @property
44466
44485
  def ScenarioBased(self):
44467
- """Whether to enable scenario-based settings for the template
44468
- 0: disable
44486
+ """Whether the template enables scenario-based settings.
44487
+ 0: disable.
44469
44488
  1: enable
44470
44489
 
44471
44490
  Default value: 0
44472
44491
 
44492
+ Note: The values of SceneType and CompressType fields only take effect when this field value is 1.
44473
44493
  Note: This field may return null, indicating that no valid value can be obtained.
44474
44494
  :rtype: int
44475
44495
  """
@@ -44481,14 +44501,15 @@ Note: This field may return null, indicating that no valid value can be obtained
44481
44501
 
44482
44502
  @property
44483
44503
  def SceneType(self):
44484
- """Video scenario. Optional values:
44504
+ """Video scenario. Valid values:
44485
44505
  normal: General transcoding scenario: General transcoding and compression scenario.
44486
44506
  pgc: PGC HD TV shows and movies: At the time of compression, focus is placed on the viewing experience of TV shows and movies and ROI encoding is performed according to their characteristics, while high-quality contents of videos and audio are retained.
44487
44507
  materials_video: HD materials: Scenario involving material resources, where requirements for image quality are extremely high and there are many transparent images, with almost no visual loss during compression.
44488
44508
  ugc: UGC content: It is suitable for a wide range of UGC/short video scenarios, with an optimized encoding bitrate for short video characteristics, improved image quality, and enhanced business QOS/QOE metrics.
44489
44509
  e-commerce_video: Fashion show/e-commerce: At the time of compression, emphasis is placed on detail clarity and ROI enhancement, with a particular focus on maintaining the image quality of the face region.
44490
44510
  educational_video: Education: At the time of compression, emphasis is placed on the clarity and readability of text and images to help students better understand the content, ensuring that the teaching content is clearly conveyed.
44491
- Default value: normal
44511
+ Default value: normal.
44512
+ Note: To use this value, the value of ScenarioBased must be 1; otherwise, this value will not take effect.
44492
44513
  Note: This field may return null, indicating that no valid value can be obtained.
44493
44514
  :rtype: str
44494
44515
  """
@@ -44500,13 +44521,14 @@ Note: This field may return null, indicating that no valid value can be obtained
44500
44521
 
44501
44522
  @property
44502
44523
  def CompressType(self):
44503
- """Transcoding policy. Optional values:
44524
+ """Transcoding policy. Valid values:
44504
44525
  ultra_compress: Extreme compression: Compared to standard compression, this policy can maximize bitrate compression while ensuring a certain level of image quality, thus greatly saving bandwidth and storage costs.
44505
- standard_compress: Comprehensively optimal: The compression ratio and image quality are balanced, and files are compressed as much as possible without a noticeable reduction in subjective image quality. Only audio and video TSC transcoding fees are charged for this policy.
44506
- high_compress: Bitrate priority: Priority is given to reducing file size, which may result in certain image quality loss. Only audio and video TSC transcoding fees are charged for this policy.
44507
- low_compress: Image quality priority: Priority is given to ensuring image quality, and the size of compressed files may be relatively large. Only audio and video TSC transcoding fees are charged for this policy.
44508
- Default value: standard_compress
44509
- Note: If you need to watch videos on TV, it is recommended no to use the ultra_compress policy. The billing standard for the ultra_compress policy is TSC transcoding + audio and video enhancement - artifacts removal.
44526
+ standard_compress: Comprehensively optimal: Balances compression ratio and image quality, compressing files as much as possible without a noticeable reduction in subjective image quality. Only audio and video TSC transcoding fees are charged for this policy.
44527
+ high_compress: Bitrate priority: Prioritizes reducing file size, which may result in certain image quality loss. Only audio and video TSC transcoding fees are charged for this policy.
44528
+ low_compress: Image quality priority: Prioritizes ensuring image quality, and the size of compressed files may be relatively large. Only audio and video TSC transcoding fees are charged for this policy.
44529
+ Default value: standard_compress.
44530
+ Note: If you need to watch videos on TV, it is recommended not to use the ultra_compress policy. The billing standard for the ultra_compress policy is TSC transcoding + audio and video enhancement - artifacts removal.
44531
+ Note: To use this value, the value of ScenarioBased must be 1; otherwise, this value will not take effect.
44510
44532
  Note: This field may return null, indicating that no valid value can be obtained.
44511
44533
  :rtype: str
44512
44534
  """
@@ -44575,11 +44597,12 @@ class VideoTemplateInfoForUpdate(AbstractModel):
44575
44597
  <li>dnxhd: DNxHD encoding</li>
44576
44598
  <li>mv-hevc: MV-HEVC encoding</li>
44577
44599
 
44578
- Note: AV1 encoding containers currently only support mp4, webm, and mkv.
44579
- Note: H.266 encoding containers currently only support mp4, hls, ts, and mov.
44580
- Note: VP8 and VP9 encoding containers currently only support webm and mkv.
44581
- Note: MPEG2 and DNxHD encoding containers currently only support mxf.
44582
- Note: MV-HEVC encoding containers only support mp4, hls, and mov. Among them, the hls format only supports mp4 segmentation format.
44600
+ Note:
44601
+ AV1 encoding containers currently only support mp4, webm, and mkv.
44602
+ H.266 encoding containers currently only support mp4, hls, ts, and move.
44603
+ VP8 and VP9 encoding containers currently only support webm and mkv.
44604
+ MPEG2 and DNxHD encoding containers currently only support mxf.
44605
+ MV-HEVC encoding containers only support mp4, hls, and mov. Also, the hls format only supports mp4 segmentation format.
44583
44606
 
44584
44607
  Note: This field may return null, indicating that no valid value can be obtained.
44585
44608
  :type Codec: str
@@ -44613,26 +44636,23 @@ second: indicates second
44613
44636
  Default value: frame
44614
44637
  Note: This field may return null, indicating that no valid value can be obtained.
44615
44638
  :type GopUnit: str
44616
- :param _FillType: Filling mode. When the configured aspect ratio parameter for video streams differs from the aspect ratio of the original video, the processing method for transcoding is "filling". Optional filling modes:
44639
+ :param _FillType: Fill type. "Fill" refers to the way of processing a screenshot when its aspect ratio is different from that of the source video. Valid values:
44617
44640
  <li>stretch: Each frame is stretched to fill the entire screen, which may cause the transcoded video to be "flattened" or "stretched".</li>
44618
- <li>black: The aspect ratio of the video is kept unchanged, and the rest of the edges is filled with black.</li>
44641
+ <li>black: Keep the image's original aspect ratio and fill the blank space with black bars.</li>
44619
44642
  <li>white: The aspect ratio of the video is kept unchanged, and the rest of the edges is filled with white.</li>
44620
- <li>gauss: The aspect ratio of the video is kept unchanged, and the rest of the edges is filled with a Gaussian blur.</li>
44643
+ <li>gauss: applies Gaussian blur to the uncovered area, without changing the image's aspect ratio.</li>
44621
44644
 
44622
44645
  <li>smarttailor: Video images are smartly selected to ensure proportional image cropping.</li>
44623
44646
  Default value: black.
44624
44647
 
44625
- Note: Only stretch and black are supported for adaptive bitrate streaming.
44626
-
44627
44648
  Note: This field may return null, indicating that no valid value can be obtained.
44628
44649
  :type FillType: str
44629
- :param _Vcrf: Control factor for constant video bitrate. Value range: [0, 51] and 100.
44630
- It is recommended not to specify this parameter if there are no special requirements.
44650
+ :param _Vcrf: The control factor of video constant bitrate. Value range: [0, 51]. If not specified, it means "auto". It is recommended not to specify this parameter unless necessary.
44651
+ When the Mode parameter is set to VBR, if the Vcrf value is also configured, MPS will process the video in VBR mode, considering both Vcrf and Bitrate parameters to balance video quality, bitrate, transcoding efficiency, and file size.
44652
+ When the Mode parameter is set to CRF, the Bitrate setting will be invalid, and the encoding will be based on the Vcrf value.
44653
+ When the Mode parameter is set to ABR or CBR, the Vcrf value does not need to be configured.
44654
+ Note: When you need to set it to auto, fill in 100.
44631
44655
 
44632
- Note:
44633
- When you need to set it to auto, fill in 100.
44634
- If Mode is set to ABR, the Vcrf value does not need to be configured.
44635
- If Mode is set to CBR, the Vcrf value does not need to be configured.
44636
44656
  Note: This field may return null, indicating that no valid value can be obtained.
44637
44657
  :type Vcrf: int
44638
44658
  :param _ContentAdaptStream: Whether to enable adaptive encoding. Valid values:
@@ -44646,13 +44666,14 @@ Note: It is used only in the format of HLS.
44646
44666
  Note: This field may return null, indicating that no valid value can be obtained.
44647
44667
  :type HlsTime: int
44648
44668
  :param _SegmentType: HLS segment type. Valid values:
44649
- <li>0: HLS+TS segment.</li>
44650
- <li>2: HLS+TS byte range.</li>
44651
- <li>7: HLS+MP4 segment.</li>
44652
- <li>5: HLS+MP4 byte range.</li>
44669
+ <li>0: HLS+TS segment</li>
44670
+ <li>2: HLS+TS byte range</li>
44671
+ <li>7: HLS+MP4 segment</li>
44672
+ <li>5: HLS+MP4 byte range</li>
44653
44673
  Default value: 0
44654
44674
 
44655
- Note: This field may return null, indicating that no valid values can be obtained.
44675
+ Note: This field is used for normal/Top Speed Codec transcoding settings and does not apply to adaptive bitrate streaming. To configure the segment type for adaptive bitrate streaming, use the outer field.
44676
+ Note: This field may return null, indicating that no valid value can be obtained.
44656
44677
  :type SegmentType: int
44657
44678
  :param _FpsDenominator: Denominator of the frame rate.
44658
44679
  Note: The value must be greater than 0.
@@ -44716,34 +44737,36 @@ Note: This field may return null, indicating that no valid value can be obtained
44716
44737
  Note: -1 indicates auto.
44717
44738
  Note: This field may return null, indicating that no valid value can be obtained.
44718
44739
  :type Compress: int
44719
- :param _SegmentSpecificInfo: Special segment configuration
44740
+ :param _SegmentSpecificInfo: Segment duration at startup.
44720
44741
  Note: This field may return null, indicating that no valid value can be obtained.
44721
44742
  :type SegmentSpecificInfo: :class:`tencentcloud.mps.v20190612.models.SegmentSpecificInfo`
44722
- :param _ScenarioBased: Whether to enable scenario-based settings for the template
44723
- 0: disable
44743
+ :param _ScenarioBased: Indicates whether to enable scenario-based settings for the template.
44744
+ 0: Disable.
44724
44745
  1: enable
44725
44746
 
44726
44747
  Default value: 0
44727
44748
 
44749
+ Note: This value takes effect only when the value of this field is 1.
44728
44750
  Note: This field may return null, indicating that no valid value can be obtained.
44729
44751
  :type ScenarioBased: int
44730
- :param _SceneType: Video scenario. Optional values:
44731
- normal: General transcoding scenario: General transcoding and compression scenario
44732
- pgc: PGC HD TV shows and movies: At the time of compression, focus is placed on the viewing experience of TV shows and movies and ROI encoding is performed according to their characteristics, while high-quality contents of videos and audio are retained.
44752
+ :param _SceneType: Video scenario. Valid values:
44753
+ normal: General transcoding scenario: General transcoding and compression scenario. pgc: PGC HD film and television: Emphasis is placed on the viewing experience of films and TV shows during compression, with ROI encoding based on the characteristics of films and TV shows, while maintaining high-quality video and audio content.
44733
44754
  materials_video: HD materials: Scenario involving material resources, where requirements for image quality are extremely high and there are many transparent images, with almost no visual loss during compression.
44734
44755
  ugc: UGC content: It is suitable for a wide range of UGC/short video scenarios, with an optimized encoding bitrate for short video characteristics, improved image quality, and enhanced business QOS/QOE metrics.
44735
44756
  e-commerce_video: Fashion show/e-commerce: At the time of compression, emphasis is placed on detail clarity and ROI enhancement, with a particular focus on maintaining the image quality of the face region.
44736
44757
  educational_video: Education: At the time of compression, emphasis is placed on the clarity and readability of text and images to help students better understand the content, ensuring that the teaching content is clearly conveyed.
44737
- Default value: normal
44758
+ Default value: normal.
44759
+ Note: To use this value, the value of ScenarioBased must be 1; otherwise, this value will not take effect.
44738
44760
  Note: This field may return null, indicating that no valid value can be obtained.
44739
44761
  :type SceneType: str
44740
- :param _CompressType: Transcoding policy. Optional values:
44762
+ :param _CompressType: Transcoding policy. Valid values:
44741
44763
  ultra_compress: Extreme compression: Compared to standard compression, this policy can maximize bitrate compression while ensuring a certain level of image quality, thus greatly saving bandwidth and storage costs.
44742
- standard_compress: Comprehensively optimal: The compression ratio and image quality are balanced, and files are compressed as much as possible without a noticeable reduction in subjective image quality. Only audio and video TSC transcoding fees are charged for this policy.
44743
- high_compress: Bitrate priority: Priority is given to reducing file size, which may result in certain image quality loss. Only audio and video TSC transcoding fees are charged for this policy.
44744
- low_compress: Image quality priority: Priority is given to ensuring image quality, and the size of compressed files may be relatively large. Only audio and video TSC transcoding fees are charged for this policy.
44745
- Default value: standard_compress
44746
- Note: If you need to watch videos on TV, it is recommended no to use the ultra_compress policy. The billing standard for the ultra_compress policy is TSC transcoding + audio and video enhancement - artifacts removal.
44764
+ standard_compress: Comprehensively optimal: Balances compression ratio and image quality, compressing files as much as possible without a noticeable reduction in subjective image quality. This policy only charges audio and video TSC transcoding fees.
44765
+ high_compress: Bitrate priority: Prioritizes reducing file size, which may result in some image quality loss. This policy only charges audio and video TSC transcoding fees.
44766
+ low_compress: Image quality priority: Prioritizes ensuring image quality, and the size of compressed files may be relatively large. This policy only charges audio and video TSC transcoding fees.
44767
+ Default value: standard_compress.
44768
+ Note: If you need to watch videos on TV, it is recommended not to use the ultra_compress policy. The billing standard for the ultra_compress policy is TSC transcoding + audio and video enhancement - artifacts removal.
44769
+ Note: To use this value, the value of ScenarioBased must be 1; otherwise, this value will not take effect.
44747
44770
  Note: This field may return null, indicating that no valid value can be obtained.
44748
44771
  :type CompressType: str
44749
44772
  """
@@ -44789,11 +44812,12 @@ Note: This field may return null, indicating that no valid value can be obtained
44789
44812
  <li>dnxhd: DNxHD encoding</li>
44790
44813
  <li>mv-hevc: MV-HEVC encoding</li>
44791
44814
 
44792
- Note: AV1 encoding containers currently only support mp4, webm, and mkv.
44793
- Note: H.266 encoding containers currently only support mp4, hls, ts, and mov.
44794
- Note: VP8 and VP9 encoding containers currently only support webm and mkv.
44795
- Note: MPEG2 and DNxHD encoding containers currently only support mxf.
44796
- Note: MV-HEVC encoding containers only support mp4, hls, and mov. Among them, the hls format only supports mp4 segmentation format.
44815
+ Note:
44816
+ AV1 encoding containers currently only support mp4, webm, and mkv.
44817
+ H.266 encoding containers currently only support mp4, hls, ts, and move.
44818
+ VP8 and VP9 encoding containers currently only support webm and mkv.
44819
+ MPEG2 and DNxHD encoding containers currently only support mxf.
44820
+ MV-HEVC encoding containers only support mp4, hls, and mov. Also, the hls format only supports mp4 segmentation format.
44797
44821
 
44798
44822
  Note: This field may return null, indicating that no valid value can be obtained.
44799
44823
  :rtype: str
@@ -44899,17 +44923,15 @@ Note: This field may return null, indicating that no valid value can be obtained
44899
44923
 
44900
44924
  @property
44901
44925
  def FillType(self):
44902
- """Filling mode. When the configured aspect ratio parameter for video streams differs from the aspect ratio of the original video, the processing method for transcoding is "filling". Optional filling modes:
44926
+ """Fill type. "Fill" refers to the way of processing a screenshot when its aspect ratio is different from that of the source video. Valid values:
44903
44927
  <li>stretch: Each frame is stretched to fill the entire screen, which may cause the transcoded video to be "flattened" or "stretched".</li>
44904
- <li>black: The aspect ratio of the video is kept unchanged, and the rest of the edges is filled with black.</li>
44928
+ <li>black: Keep the image's original aspect ratio and fill the blank space with black bars.</li>
44905
44929
  <li>white: The aspect ratio of the video is kept unchanged, and the rest of the edges is filled with white.</li>
44906
- <li>gauss: The aspect ratio of the video is kept unchanged, and the rest of the edges is filled with a Gaussian blur.</li>
44930
+ <li>gauss: applies Gaussian blur to the uncovered area, without changing the image's aspect ratio.</li>
44907
44931
 
44908
44932
  <li>smarttailor: Video images are smartly selected to ensure proportional image cropping.</li>
44909
44933
  Default value: black.
44910
44934
 
44911
- Note: Only stretch and black are supported for adaptive bitrate streaming.
44912
-
44913
44935
  Note: This field may return null, indicating that no valid value can be obtained.
44914
44936
  :rtype: str
44915
44937
  """
@@ -44921,13 +44943,12 @@ Note: This field may return null, indicating that no valid value can be obtained
44921
44943
 
44922
44944
  @property
44923
44945
  def Vcrf(self):
44924
- """Control factor for constant video bitrate. Value range: [0, 51] and 100.
44925
- It is recommended not to specify this parameter if there are no special requirements.
44946
+ """The control factor of video constant bitrate. Value range: [0, 51]. If not specified, it means "auto". It is recommended not to specify this parameter unless necessary.
44947
+ When the Mode parameter is set to VBR, if the Vcrf value is also configured, MPS will process the video in VBR mode, considering both Vcrf and Bitrate parameters to balance video quality, bitrate, transcoding efficiency, and file size.
44948
+ When the Mode parameter is set to CRF, the Bitrate setting will be invalid, and the encoding will be based on the Vcrf value.
44949
+ When the Mode parameter is set to ABR or CBR, the Vcrf value does not need to be configured.
44950
+ Note: When you need to set it to auto, fill in 100.
44926
44951
 
44927
- Note:
44928
- When you need to set it to auto, fill in 100.
44929
- If Mode is set to ABR, the Vcrf value does not need to be configured.
44930
- If Mode is set to CBR, the Vcrf value does not need to be configured.
44931
44952
  Note: This field may return null, indicating that no valid value can be obtained.
44932
44953
  :rtype: int
44933
44954
  """
@@ -44968,13 +44989,14 @@ Note: This field may return null, indicating that no valid value can be obtained
44968
44989
  @property
44969
44990
  def SegmentType(self):
44970
44991
  """HLS segment type. Valid values:
44971
- <li>0: HLS+TS segment.</li>
44972
- <li>2: HLS+TS byte range.</li>
44973
- <li>7: HLS+MP4 segment.</li>
44974
- <li>5: HLS+MP4 byte range.</li>
44992
+ <li>0: HLS+TS segment</li>
44993
+ <li>2: HLS+TS byte range</li>
44994
+ <li>7: HLS+MP4 segment</li>
44995
+ <li>5: HLS+MP4 byte range</li>
44975
44996
  Default value: 0
44976
44997
 
44977
- Note: This field may return null, indicating that no valid values can be obtained.
44998
+ Note: This field is used for normal/Top Speed Codec transcoding settings and does not apply to adaptive bitrate streaming. To configure the segment type for adaptive bitrate streaming, use the outer field.
44999
+ Note: This field may return null, indicating that no valid value can be obtained.
44978
45000
  :rtype: int
44979
45001
  """
44980
45002
  return self._SegmentType
@@ -45146,7 +45168,7 @@ Note: This field may return null, indicating that no valid value can be obtained
45146
45168
 
45147
45169
  @property
45148
45170
  def SegmentSpecificInfo(self):
45149
- """Special segment configuration
45171
+ """Segment duration at startup.
45150
45172
  Note: This field may return null, indicating that no valid value can be obtained.
45151
45173
  :rtype: :class:`tencentcloud.mps.v20190612.models.SegmentSpecificInfo`
45152
45174
  """
@@ -45158,12 +45180,13 @@ Note: This field may return null, indicating that no valid value can be obtained
45158
45180
 
45159
45181
  @property
45160
45182
  def ScenarioBased(self):
45161
- """Whether to enable scenario-based settings for the template
45162
- 0: disable
45183
+ """Indicates whether to enable scenario-based settings for the template.
45184
+ 0: Disable.
45163
45185
  1: enable
45164
45186
 
45165
45187
  Default value: 0
45166
45188
 
45189
+ Note: This value takes effect only when the value of this field is 1.
45167
45190
  Note: This field may return null, indicating that no valid value can be obtained.
45168
45191
  :rtype: int
45169
45192
  """
@@ -45175,14 +45198,14 @@ Note: This field may return null, indicating that no valid value can be obtained
45175
45198
 
45176
45199
  @property
45177
45200
  def SceneType(self):
45178
- """Video scenario. Optional values:
45179
- normal: General transcoding scenario: General transcoding and compression scenario
45180
- pgc: PGC HD TV shows and movies: At the time of compression, focus is placed on the viewing experience of TV shows and movies and ROI encoding is performed according to their characteristics, while high-quality contents of videos and audio are retained.
45201
+ """Video scenario. Valid values:
45202
+ normal: General transcoding scenario: General transcoding and compression scenario. pgc: PGC HD film and television: Emphasis is placed on the viewing experience of films and TV shows during compression, with ROI encoding based on the characteristics of films and TV shows, while maintaining high-quality video and audio content.
45181
45203
  materials_video: HD materials: Scenario involving material resources, where requirements for image quality are extremely high and there are many transparent images, with almost no visual loss during compression.
45182
45204
  ugc: UGC content: It is suitable for a wide range of UGC/short video scenarios, with an optimized encoding bitrate for short video characteristics, improved image quality, and enhanced business QOS/QOE metrics.
45183
45205
  e-commerce_video: Fashion show/e-commerce: At the time of compression, emphasis is placed on detail clarity and ROI enhancement, with a particular focus on maintaining the image quality of the face region.
45184
45206
  educational_video: Education: At the time of compression, emphasis is placed on the clarity and readability of text and images to help students better understand the content, ensuring that the teaching content is clearly conveyed.
45185
- Default value: normal
45207
+ Default value: normal.
45208
+ Note: To use this value, the value of ScenarioBased must be 1; otherwise, this value will not take effect.
45186
45209
  Note: This field may return null, indicating that no valid value can be obtained.
45187
45210
  :rtype: str
45188
45211
  """
@@ -45194,13 +45217,14 @@ Note: This field may return null, indicating that no valid value can be obtained
45194
45217
 
45195
45218
  @property
45196
45219
  def CompressType(self):
45197
- """Transcoding policy. Optional values:
45220
+ """Transcoding policy. Valid values:
45198
45221
  ultra_compress: Extreme compression: Compared to standard compression, this policy can maximize bitrate compression while ensuring a certain level of image quality, thus greatly saving bandwidth and storage costs.
45199
- standard_compress: Comprehensively optimal: The compression ratio and image quality are balanced, and files are compressed as much as possible without a noticeable reduction in subjective image quality. Only audio and video TSC transcoding fees are charged for this policy.
45200
- high_compress: Bitrate priority: Priority is given to reducing file size, which may result in certain image quality loss. Only audio and video TSC transcoding fees are charged for this policy.
45201
- low_compress: Image quality priority: Priority is given to ensuring image quality, and the size of compressed files may be relatively large. Only audio and video TSC transcoding fees are charged for this policy.
45202
- Default value: standard_compress
45203
- Note: If you need to watch videos on TV, it is recommended no to use the ultra_compress policy. The billing standard for the ultra_compress policy is TSC transcoding + audio and video enhancement - artifacts removal.
45222
+ standard_compress: Comprehensively optimal: Balances compression ratio and image quality, compressing files as much as possible without a noticeable reduction in subjective image quality. This policy only charges audio and video TSC transcoding fees.
45223
+ high_compress: Bitrate priority: Prioritizes reducing file size, which may result in some image quality loss. This policy only charges audio and video TSC transcoding fees.
45224
+ low_compress: Image quality priority: Prioritizes ensuring image quality, and the size of compressed files may be relatively large. This policy only charges audio and video TSC transcoding fees.
45225
+ Default value: standard_compress.
45226
+ Note: If you need to watch videos on TV, it is recommended not to use the ultra_compress policy. The billing standard for the ultra_compress policy is TSC transcoding + audio and video enhancement - artifacts removal.
45227
+ Note: To use this value, the value of ScenarioBased must be 1; otherwise, this value will not take effect.
45204
45228
  Note: This field may return null, indicating that no valid value can be obtained.
45205
45229
  :rtype: str
45206
45230
  """