› 推特 ›阿里云技术文档›正文

ListFaceGroups 获取人脸分组列表_SetFaceGroups 人脸聚类_图片管理类操作_API手册_智能媒体管理

admin 阿里云技术文档 2020-02-11 214 0
阿里云服务器优惠

ListFaceGroups 获取人脸分组列表

描述

接口公测中，如有任何使用问题请 联系我们

获取一个 Set 内的人脸分组列表。

请求参数

Parameter Type Required Comment
Project string Y Project
SetId string Y 媒体集 SetId
Marker string N Marker 翻页标记
Limit int N 每页显示数量，范围 [1,100] ，默认 20
OrderBy string N 排序字段，可选值为 CreateTime / ModifyTime / FaceCount ，默认 FaceCount
Order string N 排序顺序，可选值为 ASC / DESC ，默认 DESC

返回参数

Parameter Type Comment
Groups []Group 人脸分组列表 。
NextMarker string Marker 翻页标记

数据类型 Group

Parameter Type Comment
GroupName string 人脸分组名称，自定义字段。
GroupId string 人脸分组 ID 。
FaceCount int 组内人脸数量。
CreateTime string 人脸分组的创建时间。
ModifyTime string 人脸分组的修改时间。
GroupCoverFace []GroupCoverFace 该组的封面人脸。

数据类型 GroupCoverFace

Parameter Type Comment
FaceId string 人脸 ID 。
FaceBoundary Boundary 人脸框。
ImageUri string 人脸所属图片的 OSS URI 。

示例

请求示例

  1. POST https://imm.cn-shanghai.aliyuncs.com
  2. ?Action=ListFaceGroups
  3. &Project=test-project
  4. &SetId=test-set
  5. ...

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

成功返回示例

  1. {
  2.   "FaceGroups": [
  3.     {
  4.       "GroupName": "Test",
  5.       "CreateTime": "2019-02-20T09:35:51.057Z",
  6.       "ModifyTime": "2019-02-20T09:35:51.057Z",
  7.       "FaceCount": 5,
  8.       "GroupId": "Group-45af612b-8024-4987-94ae-6b14374f0ec1",
  9.       "GroupCoverFace": {
  10.         "FaceBoundary": {
  11.           "Top": 141,
  12.           "Height": 200,
  13.           "Width": 201,
  14.           "Left": 132
  15.         },
  16.         "FaceId": "ee93c2669430aedf5d521f98e47571e380fa046c68a80ffca9d7758c984e53a9",
  17.         "ImageUri": "oss://imm-dev-wmt/facegroup/05.jpg"
  18.       }
  19.     }
  20.   ],
  21.   "RequestId": "87A90190-85DF-407A-A395-1E8898286656",
  22.   "NextMarker": ""
  23. }

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

版权声明

本文仅代表作者观点，不代表本站立场。
本文系作者授权发表，未经许可，不得转载。

评论

-----