调用CompareImageFaces接口比较两个人脸的相似度。

背景信息

您可以使用如下两种方式比较两个人脸的相似度。

  • 通过传入媒体集中的两个人脸ID进行比较，具体步骤如下：

    1. 调用CreateSet接口创建媒体集。

    2. 调用IndexImage接口将图片索引到媒体集。

    3. 调用ListImages或GetImage接口获取需要进行搜索的人脸ID。

    4. 使用媒体集中的人脸ID，将人脸ID作为输入值，比较两个人脸的相似度。

  • 通过传入两张图片的OSS URI进行比较，具体步骤如下：

    1. 将两张图片上传到OSS。

    2. 使用图片的OSS URI，将图片中的人脸作为输入值，比较两个人脸的相似度。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
RegionId String 否 cn-hangzhou

项目所在地域的ID。

地域Endpoint格式为imm.RegionId.aliyuncs.com，例如当RegionId为cn-hangzhou时，地域Endpoint为imm.cn-hangzhou.aliyuncs.com。

Action String 是 CompareImageFaces

操作接口名称。固定取值为CompareImageFaces。
Project String 是 immimagetest

项目名称。
SetId String 否 set001

媒体集的唯一标识。
ImageUriA String 是 oss://imm-test/testcases/face1.jpg

图片的OSS URI。

OSS地址规则为oss://bucket/object，其中bucket为和当前项目处于同一区域的OSS Bucket名称，object为文件路径。

通过两张图片的OSS URI进行人脸相似度比较时，必须设置此参数。
ImageUriB String 否 oss://imm-test/testcases/face2.jpg

图片的OSS URI。

OSS地址规则为oss://bucket/object，其中bucket为和当前项目处于同一区域的OSS Bucket名称，object为文件路径。

通过两张图片的OSS URI进行人脸相似度比较时，必须设置此参数。
FaceIdA String 否 59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a040****

媒体集中已存在的人脸ID。

通过媒体集中的两个人脸ID进行人脸相似度比较时，必须设置此参数。
FaceIdB String 否 b4a15b4f1618cdfa45a812974cfc160570052487ca1053e20bfdc12917e2****

媒体集中已存在的人脸ID。

通过媒体集中的两个人脸ID进行人脸相似度比较时，必须设置此参数。

返回数据

名称 类型 示例值 描述
RequestId String F73AC982-2B9E-4ECD-AED5-F8331C5A1988

当次请求的Request ID。
Similarity Float 0.8848152756690983

人脸相似度，该值越大则人脸相似度越高，取值范围为0～1。
SetId String set001

媒体集的唯一标识。
FaceA Object

人脸信息。
FaceId String 59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a040****

人脸ID。
FaceAttributes Object

人脸属性。
FaceBoundary Object

人脸位置框。
Top Integer 191

顶点Y坐标，距离顶端距离。
Width Integer 269

人脸位置框宽度。
Height Integer 252

人脸位置框高度。
Left Integer 95

顶点X坐标，距离左端距离。
FaceB Object

人脸信息。
FaceId String b4a15b4f1618cdfa45a812974cfc160570052487ca1053e20bfdc12917e2****

人脸ID。
FaceAttributes Object

人脸属性。
FaceBoundary Object

人脸位置框。
Top Integer 72

顶点Y坐标，距离顶端距离。
Width Integer 83

人脸位置框宽度。
Height Integer 89

人脸位置框高度。
Left Integer 249

顶点X坐标，距离左端距离。

示例

请求示例

- 通过传入媒体集中的两个人脸ID进行比较的请求示例

  http(s)://[Endpoint]/?Action=CompareImageFaces
  &FaceIdA=59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a040****
  &FaceIdB=b4a15b4f1618cdfa45a812974cfc160570052487ca1053e20bfdc12917e2****
  &Project=immimagetest
  &SetId=set001
  &<公共请求参数>   

- 通过传入两张图片的OSS URI进行比较的请求示例

  http(s)://[Endpoint]/?Action=CompareImageFaces
  &ImageUriA=oss://imm-test/testcases/face1.jpg
  &ImageUriB=oss://imm-test/testcases/face2.jpg
  &Project=immimagetest
  &<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<CompareImageFacesResponse>
    <Similarity>0.8848152756690983</Similarity>
    <RequestId>F73AC982-2B9E-4ECD-AED5-F8331C5A1988</RequestId>
    <SetId>set001</SetId>
    <FaceA>
        <FaceId>59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a040****</FaceId>
        <FaceAttributes>
            <FaceBoundary>
                <Left>95</Left>
                <Top>191</Top>
                <Height>252</Height>
                <Width>269</Width>
            </FaceBoundary>
        </FaceAttributes>
    </FaceA>
    <FaceB>
        <FaceId>b4a15b4f1618cdfa45a812974cfc160570052487ca1053e20bfdc12917e2****</FaceId>
        <FaceAttributes>
            <FaceBoundary>
                <Left>249</Left>
                <Top>72</Top>
                <Height>89</Height>
                <Width>83</Width>
            </FaceBoundary>
        </FaceAttributes>
    </FaceB>
</CompareImageFacesResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Similarity" : 0.8848152756690983,
  "RequestId" : "F73AC982-2B9E-4ECD-AED5-F8331C5A1988",
  "SetId" : "set001",
  "FaceA" : {
    "FaceId" : "59edc040d0a8f4952b183d1b5044913a0ccd8739500ee2705ffe4965a040****",
    "FaceAttributes" : {
      "FaceBoundary" : {
        "Left" : 95,
        "Top" : 191,
        "Height" : 252,
        "Width" : 269
      }
    }
  },
  "FaceB" : {
    "FaceId" : "b4a15b4f1618cdfa45a812974cfc160570052487ca1053e20bfdc12917e2****",
    "FaceAttributes" : {
      "FaceBoundary" : {
        "Left" : 249,
        "Top" : 72,
        "Height" : 89,
        "Width" : 83
      }
    }
  }
}