人脸检测任务创建

最近更新时间:2024-12-25 16:47:53

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

调用协议

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

请求参数

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

返回参数

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

请求示例

{
"Header": {},
"Payload": {
"RequestId": "569ae497-f266-4565-93bd-93aaf822524e",
"ImageUrl": "https://virtualhuman-cos-prod-1251316161.cos.ap-gangzhou.myqcloud.com/customer-pipeline/704/e60fe7c8-ec69-44cf-bc5e-c4c754614e82/photo/48922.png",
"CheckerVersion": 2
}
}

返回示例

{
"Header": {
"RequestID": "gz1a74c25f17030396653416949",
"SessionID": "gz1a74c25f17030396653416950",
"DialogID": "",
"Code": 0,
"Message": "ok"
},
"Payload": {
"TaskId": "569ae497-f266-4565-93bd-93aaf822524e"
}
}