最近更新时间：2021-08-26
1 功能描述
视频人脸采集用于对视频进行人脸采集，返回视频总帧数、帧率、采集到的人脸数据集、人脸坐标等信息。
您通过接口输入一段视频，服务能够分析识别出视频中的所有人脸信息，输入视频大小不超过20MB，视频格式支持（AVI、wma、rmvb、rm、mp4）。返回数据包含上传视频的帧率，总帧数，默认每秒采集一次人脸数据，采集到的人脸数据集（包括每一次采集的人脸坐标，人脸定位，人脸数和图片压缩文件zip）。
调用地址：https://apim.unicloud.com/api/face/video/1.0.0/
请求方式：POST
返回类型：JSON
Header如下：
| 参数 | 值 | 说明 |
|---|---|---|
| Content-Type | application/json | -- |
| Authorization | Bearer | 参考Token获取 |
Body如下：
| 参数 | 是否必选 | 类型 | 可选值范围 | 说明 |
|---|---|---|---|---|
| video_file | true | file | -- | 视频文件（AVI、wma、rmvb、rm、mp4） |
| node_frame | false | int | 1-50 | 间隔多少帧采集一次人脸数据。不填写的话，将以帧率为间隔进行采集，即默认每秒采集一次人脸数据 |
注：Body使用form-data形式
curl -k -H "Authorization:Bearer 2b8296e1-86a5-3a68-bd61-9b88f9dce5c0" \ -F "video_file=@vediopath.jpg" https://apim.unicloud.com/api/face/video/1.0.0/
curl -k -H "Authorization:Bearer 2b8296e1-86a5-3a68-bd61-9b88f9dce5c0" \ -F "video_file=@vediopath.mp4" \ https://apim.unicloud.com/api/face/video/1.0.0/
curl -k -H "Authorization:Bearer 2b8296e1-86a5-3a68-bd61-9b88f9dce5c0" -F "video_file=@vediopath.jpg" https://apim.unicloud.com/api/face/video/1.0.0/
| 字段 | 类型 | 说明 |
|---|---|---|
| data | object | 检测到的人脸数据 |
| +frame_count | int | 视频总帧数 |
| +frame_per_s | float | 帧率，视频每秒帧数 |
| +face_locations | list | 每一张人脸的坐标和五官坐标 |
| ++frame_index | int | 第几帧 |
| ++face_location | list | 定位到的人脸数据 |
| ++face_count | int | 定位到的人脸数量 |
| +face_data | string | 所有采集到的人脸图像压缩包 |
| code | int | 返回码（200：接口调用成功，400：文件格式错误或非法数据，500：程序异常退出） |
| message | string | 提示信息 |
{
"data":{
"frame_count": 275, #总帧数
"frame_per_s": 29.97, #帧率，每秒多少帧
"face_locations": [
{
"frame_index": 0, #第几帧
"face_location": Array[0], #定位到的人脸数据
"face_count": 0 #定位到的人脸数量
},
{...}
],
"face_data": "http://apim.unicloud.com/static/face_temp/20191018/3aac91846ba9b240953debea1b52c26b.zip"
},
"code": 200,
"message": "success"
}{ "data":{ "frame_count": 275, #总帧数
"frame_per_s": 29.97, #帧率，每秒多少帧
"face_locations": [
{ "frame_index": 0, #第几帧
"face_location": Array[0], #定位到的人脸数据
"face_count": 0 #定位到的人脸数量
},
{...}
], "face_data": "http://apim.unicloud.com/static/face_temp/20191018/3aac91846ba9b240953debea1b52c26b.zip"
}, "code": 200, "message": "success"}{
"data":{
"frame_count": 275, #总帧数
"frame_per_s": 29.97, #帧率，每秒多少帧
"face_locations": [
{
"frame_index": 0, #第几帧
"face_location": Array[0], #定位到的人脸数据
"face_count": 0 #定位到的人脸数量
},
{...}
],
"face_data": "http://apim.unicloud.com/static/face_temp/20191018/3aac91846ba9b240953debea1b52c26b.zip"
},
"code": 200,
"message": "success"
}