用户可以发起创建相似图片聚类任务,该任务会将指定 drive 空间下相似的图片聚类在一起。
接口说明
请确保在使用该接口前,已充分了解 PDS 的收费方式和价格。
使用此功能须开通增值服务图片处理功能,此功能目前限时免费。
使用步骤:
创建相似图片聚类任务
通过 GetTaskStatus 接口查询相似图片聚类任务是否执行完成
通过 SearchSimilarImageClusters 接口获取相似图片聚类结果
同一 drive 同一时刻只能有一个相似图片聚类任务运行,若上一任务未结束,再次调用相似图片聚类任务会返回失败。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
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"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。