CreateSimilarImageClusterTask - 创建相似图片聚类任务

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

接口说明

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

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

使用步骤:

  • 创建相似图片聚类任务
  • 通过 GetTaskStatus 接口查询相似图片聚类任务是否执行完成
  • 通过 SearchSimilarImageClusters 接口获取相似图片聚类结果

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

调试

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

授权信息

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

请求语法

POST /v2/image/create_similar_image_cluster_task HTTP/1.1

请求参数

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

请求体

drive_idstring

空间 id

123

返回参数

名称类型描述示例值
object

返回参数

task_idstring

任务 id

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

示例

正常返回示例

JSON格式

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

错误码

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