查询相似图片聚类列表信息。
接口说明
-
请确保在使用该接口前,已充分了解智能媒体管理产品的收费方式和价格。
-
调用该接口前,请先通过 CreateSimilarImageClusteringTask 接口对数据集中的图片进行相似图片聚类。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
imm:QuerySimilarImageClusters |
list |
*Dataset
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| 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 |
否 |
排序字段,可选值如下:
|
UpdateTime |
| Order |
string |
否 |
排序方式。取值范围如下:
|
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****"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。