音视频媒资接口

创建媒资

VOD不提供直接创建媒资的API接口,而是用申请媒资、BOS上传、处理媒资三步创建法完成创建:1) 通过申请媒资获取mediaId、BOS Bucket和BOS Key;2) 使用BOS上传视频文件;3) 通过处理媒资方法通知VOD服务文件上传完毕,VOD开始生成并处理媒资。

申请媒资

申请媒资接口用于生成媒资的唯一标识mediaId、用于存储源视频文件的sourceBucket以及源媒资文件在BOS存储中的key。sourceBucket对用户开放写权限,对于用户的BOS空间不可见。

注意:成功申请媒资后,请参考媒资三步创建法于一周内完成BOS上传及媒资处理,否则相应的mediaId将逾期失效。

请求语法

POST /v<version>/media?apply HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: <utc-date-string>
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: <bce-request-id>
content-type: application/json
authorization: <bce-authorization-string>

请求参数

参数 类型 描述 是否必须
mode String 媒资的模式。VOD为某些特殊场景提供了不同格式的媒资,这些媒资以mode区分。
多数用户无需传递该参数。如有特殊需求,请提交工单咨询

请求头域

无特殊请求头域。

请求示例

POST /v1/media?apply HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: 2015-07-03T09:28:13Z
host: vod.bj.baidubce.com
accept: */*
connection: keep-alive
x-bce-request-id: c82c903b-f513-4990-b020-637bc866ee75
content-type: application/json
authorization: <bce-authorization-string>

响应头域

无特殊响应头域。

响应参数

头域 类型 描述
mediaId String 系统生成的媒资的唯一标识mediaId
sourceBucket String 该媒资对应的源文件上传地址在BOS存储中的Bucket
sourceKey String 该媒资对应的源文件上传地址在BOS存储中的Key
host String 该媒资对应的源文件上传地址对应的BOS存储的BOS host

响应示例

HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: c82c903b-f513-4990-b020-637bc866ee75
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 2015 13:34:07 GMT
Content-Type: application/json;charset=UTF-8

{
    "mediaId":"mda-gaefib8idcyi36q8",
    "sourceBucket":"vod-gaefbnknkxk1hsm1",
    "sourceKey":"vod-gaefbnknkxk1hsm1/mda-gaefib8idcyi36q8",
    "host":"bj.bcebos.com"
}

处理媒资

用于对已完成申请和视频上传的媒资进行处理。

媒资的三步创建法请见创建媒资

请求语法

PUT /v<version>/media/<mediaId>?process HTTP/1.1
accept-encoding: gzip, deflate
x-bce-date: <utc-date-string>
connection: keep-alive
accept: */*
host: vod.bj.baidubce.com
x-bce-request-id: <bce-request-id>
content-type: application/json
authorization: <bce-authorization-string>

请求头域

无特殊请求头域。

请求参数

参数 类型 描述 是否必须
title String 媒资名称,“媒资属性”的子参数
description String 媒资描述,“媒资属性”的子参数
sourceExtension String 媒资源文件扩展名,有效值:大小写字母和数字组成的最长10个字符的字符串
transcodingPresetGroupName String 使用的转码模板组名称
priority Integer 转码排队优先级。可选值0-9,不传默认为0。
为了更好的做用户级别的转码调度,处理媒资时候可以增加优先级概念。
同个用户下,