全部产品
Search
文档中心

网盘与相册服务:CreateSimilarImageClusterTask - 创建相似图片聚类任务

更新时间:Apr 09, 2026

用户可以发起创建相似图片聚类任务,该任务会将指定 drive 空间下相似的图片聚类在一起。

接口说明

请确保在使用该接口前,已充分了解 PDS 的收费方式和价格

使用此功能须开通增值服务图片处理功能,此功能目前限时免费。

使用步骤:

  • 创建相似图片聚类任务

  • 通过 GetTaskStatus 接口查询相似图片聚类任务是否执行完成

  • 通过 SearchSimilarImageClusters 接口获取相似图片聚类结果

同一 drive 同一时刻只能有一个相似图片聚类任务运行,若上一任务未结束,再次调用相似图片聚类任务会返回失败。

调试

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

调试

授权信息

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

请求语法

POST /v2/image/create_similar_image_cluster_task HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

body

object

请求体

drive_id

string

空间 id

123

返回参数

名称

类型

描述

示例值

object

返回参数

task_id

string

任务 id

i:SimilarImageClustering-b67d53e7-2fe8-460f-9b95-1e93636923eb

示例

正常返回示例

JSON格式

{
  "task_id": "i:SimilarImageClustering-b67d53e7-2fe8-460f-9b95-1e93636923eb"
}

错误码

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

变更历史

更多信息,参考变更详情