You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

复制全文
下载 pdf
视频转码
ListVideoConvertTemplates
复制全文
下载 pdf
ListVideoConvertTemplates
功能说明​
此接口用于查询视频转码模板。​
注意事项​
通过子账号使用时,需要授予当前桶的 GetDataProcessTemplate 权限。​
请求消息样式​
​
GET /?process_template&tag=Transcode&id={} HTTP/1.1​
Host: {BucketName}.tos-cn-beijing.volces.com​
Date: Fri, 30 Jul 2021 08:05:36 +0000​
Authorization: authorization string​
​
请求参数与消息头​
​
参数名称​
参数类型​
是否必填​
示例值​
说明​
Tag​
String​
是​
Transcode​
视频转码模板标识。​
Name​
String​
是​
​
name​
自定义模板名称:​
  • 仅支持 a-z、A-Z、0-9、_、-和 .,长度不超过 64,开头和结尾字符必须是 a-z、A-Z、0-9。​
  • 多条规则不能重复。​
ID​
String​
否​
343339383230623339346119012d08292633​
音视频任务 ID。若未指定 ID,将列举所有音视频任务。​
​
请求元素​
该请求不使用消息元素。​
响应消息头​
该请求返回的公共响应消息头,请参见公共参数。​
响应元素​
​
参数名称​
参数类型​
是否必填​
示例值​
说明​
Tag​
String​
是​
Transcode​
视频转码模板标识。​
Name​
String​
是​
​
transcode-template-1​
自定义模板名称:​
  • 仅支持 a-z、A-Z、0-9、_、-和 .,长度不超过 64,开头和结尾字符必须是 a-z、A-Z、0-9。​
  • 多条规则不能重复。​
ID​
String​
否​
343339383230623339346119012d08292633​
音视频任务 ID。若未指定 ID,将列举所有音视频任务。​
TranscodeConfig​
-​
是​
-​
音视频转码模板详情信息。​
Transcode​
-​
是​
-​
音视频转码模板详情信息。​
父节点:TranscodeConfig​
TimeInterval​
-​
否​
-​
指定转码时长。​
父节点:Transcode​
Start​
Integer​
否​
0​
开始时间,单位毫秒,默认值 0。​
父节点:TimeInterval​
Duration​
Integer​
否​
100000​
持续时间,单位毫秒,默认值 0 表示视频时长​
父节点:TimeInterval​
Container​
-​
是​
-​
指定转码容器格式。​
父节点:Transcode​
Format​
String​
​
是​
​
mp4​
视频文件封装格式,取值列表如下:​
  • mp4​
  • ts​
  • hls​
  • flv​
  • mp3​
  • aac​
  • flac​
  • m4a​
  • oga​
  • wav​
  • ac3​
  • opus​
  • pcm​
父节点:Container​
ClipConfig​
String​
否​
-​
分片配置,指定 hls 转码分片时长。​
父节点:Container​
Duration​
Integer​
否​
0​
hls 转码的分片时长,单位毫秒,默认值 5000,合法取值范围为 (0, 3600000)。​
父节点:ClipConfig​
Video​
-​
是​
-​
视频编码参数。​
父节点:Transcode​
Codec​
String​
否​
h264​
视频编解码格式:​
  • h264​
  • h265​
父节点:Video ​
Width​
Integer​
否​
0​
视频宽度,单位 px,必须为偶数,取值范围为 [128, 4096]。​
父节点:Video​
说明​
如果只设置 Width ,未设置Height,将按照视频原始比例计算视频文件的高度。
Height​
Integer​
否​
720​
视频高度,单位 px,必须为偶数,取值范围为 [128, 4096]。​
父节点:Video ​
说明​
如果只设置 Height ,未设置Width,将按照视频原始比例计算视频文件的宽度。
Crf​
Integer​
否​
23​
视频文件的码率控制因子,值范围 (0, 51],默认值为 0 表示不设置。​
  • 若Crf的取值大于 0,则 BitRate参数的设置将失效。​
  • 若 BitRate 未设置或为空,则采用编码器的默认值。​
父节点:Video ​
PixFmt​
String​
否​
yuv420p​
视频像素格式,取值如下:​
  • yuv420p​
  • yuv420p10le​
父节点:Video ​
BitRate​
Integer​
否​
0​
视频输出文件的码率,单位 bps,值范围 [10000, 50000000],默认值为 0 表示不设置。​
父节点:Video​
MaxBitRate​
Integer​
否​
5000000​
视频输出最大码率,单位 bps,值范围 [10000, 50000000]。​
设置该参数时必须同时设置 BitRate,且 MaxBitRate 必须大于等于 BitRate。 ​
父节点:Video​
BufferSize​
Integer​
否​
10000000​
视频码率控制缓冲区大小,单位 bps,取值范围为 [1000000, 128000000]。​
设置该参数时必须同时设置 MaxBitRate。 ​
父节点:Video。​
Fps​
Integer​
否​
0​
视频帧率,单位 fps,值范围 (0, 60],默认 0 表示不设置。​
父节点:Video ​
Remove​
Bool​
否​
false​
是否删除源视频流,取值 true 或 false。​
父节点:Video ​
Audio​
-​
否​
-​
指定音频流参数。​
父节点:Transcode​
Codec​
String​
否​
aac​
​
音频流编码格式,取值列表如下:​
  • mp3​
  • aac​
  • flac​
  • Vorbis​
  • ac3​
  • opus​
  • pcm_s16le​
父节点:Audio ​
说明​
不同容器格式支持的音频编码格式有所不同,详情请参见不同容器的音频编码格式支持情况。
BitRate​
Integer​
否​
0​
音频码率,单位为比特/秒(bps),取值范围为:[8000, 1000000]。为 0 时使用原音频码率,部分容器不支持指定码率。​
父节点:Audio ​
说明​
不同格式支持的声道数有所不同,详情请参见不同音频容器参数支持情况。​
SampleFormat​
String​
否​
-​
音频采样格式,不同容器取值范围不同。取值:​
  • fltp​
  • s16​
  • s16p​
  • s32​
  • s32p​
父节点:Audio ​
SampleRate​
Integer​
否​
0​
音频采样率,不同容器取值范围不同。​
父节点:Audio ​
说明​
不同格式支持的采样率有所不同,详情请参见不同音频容器采样率支持情况。
Channels​
Integer​
否​
0​
音频声道数,默认与指定的源音频一致,取值范围:1~8,不同容器取值范围不同。​
父节点:Audio ​
Remove​
Bool​
否​
false​
是否删除源音频流,取值 true 或 false。​
父节点:Audio ​
Options​
String​
否​
-​
指定转码可选参数。​
父节点:Transcode​
​
请求示例​
​
GET /?process_template&tag=Transcode&id={} HTTP/1.1​
Host: {BucketName}.tos-cn-beijing.volces.com​
Date: Fri, 30 Jul 2021 08:05:36 +0000​
Authorization: authorization string​
​
响应示例​
​
HTTP/1.1 200 OK​
Date: Fri, 30 Jul 2021 13:53:55 GMT​
Content-Type: application/json​
Content-Length: <length>​
Server: TosServer​
x-tos-id-2: 1e89f203jld00006-a444fd0​
x-tos-request-id: 1e89f203b2d00006-a444ed0​
​
{​
"Tag": "Transcode",​
"ID": "343339383230623339346119012d08292633",​
"Name": "transcode-template-1",​
"TranscodeConfig": {​
"TimeInterval": {​
"Start": 0,​
"Duration": 10000​
},​
"Container": {​
"Format": "mp4",​
"ClipConfig": {​
"Duration": 0​
}​
},​
"Video": {​
"Codec": "h264",​
"Width": 0,​
"Height": 720,​
"Crf": 23,​
"PixFmt": "yuv420p",​
"BitRate": 0,​
"MaxBitRate": 0,​
"BufferSize": 0,​
"Fps": 0,​
"Remove": false​
},​
"Audio": {​
"Codec": "aac",​
"SampleRate": 0,​
"BitRate": 0,​
"Channels": 0,​
"SampleFormat": "",​
"Remove": false​
},​
"Options": {}​
}​
}​
​
​
最近更新时间:2026.08.03 15:17:35
这个页面对您有帮助吗?
有用
有用
无用
无用