独立视频处理

最近更新时间:2019-08-14 19:27:50

接口名称

ProcessCosMedia

功能说明

用于向存储于 COS(对象存储)中的音视频发起处理任务,支持的处理包括:

  • 转码(包括水印、加密和转封装)
  • 转动图(如 gif)
  • 采样截图
  • 按时间点截图
  • 截取雪碧图
  • 智能分析(智能分类、智能标签)
  • 内容审核(鉴黄

发起任务后,系统将从 API 中指定的输入文件 Bucket 获取源视频文件,并将处理后的结果写入指定的输出文件 Bucket。

注意:

输入文件 Bucket 和输出文件 Bucket 需要先完成 配置操作

任务结果

该接口为异步接口,任务执行的结果可以通过事件通知和任务查询两种方式获取。

事件通知

任务处理和完成会触发事件通知-任务流状态变更通知。App 后台可据此监听任务流的执行状态。更多参见服务端事件通知简介

注意:

公测阶段,VTS 配置事件通知需要在点播控制台上进行。

任务查询

任务处理请求提交后,将获取到一个任务 ID(vodTaskId),通过查询任务详情 API 可以查询任务的执行状态和执行结果。

请求方式

请求域名

vod.api.qcloud.com

最高调用频率

100次/分钟

请求参数说明

参数名称 必填 类型 说明
input Object 参见输入文件信息参数
output Object 参见输出文件信息参数
aiAnalysis Object 参见智能分析参数 (注1)
contentReview Object 参见内容审核参数
mediaProcess Object 参见视频处理参数
taskAttribute Object 参见任务属性配置参数
COMMON_PARAMS 参见公共参数

注1:
对视频进行智能分析,需要满足原始视频小于100MB,视频封装格式必须为 MP4,FLV,AVI 三种封装格式。

input(输入文件信息参数)

参数名称 必填 类型 说明
bucket String 输入文件 Bucket(需要先完成配置操作
region String 输入文件 Bucket 所属地域,如 ap-guangzhou(参见已支持的 COS 地域列表
path String 输入文件路径

output(输出文件信息参数)

参数名称 必填 类型 说明
bucket String 输出文件 Bucket(需要先完成配置操作)(注2)
dir String 输出文件目录

注2:
目前,要求输出文件 Bucket 所属地域和输入 Bucket 的地域保持一致。

aiAnalysis(智能分析参数)

参数名称 必填 类型 说明
classification Object 参见智能分类控制参数
tag Object 参见智能标签控制参数

tag(智能标签控制参数)

参数名称 必填 类型 说明
definition Integer 智能标签模板号,目前只支持填10

classification(智能分类控制参数)

参数名称 必填 类型 说明
definition Integer 智能分类模板号,目前只支持填10

contentReview(内容审核参数)

参数名称 必填 类型 说明
porn Object 参见鉴黄审核参数

porn(鉴黄审核参数)

参数名称 必填 类型 说明
definition Integer 鉴黄模板号,参见鉴黄参数模板

mediaProcess(视频处理参数)

参数名称 必填 类型 说明
transcode Object 参见转码控制参数
animatedGraphics Object 参见转动图控制参数
sampleSnapshot Object 参见采样截图控制参数
snapshotByTimeOffset Object 参见指定时间点截图控制参数
imageSprite Object 参见雪碧图控制参数

transcode(转码控制参数)

参数名称 必填 类型 说明
definition Array 视频转码模版列表
definition.n Integer 视频转码模版号,参见转码参数模板
watermarkDefinition Array 水印模板列表
watermarkDefinition.n Integer 水印模版号,参见水印参数模板

animatedGraphics(转动图控制参数)

参数名称 必填 类型 说明
definition Array 视频转动图模版列表
definition.n Integer 视频转动图模版号,参见转动图参数模板
startTime Integer 动图在视频中的开始时间,单位为秒
endTime Integer 动图在视频中的结束时间,单位为秒

sampleSnapshot(采样截图控制参数)

参数名称 必填 类型 说明
definition Array 采样截图模版列表,参见采样截图参数模板
definition.n Integer 采样截图模版号

snapshotByTimeOffset(指定时间点截图控制参数)

参数名称 必填 类型 说明
definition Array 按时间点截图模版列表
definition.n Integer 按时间点截图模版号,参见指定时间点截图参数模板
timeOffset Array 按时间点截图时间点列表
timeOffset.n Integer 按时间点截图时间点,单位为毫秒

imageSprite(雪碧图控制参数)

参数名称 必填 类型 说明
definition Integer 截雪碧图参数模版列表
definition.n Integer 截雪碧图参数模版,参见雪碧图参数模板

taskAttribute(任务属性配置参数)

参数名称 必填 类型 说明
priority Integer 优先级
notifyMode String 任务流状态变更通知模式,默认为Finish。
  • Finish:只有当任务流全部执行完毕时,才发起一次事件通知;
  • Change:只要任务流中每个子任务的状态发生变化,都进行事件通知;
  • None:不接受该任务流回调。

支持的地域

目前云转码已经支持了 COS 的大部分主要地域,支持的地域清单如下表所示。

中国

地域名 含义
ap-guangzhou 广州(华南)
ap-chengdu 成都(西南)
ap-chongqing 重庆
ap-beijing 北京
ap-beijing-1 北京一区(华北)
ap-shanghai 上海(华东)
ap-hongkong 香港

海外

地域名 含义
ap-singapore 新加坡
ap-bangkok 曼谷
na-toronto 多伦多

后续将会支持更多的地域,敬请期待(COS 的完整地域列表请参见这里)。

请求示例

输入文件在名为 myinputbucket-1256244234 的 Bucket 中,绝对路径为 /input/F62A55F5-C4D6-4AEA-934F-7A6BFF3D8BCF.MOV
对输入文件进行做转码操作,转码的模板 ID 有 210220230
转码后输出到名为 myoutputbucket-1256244234 的 Bucket 的 /output/test/ 目录下。

https://vod.api.qcloud.com/v2/index.php?Action=ProcessCosMedia
&input.bucket=myinputbucket-1256244234
&input.path=/input/F62A55F5-C4D6-4AEA-934F-7A6BFF3D8BCF.MOV
&input.region=ap-guangzhou
&output.bucket=myoutputbucket-1256244234
&output.dir=/output/test/
&mediaProcess.transcode.definition.0=210
&mediaProcess.transcode.definition.1=220
&mediaProcess.transcode.definition.2=230
&COMMON_PARAMS

接口应答

参数说明

参数名称 类型 说明
code Integer 错误码,0:成功;其他值:失败
message String 返回信息
codeDesc String 错误信息
vodTaskId String 任务 ID

错误码说明

错误码 含义说明
4000-7000 参见公共错误码
1000 无效参数
10009 文件状态异常
其他 内部错误

应答示例

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "vodTaskId": "1256244234-procedurev2-63653704847be7b43e0f38bf2f86f54b"
}