用户可以发起创建相似图片聚类任务,该任务会将指定 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 |
返回参数
示例
正常返回示例
JSON
格式
{
"task_id": "i:SimilarImageClustering-b67d53e7-2fe8-460f-9b95-1e93636923eb"
}
错误码
访问错误中心查看更多错误码。