视频内容分析

一. 简介

视频内容分析支持用户上传一段需要处理的视频, 根据需要进行结构解析,静态摘要,动态摘要中的一种或多种服务

1. 结构解析

服务支持用户上传一段视频,生成并返回该段视频的镜头(shot)解析文档和场景(scene)解析文档。视频结构解析上传接口提供用户上传待处理视频至处理服务。结构解析状态查询接口提供用户查询处理进度,以及最终输出压缩文件(.zip)的下载链接。

2. 静态摘要

服务支持用户上传一段视频,生成并返回该段视频的静态视频摘要结果,以关键帧(keyframe)JPG格式存储在staticThumbnail文件中, 同时返回镜头(shot)解析文档和场景(scene)解析文档。视频静态摘要上传接口提供用户上传待处理视频至处理服务。静态摘要状态查询接口提供用户查询处理进度,以及最终输出压缩文件(.zip)的下载链接。

3. 动态摘要

服务支持用户上传一段视频,生成并返回该段视频的动态视频摘要结果,以MP4格式存储在motionThumbnail文件中, 同时返回镜头(shot)解析文档和场景(scene)解析文档。视频动态摘要上传接口提供用户上传待处理视频至处理服务。动态摘要状态查询接口提供用户查询处理进度,以及最终输出压缩文件(.zip)的下载链接。

其中镜头解析文档(shotinfo.txt) 和场景解析文档(sceneinfo.txt)的以每一行为单元,描述各自镜头/场景的其实, 顺序为:

  • 起始帧ID(beginning frame ID),
  • 起始时间戳(beginning frame timestamp),单位为秒,
  • 截止帧ID(end frame ID),
  • 截止时间戳(end frame timestamp), 单位为秒。

二. 视频上传接口

用于用户上传需要处理的视频至处理服务

1. 接口地址

1.1 结构解析上传接口
https://aiapi.jd.com/jdai/structure_analysis
1.2 静态摘要上传接口
https://aiapi.jd.com/jdai/static_thumbnail
1.3 动态摘要上传接口
https://aiapi.jd.com/jdai/motion_thumbnail

2. 请求方式:

POST

3. 请求参数

3.1、Query请求参数
名称 类型 必填 示例值 描述
appkey String 80d2b762ecb86593f9668526920f46c 您的appkey,可在买家中心控制台中获取
timestamp long 1541491668060 请求的时间戳,精确到毫秒,timestamp有效期5分钟
sign String 2e148773a0337a8f2200ba90d445f083 签名,根据规则MD5(sectetkey+timestamp)
video String 视频文件名
3.2、Header请求参数
key type value
Content-Type string 'application/octet-stream'
3.3、Body请求参数
名称 类型 必填 示例值 描述
binary 视频文件

确认支持的视频格式包括:mp4,avi。

3. 输出:

key type value
code int 0
messgae string "Sucess"
task_id string '2020-09-18-dassdasdasjiojonsidnisa'

4. 状态码

code message 说明
0 Sucess 调用成功,视频上传成功,开始处理视频
2000 File error, unsupport video type 输入的视频文件格式不支持
2001 File error, can't read video file 输入的视频数据解析失败
5000 Service error 系统错误
5001 Service busy 系统忙

*本系统最大支持缓存的视频数量为50个,当视频数量大于50个之后会返回系统忙。不限制上传视频的长度。

三. 状态查询接口

用于用户查询视频处理状态,下载视频处理后的结果链接

1. 接口地址

1.1 结构解析状态查询接口
https://aiapi.jd.com/jdai/structure_analysis_status
1.2 静态摘要状态查询接口
https://aiapi.jd.com/jdai/static_thumbnail_status
1.3 动态摘要状态查询接口
https://aiapi.jd.com/jdai/motion_thumbnail_status

2. 请求方式:

POST

3. 请求参数

3.1、Query请求参数
名称 类型 必填 示例值 描述
appkey String 80d2b762ecb86593f9668526920f46c 您的appkey,可在买家中心控制台中获取
timestamp long 1541491668060 请求的时间戳,精确到毫秒,timestamp有效期5分钟
sign String 2e148773a0337a8f2200ba90d445f083 签名,根据规则MD5(sectetkey+timestamp)
3.2、Header请求参数
key type value
Content-Type string 'application/json'
3.3、Body请求参数
key type value
task_id string '2020-09-18-dassdasdasjiojonsidnisa'

4. 输出

key type value
code int 0
message string "Finish"
progress_rate int 100
editor_result string "http://storage.jd.com/XXXXX.zip"

只有当code为0,editor_result字段才会有值,值为视频处理之后的输出文档压缩文件(.zip)下载链接。

5. 状态码

code message 说明
0 Finish 视频处理完成
1000 Key error, 'task_id' not exist 输入参数中没有task_id
1001 Not find error, input task_id not exist 输入的task_id不存在
1002 File error, input video file decode error 输入的视频无法被正常解析
2000 Content error, unsupport video content 输入的视频被判定为不是足球视频
2001 Content error, can't find useful highlight clips 输入的视频未找到可用的精彩片段
3000 Processing 视频处理中,进度可通过progress_rate获得
5000 Service error 系统错误
Copyright © JD AI Platform all right reserved,powered by GitbookFile Modify: 2021-02-25 11:42:19

results matching ""

    No results matching ""