调用QuerySimilarImageClusters查询相似图片聚类_智能媒体管理(IMM)-阿里云帮助中心

查询相似图片聚类列表信息。

接口说明

请确保在使用该接口前，已充分了解智能媒体管理产品的收费方式和价格。
调用该接口前，请先通过 CreateSimilarImageClusteringTask 接口对数据集中的图片进行相似图片聚类。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
ProjectName	string	是	项目名称，获取方式请参见创建项目。	test-project
DatasetName	string	是	数据集名称，获取方式请参见创建数据集。	test-dataset
NextToken	string	否	翻页标记。当文件总数大于设置的 MaxResults 时，用于翻页的 Token。从 NextToken 开始按字典序返回文件信息列表。说明在一次查询中首次调用此接口时，将此值设置为空。	CAESEgoQCg4KClVwZGF0ZVRpbWUQARgBIs8ECgkAAJLUwUCAQ****
MaxResults	integer	否	返回聚类列表中最大任务数量。取值范围为（0，100 ]，默认值为 100。	20
CustomLabels	string	否	自定义标签，用于根据标签过滤任务。	{"key": "val"}
Sort	string	否	排序字段，可选值如下： CreateTime：分类的创建时间。 UpdateTime：分类的更新时间（默认）。	UpdateTime
Order	string	否	排序方式。取值范围如下： asc：升序。 desc：降序（默认）。	asc

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	CA995EFD-083D-4F40-BE8A-BDF75FFF****
SimilarImageClusters	array	相似图片分类列表。
	SimilarImageCluster	相似图片分类具体信息。
NextToken	string	翻页标记。当聚类列表总数大于设置的 MaxResults 时，用于翻页的 Token。符合条件的聚类列表未全部返回时，此参数才有值。下一次查询聚类时将此值作为 NextToken 传入，将后续的聚类列表返回。	CAESEgoQCg4KClVwZGF0ZVRpbWUQARgBIs8ECgkAAJLUwUCAQ****

示例

正常返回示例

JSON格式

{
  "RequestId": "CA995EFD-083D-4F40-BE8A-BDF75FFF****\n",
  "SimilarImageClusters": [
    {
      "ObjectId": "SimilarImageCluster-748a041e-4ebc-4487-9e74-9c89b1****",
      "UpdateTime": "2023-02-08T09:42:34.354969088+08:00",
      "CreateTime": "2023-02-08T09:42:34.354969088+08:00",
      "CustomLabels": {
        "test": "test",
        "test2": 1
      },
      "Files": [
        {
          "URI": "oss://test-bucket/test-object",
          "ImageScore": 0.709
        }
      ]
    }
  ],
  "NextToken": "CAESEgoQCg4KClVwZGF0ZVRpbWUQARgBIs8ECgkAAJLUwUCAQ****"
}

错误码

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

变更历史

变更时间

变更内容概要

操作

2024-04-19

API 内部配置变更，不影响调用

看变更集

变更项	变更内容
	API 内部配置变更，不影响调用。