使用模版创建转码任务-CreateCodecTaskByPatten

使用模版创建转码任务

Request Parameters

Parameter nameTypeDescriptionRequired
Url.nstring原始视频地址,只支持http协议,不支持https以及其他协议。单次提交url数量最多为10条。Yes
DestBucketstring存放转码后视频文件的bucket,需使用bucket全名,如:video.cn-bj.ufileos.comYes
CodecPattenId.nstring转码模版Id,单次提交支持最多3个转码模版。下标相同的转码模版、水印模版、片头片尾模版进行组合。Yes
BaseDirstring上传到ufile上文件的路径No
WatermarkPattenIdstring水印模版IdNo
HeadTailPattenIdstring片头片尾模版IdNo
ProjectIdstring项目编号,未填写则为默认项目No
视频转码、截图、鉴黄等处理完成后, UMedia 可以回调用户的接口, 通知处理的结果。
客户需提供一个接收处理结果的 api 接口,处理结果被封装成 json 字符串,通过 POST 请求,
传递给用户的接口。具体回调参数字段如下:
1)转码回调详细参数:
{
"retcode":0, //0 表示处理成功,
"task_id":"1", //提交转码生成的任务 id
"src_url":"http://src.ufile.ucloud.cn/my.mp4", //原始 url 地址
"dest_video_name":"my_720p.mp4", //目标文件名
"dest_video_url":"http://dest.ufile.ucloud.cn/my_720p.mp4", //目标文件地址
"duration":587, //转码后 视频的时长,单位秒
"file_size":587, //视频的文件大小
"width":1280, //视频的宽,单位为像素
"height":720, //视频的高,单位为像素
"message":"succ" //处理结果描述
}

Response Elements

Parameter nameTypeDescriptionRequired
RetCodeint操作返回码Yes
Actionstring操作名称Yes
TotalTaskCountint生成的总的任务条数No
TaskIdListarray生成的任务Id列表No

Request Example

https://api.ucloud.cn/?Action=CreateCodecTaskByPatten
&Url.0=http://video.ufile.ucloud.cn/myvideo.mp4
&DestBucket=video.cn-bj.ufileos.com
&CodecPattenId.0=1
&CodecPattenId.1=4
&WaterMarkPattenId=1

Response Example

{
    "Action": "CreateCodecTaskByPattenResponse",
    "TaskIdList": [
        {
            "TaskId": "3386"
        },
        {
            "TaskId": "3387"
        }
    ],
    "TotalTaskCount": 2,
    "RetCode": 0
}