全部产品
云市场

CompareImageFaces 人脸相似度比较

更新时间:2019-02-25 14:48:08

描述

比较两个人脸的相似度。

该接口有两种使用方法,一种是传入一个媒体集 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 人脸位置框。

示例

请求示例

  1. POST https://imm.cn-shanghai.aliyuncs.com
  2. ?Action=CompareImageFaces
  3. &Project=test-project
  4. &ImageUriA=oss://imm-test/testcases/image1.jpg
  5. &ImageUriB=oss://imm-test/testcases/image2.jpg
  6. ...

此处的示例,目的是展示关键参数,还需要其他的公共参数才能正常调用,推荐使用 SDK 来发送 API

成功返回示例

  1. {
  2. "FaceB": {
  3. "FaceId": "4d00c854a55a2a0a1b905e6b6d9c2b60888a4a65b550f88bfbc0bda77c7c5ce3",
  4. "FaceAttributes": {
  5. "FaceBoundary": {
  6. "Top": 154,
  7. "Height": 215,
  8. "Width": 216,
  9. "Left": 240
  10. }
  11. }
  12. },
  13. "FaceA": {
  14. "FaceId": "33ba731d175d38d8f2b53b36d87dd95a0cb533615ea6b5f653cc3013638211eb",
  15. "FaceAttributes": {
  16. "FaceBoundary": {
  17. "Top": 101,
  18. "Height": 191,
  19. "Width": 191,
  20. "Left": 421
  21. }
  22. }
  23. },
  24. "RequestId": "BADFB3A2-BF8D-4AA4-AEB4-A9A8D06B59FC",
  25. "Similarity": 0.9432677030563354
  26. }

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