列举标签分组。
接口说明
标签分组接口结果是一次性返回指定的 drive 内聚合的结果,按照分组内照片数取前 top2000 个返回。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求语法
POST /v2/image/list_tags HTTP/1.1
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
body | object | 否 | 请求体参数。 | |
drive_id | string | 是 | 空间 id | 1 |
image_thumbnail_process | string | 否 | 图片缩略图处理 | image/resize,w_200 |
video_thumbnail_process | string | 否 | 视频缩略图处理 | video/snapshot,t_7000,f_jpg,w_800,h_600,m_fast |
返回参数
示例
正常返回示例
JSON
格式
{
"tags": [
{
"name": "动物",
"count": 1,
"cover_url": "https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx",
"cover_file_id": "5d79206586bb5dd69fb34c349282718146c55da7",
"cover_file_category": "image",
"cover_tag_confidence": 1,
"cover_overall_score": 0.736
}
]
}
错误码
访问错误中心查看更多错误码。