CompareImageFaces 人脸相似度比较_SetFaces 媒体集人脸处理_图片管理类操作_API手册_智能媒体管理_阿里云技术文档

描述

比较两个人脸的相似度。

该接口有两种使用方法，一种是传入一个媒体集 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
}

若在使用中有疑问，请参考 FAQ，或者进入钉钉用户群实时交流。

CompareImageFaces 人脸相似度比较_SetFaces 媒体集人脸处理_图片管理类操作_API手册_智能媒体管理

CompareImageFaces 人脸相似度比较

描述