CompareImageFaces 人脸相似度比较
描述
比较两个人脸的相似度。
该接口有两种使用方法,一种是传入一个媒体集 Set 内的两个人脸 ID FaceId
进行比较。该方式需要先创建 Set ,并进行 IndexImage 操作将图片索引至 Set 中。
另一种是直接传入两张图片的 OSS URI ,将直接比较两张图片中分别 最大 的两个人脸的相似度。无需创建 Set 。
请求参数
Parameter | Type | Required | Comment |
---|---|---|---|
Project | string | Y | Project |
SetId | string | Y | SetId |
FaceIdA | string | Y | Set 中已存在的 FaceId |
FaceIdB | string | Y | Set 中已存在的 FaceId |
或
Parameter | Type | Required | Comment |
---|---|---|---|
Project | string | Y | Project |
ImageUriA | string | Y | 图片 OSS URI,如 oss://imm-test/testcases/face1.jpg OSS 地址规则为: oss://bucket/object ,其中 bucket 为和当前 Project 在同一区域的 OSS 桶名, object 为文件路径。 |
ImageUriB | string | Y | 图片 OSS URI,如 oss://imm-test/testcases/face2.jpg OSS 地址规则为: oss://bucket/object ,其中 bucket 为和当前 Project 在同一区域的 OSS 桶名, object 为文件路径。 |
返回参数
Parameter | Type | Comment |
---|---|---|
RequestId | string | 该次请求的唯一识别码。 |
Similarity | float | 相似度,0~1 |
FaceA | Face | FaceIdA 或 ImageUriA 的人脸信息 |
FaceB | Face | FaceIdB 或 ImageUriB 的人脸信息 |
数据类型 Face
Parameter | Type | Comment |
---|---|---|
FaceId | string | 用于唯一标识该人脸 。 |
FaceAttributes | FaceAttributes | 人脸属性 |
数据类型 FaceAttributes
Parameter | Type | Comment |
---|---|---|
FaceBoundary | Boundary | 人脸位置框。 |
示例
请求示例
POST https://imm.cn-shanghai.aliyuncs.com
?Action=CompareImageFaces
&Project=test-project
&ImageUriA=oss://imm-test/testcases/image1.jpg
&ImageUriB=oss://imm-test/testcases/image2.jpg
...
此处的示例,目的是展示关键参数,还需要其他的公共参数才能正常调用,推荐使用 SDK 来发送 API。
成功返回示例
{
"FaceB": {
"FaceId": "4d00c854a55a2a0a1b905e6b6d9c2b60888a4a65b550f88bfbc0bda77c7c5ce3",
"FaceAttributes": {
"FaceBoundary": {
"Top": 154,
"Height": 215,
"Width": 216,
"Left": 240
}
}
},
"FaceA": {
"FaceId": "33ba731d175d38d8f2b53b36d87dd95a0cb533615ea6b5f653cc3013638211eb",
"FaceAttributes": {
"FaceBoundary": {
"Top": 101,
"Height": 191,
"Width": 191,
"Left": 421
}
}
},
"RequestId": "BADFB3A2-BF8D-4AA4-AEB4-A9A8D06B59FC",
"Similarity": 0.9432677030563354
}
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论