传入 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 | 是 |
请求示例
{"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"}}