调用SearchSimilarImageClusters查询相似图片聚类结果_网盘与相册服务(PDS)-阿里云帮助中心

获取指定 drive 空间下的相似图片。

接口说明

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

使用此功能须开通增值服务图片处理功能。

查询相似图片聚类结果前，需调用 CreateSimilarImageClusterTask 接口创建相似图片聚类任务，拿到 task_id，通过 GetTaskStatus 接口查询该聚类任务是否成功。待聚类任务成功后，再通过 SearchSimilarImageClusters 接口获取相似图片结果。

注意 - 未执行聚类任务调用该接口返回空列表。 - 相似图片聚类任务是增量更新聚类结果。若本次聚类任务未完成，则返回上一次聚类结果。

调试

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

调试

授权信息

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

请求语法

POST /v2/image/query_similar_image_clusters HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求参数
drive_id	string	是	空间 id	1
marker	string	否	分页标记，从指定位置查询结果。若为空则表示从头开始查询。	YWRzX3VzZXJfcHJvZmlsZV9je1bnQh***
limit	long	否	限定此次返回结果的数量，取值范围[1,100]，默认 50。返回结果可以小于指定的数量，但不能多于指定的数量。	50
order	string	否	排序顺序枚举值： asc：升序。 desc：降序。	desc
image_thumbnail_process`deprecated`	string	否	图片缩略图处理样式	image/resize,m_fill,h_128,w_128,limit_0/format,jpg

返回参数

名称	类型	描述	示例值
	object	返回参数
similar_image_clusters	array<object>	相似图片聚类列表
	object	相似图片聚类详情
files	array	相似图片列表
	File	文件详情
next_marker	string	用作下次遍历的 marker	NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0***

示例

正常返回示例

JSON格式

{
  "similar_image_clusters": [
    {
      "files": [
        {
          "domain_id": "bj1",
          "drive_id": "1",
          "file_id": "5d79206586bb5dd69fb34c349282718146c55da7",
          "name": "1.mov",
          "type": "file",
          "content_type": "application/json",
          "created_at": "2019-08-20T06:51:27.292Z",
          "updated_at": "2019-08-20T06:51:27.292Z",
          "description": "image file",
          "trashed_at": "2019-08-20T06:51:27.292Z",
          "file_extension": "txt",
          "mime_type": "video/quicktime",
          "mime_extension": "mov",
          "hidden": false,
          "size": 1024,
          "starred": false,
          "status": "available",
          "user_meta": "k1=v1,k2=v2",
          "labels": [
            "[\"label1:1\", \"label2:2\"]"
          ],
          "upload_id": "C9DCFE5A82644AC7A02DB74C30C934A6",
          "parent_file_id": "3d5b846942cf94fa72324c8a4bda34e81da635a",
          "crc64_hash": "3574582125365864471",
          "content_hash": "EA4942AA8761213890A5C386F88E6464D2C31CA3",
          "content_hash_name": "sha1",
          "download_url": "https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx",
          "thumbnail": "https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx",
          "category": "image",
          "local_created_at": "2019-08-20T06:51:27.292Z",
          "local_modified_at": "2019-08-20T06:51:27.292Z",
          "revision_id": "5d5b846942cf94fa72324c14a4bda34e81da635d",
          "investigation_info": {
            "status": 4,
            "suggestion": "pass"
          },
          "thumbnail_urls": {
            "key": "\"128X128\": \"https://url1\", \"800X800\": \"url2\""
          },
          "image_media_metadata": {
            "time": "2006-01-02T15:04:05.000Z07:00",
            "width": 1024,
            "height": 1024,
            "location": "30.185453,120.218522",
            "country": "China",
            "province": "Zhejiang",
            "city": "Hangzhou",
            "district": "Xihu",
            "township": "Xihu",
            "address_line": "Zhejiang hangzhou xihu",
            "image_tags": [
              {
                "confidence": 0.98,
                "parent_name": "sport",
                "name": "basketball",
                "tag_level": 3,
                "source": "play basketball",
                "centric_score": 0.877
              }
            ],
            "faces": "[{\"FaceId\":\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\",\"GroupId\":\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\",\"FaceConfidence\":0.999,\"Age\":13,\"AgeConfidence\":4,\"Gender\":\"female\",\"GenderConfidence\":1,\"Emotion\":\"none\",\"EmotionConfidence\":0.672,\"FaceAttributes\":{\"Mask\":\"none\",\"MaskConfidence\":0.894,\"Beard\":\"none\",\"BeardConfidence\":0.997,\"Glasses\":\"none\",\"GlassesConfidence\":0.999,\"Mouth\":\"close\",\"MouthConfidence\":0.937,\"Hat\":\"none\",\"HatConfidence\":0.998,\"HeadPose\":{\"Pitch\":10.684,\"Roll\":-10.707,\"Yaw\":-20.094},\"FaceBoundary\":{\"Width\":457,\"Height\":687,\"Top\":1324,\"Left\":1356}}}]",
            "faces_thumbnail": [
              {
                "face_id": "a9a66a86-73dd-4c95-8b79-1d8a49db5226",
                "face_group_id": "Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0",
                "face_thumbnail": "https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2"
              }
            ],
            "exif": "{\"Compression\":{\"value\":\"6\"},\"DateTime\":{\"value\":\"2020:08:19 17:11:11\"}}",
            "image_quality": {
              "overall_score": 0.736
            }
          },
          "ex_fields_info": {
            "key": ""
          },
          "content_uri": "",
          "streams_info": {
            "key": {
              "crc64_hash": "",
              "size": 0,
              "content_hash": "",
              "content_hash_name": "",
              "download_url": "",
              "url": "",
              "thumbnail": ""
            }
          },
          "user_tags": {
            "key": "\"k1\":\"v1\", \"k2\",\"v2\""
          },
          "revision_version": 1,
          "video_media_metadata": {
            "time": "2006-01-02T15:04:05.000Z07:00",
            "width": 1920,
            "height": 1080,
            "location": "30.185453,120.218522",
            "country": "China",
            "province": "Zhejiang",
            "city": "Hangzhou",
            "district": "Xihu",
            "township": "Xihu",
            "address_line": "Zhejiang hangzhou xihu",
            "video_media_video_stream": [
              {
                "duration": "22.88",
                "bitrate": "108420",
                "code_name": "h264",
                "frame_count": "90"
              }
            ],
            "video_media_audio_stream": [
              {
                "duration": "7704.573000",
                "bit_rate": "129280",
                "code_name": "aac"
              }
            ]
          },
          "punish_flag": 1,
          "id_path": "id1/id2",
          "name_path": "root/f1/f2",
          "creator_type": "",
          "creator_id": "c9b7a5aa04d14ae3867fdc886fa01da4",
          "creator_name": "AB***CD",
          "last_modifier_type": "",
          "last_modifier_id": "c9b7a5aa04d14ae3867fdc886fa01da4",
          "last_modifier_name": "AB***CD",
          "dir_size_info": {
            "dir_count": 1,
            "file_count": 10
          },
          "trashed": true,
          "action_list": [
            ""
          ],
          "location": "",
          "semantic_result": {
            "semantic_similarity": 0.879,
            "document_contents": [
              {
                "element_contents": [
                  {
                    "type": "text",
                    "content": "文本片段",
                    "url": "http://aliyun.com",
                    "time_range": [
                      0
                    ]
                  }
                ]
              }
            ],
            "scene_contents": [
              {
                "time_range": [
                  0
                ],
                "key_frames": [
                  {
                    "frame_time": 1000,
                    "thumbnail_url": "http://aliyun.com"
                  }
                ],
                "thumbnail_url": "http://aliyun.com"
              }
            ]
          },
          "sync_flag": true,
          "sync_device_flag": true,
          "origin_parent_file_id": ""
        }
      ]
    }
  ],
  "next_marker": "NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0***"
}

错误码

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