GetFigureCluster - 获取人物人脸的聚类信息

获取人脸分组的基本信息,包括创建时间、照片数量、分组封面等信息。

接口说明

  • 请确保在使用该接口前,已充分了解智能媒体管理产品的收费方式和价格

  • 调用该接口前,请确保您已通过创建人脸聚类任务( CreateFigureClusteringTask )将数据集( CreateDataset )中所有人脸进行分组。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
imm:GetFigureClusterget
*Dataset
acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}/dataset/{#DatasetName}

请求参数

名称类型必填描述示例值
ProjectNamestring

项目名称,获取方式请参见 CreateProject

immtest
DatasetNamestring

数据集名称,获取方式请参见 CreateDataset

dataset001
ObjectIdstring

聚类分组的对象 ID。获取方式请参见 QueryFigureClusters 返回的人脸分组信息。

Cluster-1f2e1a2c-d5ee-4bc5-84f6-fef94ea****

返回参数

名称类型描述示例值
object

响应结构体

RequestIdstring

当次请求的 Request ID。

5F74C5C9-5AC0-49F9-914D-E01589D3****
FigureClusterFigureCluster

该聚类分组的具体信息。

示例

正常返回示例

JSON格式

{
  "RequestId": "5F74C5C9-5AC0-49F9-914D-E01589D3****",
  "FigureCluster": {
    "OwnerId": "102321002****",
    "ProjectName": "immtest",
    "DatasetName": "dataset001",
    "ObjectType": "figure-cluster",
    "ObjectId": "Cluster-ae6e3472-999e-410b-b54e-cd5dba****",
    "UpdateTime": "2022-01-14T10:10:52.83948013+08:00",
    "CreateTime": "2022-01-14T10:10:52.83948013+08:00",
    "Name": "abc",
    "Gender": "female",
    "FaceCount": 3,
    "ImageCount": 5,
    "VideoCount": 3,
    "AverageAge": 26,
    "MinAge": 12,
    "MaxAge": 44,
    "Cover": {
      "OwnerId": "102321002467****",
      "ProjectName": "test-project",
      "DatasetName": "test-dataset",
      "ObjectType": "file",
      "ObjectId": "75d5de2c50754e3dadd5c35dbca5f9949369e37eb342a73821f690c94c36c7f7",
      "UpdateTime": "2021-06-29T14:50:13.011643661+08:00",
      "CreateTime": "2021-06-29T14:50:13.011643661+08:00",
      "URI": "oss://test-bucket/test-object.jpg",
      "OSSURI": "oss://examplebucket/sampleobject.jpg",
      "Filename": "sampleobject.jpg",
      "MediaType": "image",
      "ContentType": "image/jpeg",
      "Size": 1000,
      "FileHash": "1d9c280a7c4f67f7ef873e28449dbe17",
      "FileModifiedTime": "2021-06-29T14:50:13.011643661+08:00",
      "FileCreateTime": "2021-06-29T14:50:13.011643661+08:00",
      "FileAccessTime": "2021-06-29T14:50:13.011643661+08:00",
      "ProduceTime": "2021-06-29T14:50:13.011643661+08:00",
      "LatLong": "30.134390,120.074997",
      "Timezone": "",
      "Addresses": [
        {
          "Language": "zh-Hans",
          "AddressLine": "中国浙江省杭州市余杭区文一西路969号",
          "Country": "中国",
          "Province": "浙江省",
          "City": "杭州市",
          "District": "余杭区",
          "Township": "文一西路"
        }
      ],
      "TravelClusterId": "-",
      "Orientation": 0,
      "Figures": [
        {
          "FigureId": "868a9e74-cde5-4c7a-9013-28bb984****",
          "FigureConfidence": 1,
          "FigureClusterId": "Cluster-dbe72fec-b84c-4ab6-885b-3678e64****",
          "FigureClusterConfidence": 1,
          "FigureType": "face",
          "Age": 29,
          "AgeSD": 5,
          "Gender": "female",
          "GenderConfidence": 1,
          "Emotion": "happiness",
          "EmotionConfidence": 0.70784568786621,
          "FaceQuality": 0.960875928401947,
          "Boundary": {
            "Width": 200,
            "Height": 300,
            "Left": 10,
            "Top": 30,
            "Polygon": [
              {
                "X": 10,
                "Y": 10
              }
            ]
          },
          "Mouth": "close",
          "MouthConfidence": 1,
          "Beard": "none",
          "BeardConfidence": 1,
          "Hat": "none",
          "HatConfidence": 1,
          "Mask": "none",
          "MaskConfidence": 1,
          "Glasses": "none",
          "GlassesConfidence": 0.8,
          "Sharpness": 0.7,
          "Attractive": 0.96,
          "HeadPose": {
            "Pitch": 18.385589599609375,
            "Roll": 4.204030513763428,
            "Yaw": 2.4945924282073975
          }
        }
      ],
      "FigureCount": 10,
      "Labels": [
        {
          "Language": "zh-Hans",
          "LabelName": "椅子",
          "LabelLevel": 2,
          "LabelConfidence": 0.95,
          "ParentLabelName": "家具",
          "CentricScore": 0.877
        }
      ],
      "Title": "test",
      "ImageWidth": 270,
      "ImageHeight": 500,
      "EXIF": "{\"Compression\":{\"value\":\"6\"},\"DateTime\":{\"value\":\"2020:08:19 17:11:11\"}}",
      "ImageScore": {
        "OverallQualityScore": 0.736
      },
      "CroppingSuggestions": [
        {
          "AspectRatio": "2:3",
          "Confidence": 0.742,
          "Boundary": {
            "Width": 200,
            "Height": 300,
            "Left": 10,
            "Top": 30,
            "Polygon": [
              {
                "X": 10,
                "Y": 10
              }
            ]
          }
        }
      ],
      "OCRContents": [
        {
          "Language": "zh-hans",
          "Contents": "欢迎使用智能媒体管理",
          "Confidence": 0.8254936695098877,
          "Boundary": {
            "Width": 200,
            "Height": 300,
            "Left": 10,
            "Top": 30,
            "Polygon": [
              {
                "X": 10,
                "Y": 10
              }
            ]
          }
        }
      ],
      "VideoWidth": 1080,
      "VideoHeight": 1920,
      "VideoStreams": [
        {
          "Index": 0,
          "Language": "en",
          "CodecName": "h264",
          "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
          "Profile": "High",
          "CodecTimeBase": "1373627/83160000",
          "CodecTagString": "avc1",
          "CodecTag": "0x31637661",
          "Width": 1280,
          "Height": 720,
          "HasBFrames": 2,
          "SampleAspectRatio": "1:1",
          "DisplayAspectRatio": "16:9",
          "PixelFormat": "yuv420p",
          "Level": 40,
          "FrameRate": "25/1",
          "AverageFrameRate": "25/1",
          "TimeBase": "1/12800",
          "StartTime": 0,
          "Duration": 22.88,
          "Bitrate": 5407765,
          "FrameCount": 572,
          "Rotate": "90",
          "BitDepth": 8,
          "ColorSpace": "bt709",
          "ColorRange": "tv",
          "ColorTransfer": "bt709",
          "ColorPrimaries": "bt709"
        }
      ],
      "Subtitles": [
        {
          "Index": 2,
          "Language": "en",
          "CodecName": "mov_text",
          "CodecLongName": "MOV text",
          "CodecTagString": "tx3g",
          "CodecTag": "0x67337874",
          "StartTime": 0,
          "Duration": 71.378,
          "Bitrate": 74,
          "Content": "欢迎",
          "Width": 600,
          "Height": 30
        }
      ],
      "AudioStreams": [
        {
          "Index": 1,
          "Language": "en",
          "CodecName": "aac",
          "CodecLongName": "AAC (Advanced Audio Coding)",
          "CodecTimeBase": "1/44100",
          "CodecTagString": "mp4a",
          "CodecTag": "0x6134706d",
          "TimeBase": "1/48000",
          "StartTime": 0.0235,
          "Duration": 3.690667,
          "Bitrate": 320087,
          "FrameCount": 173,
          "Lyric": "test",
          "SampleFormat": "fltp",
          "SampleRate": 48000,
          "Channels": 2,
          "ChannelLayout": "stereo"
        }
      ],
      "Artist": "Jane",
      "AlbumArtist": "Jane",
      "AudioCovers": [
        {
          "ImageWidth": 500,
          "ImageHeight": 820,
          "EXIF": "{\"FileSize\":{\"value\":\"29304\"},\"Format\":{\"value\":\"jpg\"}}",
          "ImageScore": {
            "OverallQualityScore": 0.736
          },
          "CroppingSuggestions": [
            {
              "AspectRatio": "2:3",
              "Confidence": 0.742
            }
          ],
          "OCRContents": [
            {
              "Language": "zh-hans",
              "Contents": "欢迎使用智能媒体管理",
              "Confidence": 0.8254936695098877
            }
          ]
        }
      ],
      "Composer": "Jane",
      "Performer": "Jane",
      "Language": "eng",
      "Album": "FirstAlbum",
      "PageCount": 5,
      "ETag": "\"1D9C280A7C4F67F7EF873E28449****\"",
      "CacheControl": "no-cache",
      "ContentDisposition": "attachment; filename =test.jpg",
      "ContentEncoding": "UTF-8",
      "ContentLanguage": "zh-CN",
      "AccessControlAllowOrigin": "https://aliyundoc.com",
      "AccessControlRequestMethod": "PUT",
      "ServerSideEncryptionCustomerAlgorithm": "SM4",
      "ServerSideEncryption": "AES256",
      "ServerSideDataEncryption": "SM4",
      "ServerSideEncryptionKeyId": "9468da86-3509-4f8d-a61e-6eab1eac****",
      "OSSStorageClass": "Standard",
      "OSSCRC64": "559890638950338001",
      "ObjectACL": "default",
      "ContentMd5": "HZwoCnxPZ/fvhz4oRJ2+Fw==",
      "OSSUserMeta": {
        "key": "val"
      },
      "OSSTaggingCount": 2,
      "OSSTagging": {
        "key": "val"
      },
      "OSSExpiration": "2120-01-01T12:00:00.000Z",
      "OSSVersionId": "CAEQNhiBgMDJgZCA0BYiIDc4MGZjZGI2OTBjOTRmNTE5NmU5NmFhZjhjYmY0****",
      "OSSDeleteMarker": "CAEQMhiBgIDXiaaB0BYiIGQzYmRkZGUxMTM1ZDRjOTZhNjk4YjRjMTAyZjhl****",
      "OSSObjectType": "Normal",
      "CustomId": "\t\nmember-image-id-0001",
      "CustomLabels": {
        "MemberName": "Tim",
        "Enabled": "True",
        "ItemCount": "10"
      },
      "StreamCount": 1,
      "ProgramCount": 1,
      "FormatName": "mov",
      "FormatLongName": "QuickTime / MOV",
      "StartTime": 0,
      "Bitrate": 13091201,
      "Duration": 15.263,
      "SemanticSimilarity": 0.855123,
      "SemanticTypes": [
        "content"
      ],
      "Elements": [
        {
          "ElementContents": [
            {
              "Type": "text",
              "Content": "文本片段",
              "URL": "http://aliyun.com",
              "TimeRange": [
                0
              ]
            }
          ],
          "ObjectId": "",
          "ElementType": "",
          "SemanticSimilarity": 0,
          "ElementRelations": [
            {
              "Type": "",
              "ObjectId": ""
            }
          ]
        }
      ],
      "SceneElements": [
        {
          "TimeRange": [
            0
          ],
          "FrameTimes": [
            0
          ]
        }
      ],
      "OCRTexts": "阿里云IMM",
      "FileStatus": "",
      "Reason": "[InternalError] The request has been failed due to some unknown error. status: 500, requestId: CC5ACFBD-BB7A-496D-A9D6-****",
      "SmartClusters": [
        {
          "SmartClusterId": "",
          "Similarity": 0
        }
      ],
      "ObjectStatus": "Indexed",
      "SequenceNumber": 3,
      "ClusterStatus": {
        "key": {
          "key": [
            ""
          ]
        }
      },
      "ClusterModifications": {
        "key": {
          "key": [
            ""
          ]
        }
      }
    },
    "BaseImages": [
      {
        "OwnerId": "102321002467****",
        "ProjectName": "test-project",
        "DatasetName": "test-dataset",
        "ObjectType": "file",
        "ObjectId": "75d5de2c50754e3dadd5c35dbca5f9949369e37eb342a73821f690c94c36c7f7",
        "UpdateTime": "2021-06-29T14:50:13.011643661+08:00",
        "CreateTime": "2021-06-29T14:50:13.011643661+08:00",
        "URI": "oss://test-bucket/test-object.jpg",
        "OSSURI": "oss://examplebucket/sampleobject.jpg",
        "Filename": "sampleobject.jpg",
        "MediaType": "image",
        "ContentType": "image/jpeg",
        "Size": 1000,
        "FileHash": "1d9c280a7c4f67f7ef873e28449dbe17",
        "FileModifiedTime": "2021-06-29T14:50:13.011643661+08:00",
        "FileCreateTime": "2021-06-29T14:50:13.011643661+08:00",
        "FileAccessTime": "2021-06-29T14:50:13.011643661+08:00",
        "ProduceTime": "2021-06-29T14:50:13.011643661+08:00",
        "LatLong": "30.134390,120.074997",
        "Timezone": "",
        "Addresses": [
          {
            "Language": "zh-Hans",
            "AddressLine": "中国浙江省杭州市余杭区文一西路969号",
            "Country": "中国",
            "Province": "浙江省",
            "City": "杭州市",
            "District": "余杭区",
            "Township": "文一西路"
          }
        ],
        "TravelClusterId": "-",
        "Orientation": 0,
        "Figures": [
          {
            "FigureId": "868a9e74-cde5-4c7a-9013-28bb984****",
            "FigureConfidence": 1,
            "FigureClusterId": "Cluster-dbe72fec-b84c-4ab6-885b-3678e64****",
            "FigureClusterConfidence": 1,
            "FigureType": "face",
            "Age": 29,
            "AgeSD": 5,
            "Gender": "female",
            "GenderConfidence": 1,
            "Emotion": "happiness",
            "EmotionConfidence": 0.70784568786621,
            "FaceQuality": 0.960875928401947,
            "Mouth": "close",
            "MouthConfidence": 1,
            "Beard": "none",
            "BeardConfidence": 1,
            "Hat": "none",
            "HatConfidence": 1,
            "Mask": "none",
            "MaskConfidence": 1,
            "Glasses": "none",
            "GlassesConfidence": 0.8,
            "Sharpness": 0.7,
            "Attractive": 0.96,
            "HeadPose": {
              "Pitch": 18.385589599609375,
              "Roll": 4.204030513763428,
              "Yaw": 2.4945924282073975
            }
          }
        ],
        "FigureCount": 10,
        "Labels": [
          {
            "Language": "zh-Hans",
            "LabelName": "椅子",
            "LabelLevel": 2,
            "LabelConfidence": 0.95,
            "ParentLabelName": "家具",
            "CentricScore": 0.877
          }
        ],
        "Title": "test",
        "ImageWidth": 270,
        "ImageHeight": 500,
        "EXIF": "{\"Compression\":{\"value\":\"6\"},\"DateTime\":{\"value\":\"2020:08:19 17:11:11\"}}",
        "ImageScore": {
          "OverallQualityScore": 0.736
        },
        "CroppingSuggestions": [
          {
            "AspectRatio": "2:3",
            "Confidence": 0.742
          }
        ],
        "OCRContents": [
          {
            "Language": "zh-hans",
            "Contents": "欢迎使用智能媒体管理",
            "Confidence": 0.8254936695098877
          }
        ],
        "VideoWidth": 1080,
        "VideoHeight": 1920,
        "VideoStreams": [
          {
            "Index": 0,
            "Language": "en",
            "CodecName": "h264",
            "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
            "Profile": "High",
            "CodecTimeBase": "1373627/83160000",
            "CodecTagString": "avc1",
            "CodecTag": "0x31637661",
            "Width": 1280,
            "Height": 720,
            "HasBFrames": 2,
            "SampleAspectRatio": "1:1",
            "DisplayAspectRatio": "16:9",
            "PixelFormat": "yuv420p",
            "Level": 40,
            "FrameRate": "25/1",
            "AverageFrameRate": "25/1",
            "TimeBase": "1/12800",
            "StartTime": 0,
            "Duration": 22.88,
            "Bitrate": 5407765,
            "FrameCount": 572,
            "Rotate": "90",
            "BitDepth": 8,
            "ColorSpace": "bt709",
            "ColorRange": "tv",
            "ColorTransfer": "bt709",
            "ColorPrimaries": "bt709"
          }
        ],
        "Subtitles": [
          {
            "Index": 2,
            "Language": "en",
            "CodecName": "mov_text",
            "CodecLongName": "MOV text",
            "CodecTagString": "tx3g",
            "CodecTag": "0x67337874",
            "StartTime": 0,
            "Duration": 71.378,
            "Bitrate": 74,
            "Content": "欢迎",
            "Width": 600,
            "Height": 30
          }
        ],
        "AudioStreams": [
          {
            "Index": 1,
            "Language": "en",
            "CodecName": "aac",
            "CodecLongName": "AAC (Advanced Audio Coding)",
            "CodecTimeBase": "1/44100",
            "CodecTagString": "mp4a",
            "CodecTag": "0x6134706d",
            "TimeBase": "1/48000",
            "StartTime": 0.0235,
            "Duration": 3.690667,
            "Bitrate": 320087,
            "FrameCount": 173,
            "Lyric": "test",
            "SampleFormat": "fltp",
            "SampleRate": 48000,
            "Channels": 2,
            "ChannelLayout": "stereo"
          }
        ],
        "Artist": "Jane",
        "AlbumArtist": "Jane",
        "AudioCovers": [
          {
            "ImageWidth": 500,
            "ImageHeight": 820,
            "EXIF": "{\"FileSize\":{\"value\":\"29304\"},\"Format\":{\"value\":\"jpg\"}}",
            "CroppingSuggestions": [],
            "OCRContents": []
          }
        ],
        "Composer": "Jane",
        "Performer": "Jane",
        "Language": "eng",
        "Album": "FirstAlbum",
        "PageCount": 5,
        "ETag": "\"1D9C280A7C4F67F7EF873E28449****\"",
        "CacheControl": "no-cache",
        "ContentDisposition": "attachment; filename =test.jpg",
        "ContentEncoding": "UTF-8",
        "ContentLanguage": "zh-CN",
        "AccessControlAllowOrigin": "https://aliyundoc.com",
        "AccessControlRequestMethod": "PUT",
        "ServerSideEncryptionCustomerAlgorithm": "SM4",
        "ServerSideEncryption": "AES256",
        "ServerSideDataEncryption": "SM4",
        "ServerSideEncryptionKeyId": "9468da86-3509-4f8d-a61e-6eab1eac****",
        "OSSStorageClass": "Standard",
        "OSSCRC64": "559890638950338001",
        "ObjectACL": "default",
        "ContentMd5": "HZwoCnxPZ/fvhz4oRJ2+Fw==",
        "OSSUserMeta": {
          "key": "val"
        },
        "OSSTaggingCount": 2,
        "OSSTagging": {
          "key": "val"
        },
        "OSSExpiration": "2120-01-01T12:00:00.000Z",
        "OSSVersionId": "CAEQNhiBgMDJgZCA0BYiIDc4MGZjZGI2OTBjOTRmNTE5NmU5NmFhZjhjYmY0****",
        "OSSDeleteMarker": "CAEQMhiBgIDXiaaB0BYiIGQzYmRkZGUxMTM1ZDRjOTZhNjk4YjRjMTAyZjhl****",
        "OSSObjectType": "Normal",
        "CustomId": "\t\nmember-image-id-0001",
        "CustomLabels": {
          "MemberName": "Tim",
          "Enabled": "True",
          "ItemCount": "10"
        },
        "StreamCount": 1,
        "ProgramCount": 1,
        "FormatName": "mov",
        "FormatLongName": "QuickTime / MOV",
        "StartTime": 0,
        "Bitrate": 13091201,
        "Duration": 15.263,
        "SemanticSimilarity": 0.855123,
        "SemanticTypes": [
          "content"
        ],
        "Elements": [
          {
            "ElementContents": [
              {
                "Type": "text",
                "Content": "文本片段",
                "URL": "http://aliyun.com",
                "TimeRange": [
                  0
                ]
              }
            ],
            "ObjectId": "",
            "ElementType": "",
            "SemanticSimilarity": 0,
            "ElementRelations": [
              {
                "Type": "",
                "ObjectId": ""
              }
            ]
          }
        ],
        "SceneElements": [
          {
            "TimeRange": [
              0
            ],
            "FrameTimes": [
              0
            ]
          }
        ],
        "OCRTexts": "阿里云IMM",
        "FileStatus": "",
        "Reason": "[InternalError] The request has been failed due to some unknown error. status: 500, requestId: CC5ACFBD-BB7A-496D-A9D6-****",
        "SmartClusters": [
          {
            "SmartClusterId": "",
            "Similarity": 0
          }
        ],
        "ObjectStatus": "Indexed",
        "SequenceNumber": 3,
        "ClusterStatus": {
          "key": {
            "key": [
              ""
            ]
          }
        },
        "ClusterModifications": {
          "key": {
            "key": [
              ""
            ]
          }
        }
      }
    ],
    "CustomId": "abc",
    "CustomLabels": {
      "Bucket": "examplebucket"
    },
    "MetaLockVersion": 0
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
暂无变更历史