人脸检测任务创建

最近更新时间:2024-08-15 12:13:01

我的收藏
传入 RequestId,图片的 url 和检测版本,创建人脸检测任务,返回 TaskId。使用 TaskId 可以进行进度查询。通过预先的人脸检测,可以提高照片数智人的定制成功率。

调用协议

HTTPS + JSON
POST /v2/ivh/facedetectserver/facedetectservice/facedetect
Header Content-Type: application/json;charset=utf-8

请求参数

参数
类型
必须
说明
RequestId
string
RequestId
ImageUrl
string
要进行检测的图片的 url
CheckerVersion
int
检测版本,支持项:[1,2]。不传默认为1。
值为1时:
检查图片的比例,目前支持[9:16, 16:9, 1:1, 4:3]
检查结果只包含人脸框信息和角度
值为2时:
不检查图片比例
检查结果包含遮挡比例,建议裁剪的区域坐标等信息。根据建议裁剪的区域对原图片进行裁剪,然后再进行数智人制作效果会更好。

返回参数

参数
类型
必须
说明
TaskId
string
携带TaskId访问人脸检测任务状态查询接口,可获得检测进度和检测结果

请求示例

{
"Header": {},
"Payload": {
"RequestId": "XXXX",
"ImageUrl": "YYYY"
"CheckerVersion": 2
}
}

返回示例

{
"Header": {
"Code": 0,
"DialogID": "",
"Message": "",
"RequestID": "123"
},
"Payload": {
"TaskId": "666"
}
}