tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
数据万象
    文档
    Download PDF

    图片搜索接口

    最后更新时间：2024-01-20 09:22:44
    下载PDF

      功能描述

      该接口用于检索图片。

      请求

      请求示例

      GET /<ObjectKey>?ci-process=ImageSearch&action=SearchImage&MatchThreshold=&Offset= HTTP/1.1
      Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
      Date: <GMT Date>
      Authorization: <Auth String>
      Content-Length: <length>
      Content-Type: application/xml
      
      <body>
      说明：
      Authorization: Auth String （详情请参见 请求签名 文档）。

      请求参数

      参数的具体内容如下：
      节点名称（关键字）
      描述
      类型
      是否必选
      MatchThreshold
      出参 Score 中，只有超过 MatchThreshold 值的结果才会返回。默认为0
      Int
      否
      Offset
      起始序号，默认值为0
      Int
      否
      Limit
      返回数量，默认值为10，最大值为100
      Int
      否
      Filter
      针对入库时提交的 Tags 信息进行条件过滤。支持>、>=、<、<=、=、!=，多个条件之间支持 AND 和 OR 进行连接
      String
      否

      请求头

      此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。

      请求体

      该请求无请求体。

      响应

      响应头

      此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。

      响应体

      该响应体返回为 application/xml 数据，包含完整节点数据的内容展示如下：
      <Response>
          <Count>2</Count>
          <ImageInfos>
              <EntityId>apple</EntityId>
              <PicName>ObjectKey1</PicName>
              <Score>99</Score>
              <CustomContent>XXX</CustomContent>
              <Tags>{"key1":"value1","key2":"value2"}</Tags>
          </ImageInfos>
          <ImageInfos>
              <EntityId>apple</EntityId>
              <PicName>ObjectKey2</PicName>
              <Score>90</Score>
              <CustomContent>XXX</CustomContent>
              <Tags>{"key1":"value1","key2":"value2"}</Tags>
          </ImageInfos>
      </Response>
      具体的数据内容如下：
      节点名称（关键字）
      父节点
      描述
      类型
      Response
      无
      保存结果的容器
      Container
      Response 节点的内容：
      节点名称（关键字）
      父节点
      描述
      类型
      RequestId
      Response
      请求的唯一 ID
      String
      Count
      Response
      数量
      Int
      ImageInfos
      Response
      图片信息
      Container
      ImageInfos 节点为数组，其中每一项内容为
      节点名称（关键字）
      父节点
      描述
      类型
      EntityId
      ImageInfos
      物品 ID
      String
      CustomContent
      ImageInfos
      图片自定义的内容
      String
      Tags
      ImageInfos
      自定义标签信息，json 字符串
      String
      PicName
      ImageInfos
      图片名称
      String
      Score
      ImageInfos
      相似度
      Int

      错误码

      此接口遵循统一的错误响应和错误码，详情请参见 错误码 文档。

      实际案例

      请求

      GET /<ObjectKey>?ci-process=ImageSearch&action=SearchImage&MatchThreshold=10&Offset=2 HTTP/1.1
      Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1558699190;1558706390&q-key-time=1558699190;1558706390&q-header-list=date;host&q-url-param-list=&q-signature=89fa1f6a56c34e460f3db4d65f928eaf034a****
      Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
      Content-Length: 0
      Content-Type: application/xml

      响应

      HTTP/1.1 200 OK
      Content-Type: application/xml
      Content-Length: 150
      Connection: keep-alive
      Date: Thu, 15 Jun 2017 12:37:29 GMT
      Server: tencent-ci
      x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****
      
      <Response>
          <Count>2</Count>
          <ImageInfos>
              <EntityId>apple</EntityId>
              <PicName>ObjectKey</PicName>
              <Score>99</Score>
              <CustomContent>XXX</CustomContent>
              <Tags>{"key1":"value1","key2":"value2"}</Tags>
          </ImageInfos>
          <ImageInfos>
              <EntityId>apple</EntityId>
              <PicName>ObjectKey2</PicName>
              <Score>90</Score>
              <CustomContent>XXX</CustomContent>
              <Tags>{"key1":"value1","key2":"value2"}</Tags>
          </ImageInfos>
      </Response>
      
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款