History
Introduction
API Category
Making API Requests
Region APIs
Instance APIs
Cloud Hosting Cluster APIs
Image APIs
Instance Launch Template APIs
Placement Group APIs
Key APIs
Security Group APIs
Network APIs
Data Types
Error Codes
POST /template HTTP/1.1Host: <BucketName-APPID>.ci.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>Content-Length: <length>Content-Type: application/xml<body>
<Request><Tag>TranscodePro</Tag><Name>TemplateName</Name><Container><Format>mxf</Format></Container><Video><Codec>xavc</Codec><Profile>XAVC-HD_422_10bit</Profile><Width>1920</Width><Height>1080</Height><Interlaced>true</Interlaced><Fps>30000/1001</Fps><Bitrate>50000</Bitrate></Video><Audio><Codec>pcm_s24le</Codec></Audio><TransConfig><AdjDarMethod>scale</AdjDarMethod><IsCheckReso>false</IsCheckReso><ResoAdjMethod>1</ResoAdjMethod></TransConfig><TimeInterval><Start>0</Start><Duration>60</Duration></TimeInterval></Request>
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 |
Request | 无 | 保存请求的容器 | Container | 是 |
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 |
Tag | Request | 模板类型:TranscodePro | String | 是 |
Name | Request | 模板名称 仅支持中文、英文、数字、_、-和* ,长度不超过64 | String | 是 |
Container | Request | 容器格式 | Container | 是 |
Video | Request | 视频信息 | Container | 是 |
TimeInterval | Request | 时间区间 | Container | 否 |
Audio | Request | 音频信息,不传 Audio,相当于删除音频信息 | Container | 否 |
TransConfig | Request | 转码配置 | Container | 否 |
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 |
Format | Request.Container | 封装格式:有效值为 mxf、mov、mkv | String | 是 |
Container | Audio Codecs | Video Codecs |
mxf | pcm_s24le | xavc |
mov、mkv | aac、mp3 | apple_prores |
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 | 默认值 |
Codec | Request.Video | 编解码格式,支持 xavc、apple_prores | String | 是 | 无 |
Profile | Request.Video | 视频算法器预置,取值范围见下表 | String | 是 | 无 |
Width | Request.Video | 宽,取值范围见下表 | String | 是 | 无 |
Height | Request.Video | 高,取值范围见下表 | String | 是 | 无 |
Interlaced | Request.Video | 场模式,取值范围见下表 | String | 是 | 无 |
Fps | Request.Video | 帧率,取值范围见下表 | String | 是 | 无 |
Bitrate | Request.Video | 视频输出文件的码率,取值范围见下表 | String | 否 | 无 |
Rotate | Request.Video | 旋转角度 值范围:[0, 360) 单位:度 | String | 否 | 无 |
Profile | Width | Height | Interlaced | Fps | Bitrate(单位:kbps) |
XAVC-HD_intra_420_10bit_class50 | 1440 | 1080 | true | 1、25 2、30000/1001 | - |
XAVC-HD_intra_420_10bit_class50 | 1440 | 1080 | false | 1、25 2、24000/1001 3、30000/1001 | - |
XAVC-HD_intra_422_10bit_class100 | 1280 | 720 | false | 1、50 2、60000/1001 | - |
XAVC-HD_intra_422_10bit_class100 | 1920 | 1080 | true | 1、25 2、30000/1001 | - |
XAVC-HD_intra_422_10bit_class100 | 1920 | 1080 | false | 1、25 2、50 3、24000/1001 4、30000/1001 5、60000/1001 | - |
XAVC-HD_intra_422_10bit_class200 | 1920 | 1080 | true | 1、25 2、30000/1001 | - |
XAVC-HD_intra_422_10bit_class200 | 1920 | 1080 | false | 1、25 2、50 3、24000/1001 4、30000/1001 5、60000/1001 | - |
XAVC-4K_intra_422_10bit_class100 | 2048 | 1080 | false | 1、25 2、50 3、24000/1001 4、30000/1001 5、60000/1001 | - |
XAVC-4K_intra_422_10bit_class300 | 3840 | 2160 | false | 1、25 2、50 3、24000/1001 4、30000/1001 5、60000/1001 | - |
XAVC-4K_intra_422_10bit_class300 | 4096 | 2160 | false | 1、25 2、50 3、24000/1001 4、30000/1001 5、60000/1001 | - |
XAVC-4K_intra_422_10bit_class480 | 3840 | 2160 | false | 1、25 2、50 3、24000/1001 4、30000/1001 5、60000/1001 | - |
XAVC-4K_intra_422_10bit_class480 | 4096 | 2160 | false | 1、25 2、50 3、24000/1001 4、30000/1001 5、60000/1001 | - |
XAVC-4K_intra_422_10bit | 2048 | 1080 | false | 1、25 2、50 3、24000/1001 4、30000/1001 5、60000/1001 | 1、93000 2、185000 3、89000 4、111000 5、222000 |
XAVC-4K_intra_422_10bit | 3840 | 2160 | false | 1、25 2、50 3、24000/1001 4、30000/1001 5、60000/1001 | 1、250000或400000 2、500000或800000 3、240000或384000 4、300000或480000 5、600000或960000 |
XAVC-4K_intra_422_10bit | 4096 | 2160 | false | 1、25 2、50 3、24000/1001 4、30000/1001 5、60000/1001 | 1、250000或400000 2、500000或800000 3、240000或384000 4、300000或480000 5、600000或960000 |
XAVC-HD_422_10bit | 1280 | 720 | false | 1、50 2、60000/1001 | 1、50000 2、50000 |
XAVC-HD_422_10bit | 1920 | 1080 | true | 1、25 2、30000/1001 | 1、25000或35000或50000 2、25000或35000或50000 |
XAVC-HD_422_10bit | 1920 | 1080 | false | 1、25 2、50 3、24000/1001 4、30000/1001 5、60000/1001 | 1、25000或35000或50000 2、35000或50000 3、25000或35000或50000 4、25000或35000或50000 5、35000或50000 |
XAVC-4K_422_10bit | 3840 | 2160 | false | 1、25 2、50 3、24000/1001 4、30000/1001 5、60000/1001 | 1、100000或140000或200000 2、140000或200000 3、100000或140000或200000 4、100000或140000或200000 5、140000或200000 |
XAVC-4K_420_8bit | 3840 | 2160 | false | 1、25 2、50 3、24000/1001 4、30000/1001 5、60000/1001 | 1、188000 2、300000 3、188000 4、188000 5、300000 |
Profile |
1.ProRes_422_Proxy 2.ProRes_422_LT 3.ProRes_422 4.ProRes_422_HQ 5.ProRes_4444 6.ProRes_4444_XQ 7.ProRes_4444_alpha 8.ProRes_4444_XQ_alpha |
Width | Height | Interlaced | Fps | Bitrate(单位:kbps) |
720 | 486 | false | 1、24000/1001 2、30000/1001 | 取值范围:[2000,3000000] |
720 | 486 | true | 1、60000/1001 | 取值范围:[2000,3000000] |
720 | 576 | false | 1、25 | 取值范围:[2000,3000000] |
720 | 576 | true | 1、50 | 取值范围:[2000,3000000] |
960 | 720 | false | 1、25 2、50 3、24000/1001 4、30000/1001 5、60000/1001 | 取值范围:[2000,3000000] |
1280 | 720 | false | 1、25 2、50 3、24000/1001 4、30000/1001 5、60000/1001 | 取值范围:[2000,3000000] |
1280 | 1080 | false | 1、24000/1001 2、30000/1001 | 取值范围:[2000,3000000] |
1280 | 1080 | true | 1、60000/1001 | 取值范围:[2000,3000000] |
1440 | 1080 | false | 1、24000/1001 2、25 3、30000/1001 | 取值范围:[2000,3000000] |
1440 | 1080 | true | 1、50 2、60000/1001 | 取值范围:[2000,3000000] |
1920 | 1080 | false | 1、25 2、50 3、24000/1001 4、30000/1001 5、60000/1001 | 取值范围:[2000,3000000] |
1920 | 1080 | true | 1、50 2、60000/1001 | 取值范围:[2000,3000000] |
2048 | 1080 | false | 1、25 2、50 3、24000/1001 4、30000/1001 5、60000/1001 | 取值范围:[2000,3000000] |
2048 | 1556 | false | 1、25
2、50
3、24000/1001
4、30000/1001
5、60000/1001 | 取值范围:[2000,3000000] |
3840 | 2160 | false | 1、25
2、50
3、24000/1001
4、30000/1001
5、60000/1001 | 取值范围:[2000,3000000] |
4096 | 2160 | false | 1、25
2、50
3、24000/1001
4、30000/1001
5、60000/1001 | 取值范围:[2000,3000000] |
5120 | 2700 | false | 1、25
2、50
3、24000/1001
4、30000/1001
5、60000/1001 | 取值范围:[2000,3000000] |
6144 | 3240 | false | 1、25
2、50
3、24000/1001
4、30000/1001
5、60000/1001 | 取值范围:[2000,3000000] |
8192 | 4320 | false | 1、25
2、50
3、24000/1001
4、30000/1001
5、60000/1001 |
取值范围:[2000,3000000] |
节点名称(关键字) | 父节点 | 描述 | 类型 | 默认值 | 是否必选 |
Start | Request.TimeInterval | 开始时间 [0, 视频时长] 单位为秒 支持 float 格式,执行精度精确到毫秒 | String | 0 | 否 |
Duration | Request.TimeInterval | 持续时间 [0, 视频时长] 单位为秒 支持 float 格式,执行精度精确到毫秒 | String | 视频原始时长 | 否 |
节点名称(关键字) | 父节点 | 描述 | 类型 | 默认值 | 是否必选 |
Codec | Request.Audio | 编解码格式,pcm_s24le、aac、mp3 | String | 无 | 是 |
Remove | Request.Audio | 是否删除源音频流,取值 true、false | String | false | 否 |
节点名称(关键字) | 父节点 | 描述 | 类型 | 默认值 | 是否必选 |
AdjDarMethod | Request.TransConfig | 分辨率调整方式 取值 scale、crop、pad、none 当输出视频的宽高比与原视频不等时,根据此参数做分辨率的相应调整 | String | none | 否 |
IsCheckReso | Request.TransConfig | 是否检查分辨率,取值 true、false 当为 false 时,按照配置参数转码 | String | false | 否 |
ResoAdjMethod | Request.TransConfig | 分辨率调整方式 当 IsCheckReso 为 true 时生效,取值0、1; 0 表示使用原视频分辨率; 1 表示返回转码失败 | String | 0 | 否 |
IsCheckVideoBitrate | Request.TransConfig | 是否检查视频码率,取值 true、false 当为 false 时,按照配置参数转码 | String | false | 否 |
VideoBitrateAdjMethod | Request.TransConfig | 视频码率调整方式 IsCheckVideoBitrate 为 true 时生效,取值0、1; 当输出视频码率大于原视频码率时,0表示使用原视频码率;1表示返回转码失败 | String | 0 | 否 |
IsCheckAudioBitrate | Request.TransConfig | 是否检查音频码率,取值 true、false 当为 false 时,按照配置参数转码 | String | false | 否 |
AudioBitrateAdjMethod | Request.TransConfig | 音频码率调整方式 IsCheckAudioBitrate 为 true 时生效,取值0、1; 当输出音频码率大于原音频码率时,0表示使用原音频码率;1表示返回转码失败 | String | 0 | 否 |
IsCheckVideoFps | Request.TransConfig | 是否检查视频帧率,取值 true、false 当为 false 时,按照配置参数转码 | String | false | 否 |
VideoFpsAdjMethod | Request.TransConfig | 视频帧率调整方式 IsCheckVideoFps 为 true 时生效,取值0、1; 当输出视频帧率大于原视频帧率时,0表示使用原视频帧率;1表示返回转码失败 | String | 0 | 否 |
DeleteMetadata | Request.TransConfig | 是否删除文件中的 MetaData 信息,取值 true、false | String | false | 否 |
IsHdr2Sdr | Request.TransConfig | 是否开启 HDR 转 SDR,取值 true、false | String | false | 否 |

<Response><Template><Tag>TranscodePro</Tag><TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId><Name>TemplateName</Name><BucketId>test-1234567890</BucketId><Category>Custom</Category><TransProTpl><Container><Format>mxf</Format></Container><Video><Codec>xavc</Codec><Profile>XAVC-HD_422_10bit</Profile><Width>1920</Width><Height>1080</Height><Interlaced>true</Interlaced><Fps>30000/1001</Fps><Bitrate>50000</Bitrate></Video><Audio><Codec>pcm_s24le</Codec></Audio><TransConfig><AdjDarMethod>scale</AdjDarMethod><IsCheckReso>false</IsCheckReso><ResoAdjMethod>1</ResoAdjMethod></TransConfig><TimeInterval><Start>0</Start><Duration>60</Duration></TimeInterval></TransProTpl><CreateTime>2020-08-05T11:35:24+0800</CreateTime><UpdateTime>2020-08-31T16:15:20+0800</UpdateTime></Template></Response>
节点名称(关键字) | 父节点 | 描述 | 类型 |
Response | 无 | 保存结果的容器 | Container |
节点名称(关键字) | 父节点 | 描述 | 类型 |
TemplateId | Response.Template | 模板 ID | String |
Name | Response.Template | 模板名称 | String |
BucketId | Response.Template | 模板所属存储桶 | String |
Category | Response.Template | 模板属性,Custom 或者 Official | String |
Tag | Response.Template | 模板类型,TranscodePro | String |
UpdateTime | Response.Template | 更新时间 | String |
CreateTime | Response.Template | 创建时间 | String |
TransProTpl | Response.Template | 详细的模板参数 | Container |
节点名称(关键字) | 父节点 | 描述 | 类型 |
TimeInterval | Response.Template.TransProTpl | Container | |
Container | Response.Template.TransProTpl | Container | |
Video | Response.Template.TransProTpl | Container | |
Audio | Response.Template.TransProTpl | Container | |
TransConfig | Response.Template.TransProTpl | Container |
POST /template HTTP/1.1Authorization: q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signatrue=****************************************Host: test-1234567890.ci.ap-beijing.myqcloud.comContent-Length: 1666Content-Type: application/xml<Request><Tag>TranscodePro</Tag><Name>TemplateName</Name><Container><Format>mxf</Format></Container><Video><Codec>xavc</Codec><Profile>XAVC-HD_422_10bit</Profile><Width>1920</Width><Height>1080</Height><Interlaced>true</Interlaced><Fps>30000/1001</Fps><Bitrate>50000</Bitrate></Video><Audio><Codec>pcm_s24le</Codec></Audio><TransConfig><AdjDarMethod>scale</AdjDarMethod><IsCheckReso>false</IsCheckReso><ResoAdjMethod>1</ResoAdjMethod></TransConfig><TimeInterval><Start>0</Start><Duration>60</Duration></TimeInterval></Request>
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 100Connection: keep-aliveDate: Thu, 14 Jul 2022 12:37:29 GMTServer: tencent-cix-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****<Response><Template><Tag>TranscodePro</Tag><TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId><Name>TemplateName</Name><BucketId>test-1234567890</BucketId><Category>Custom</Category><TransProTpl><Container><Format>mxf</Format></Container><Video><Codec>xavc</Codec><Profile>XAVC-HD_422_10bit</Profile><Width>1920</Width><Height>1080</Height><Interlaced>true</Interlaced><Fps>30000/1001</Fps><Bitrate>50000</Bitrate></Video><Audio><Codec>pcm_s24le</Codec></Audio><TransConfig><AdjDarMethod>scale</AdjDarMethod><IsCheckReso>false</IsCheckReso><ResoAdjMethod>1</ResoAdjMethod></TransConfig><TimeInterval><Start>0</Start><Duration>60</Duration></TimeInterval></TransProTpl><CreateTime>2020-08-05T11:35:24+0800</CreateTime><UpdateTime>2020-08-31T16:15:20+0800</UpdateTime></Template></Response>
文档反馈