视觉相似性

注意

Content and Commerce AI 是贝塔。文档可能会更改。

当给定图像时,视觉相似性服务会自动从目录中找到视觉相似的图像。

此文档中显示的示例请求中使用了以下图像:

测试图像

API格式

POST /services/v1/predict

请求

以下请求根据在有效负荷中提供的输入参数从目录中检索视觉上相似的图像。 有关所示输入参数的详细信息,请参阅示例有效负荷下表。

注意

analyzer_id 确定 Sensei Content Framework 使用的。在发出请求之前,请检查您是否有正确的analyzer_id。 请与内容和商务AI测试版团队联系,以接收此服务的analyzer_id

curl -i -X POST https://sensei.adobe.io/services/v1/predict \
  -H 'Authorization: Bearer $API_TOKEN' \
  -H 'Content-Type: multipart/form-data' \
  -H 'cache-control: no-cache,no-cache' \
  -H 'x-api-key: $API_KEY' \
  -F file=@test_image.jpg \
  -F 'contentAnalyzerRequests={
   "enable_diagnostics":"true",
   "requests":[
     {
         "analyzer_id": "Feature:cintel-deep-product-search:Service-316a8cf750c6440396061c8f73a7a585",
         "parameters": {
          "application-id": "1234", 
          "content-type": "inline", 
          "encoding": "jpeg", 
          "threshold": "0", 
          "top-N": "0", 
          "custom": {}, 
          "data": [{
            "content-id": "0987", 
            "content": "inline-image", 
            "content-type": "inline", 
            "encoding": "jpeg", 
            "threshold": "0", 
            "top-N": "0", 
            "historic-metadata": [], 
            "custom": {}
            }]
          }
      }
    ]
}'
属性 描述 必填
analyzer_id 您的请求部署到的Sensei服务ID。 此ID决定使用哪个Sensei Content Frameworks。 有关自定义服务,请联系内容和商务AI团队以设置自定义ID。
application-id 您创建的应用程序的ID。
data 一个数组,其中包含一个JSON对象,数组中每个对象都表示一个图像。 作为此数组的一部分传递的任何参数都将覆盖在data数组外部指定的全局参数。 下表中列出的所有其余属性都可从data中覆盖。
content-id 响应中返回的数据元素的唯一ID。 如果未传递,则分配一个自动生成的ID。
content 待分析的内容由视觉相似性服务进行。 在图像是请求主体一部分的事件下,在curl命令中使用-F file=@<filename>传递图像,将此参数保留为空字符串。
如果图像是S3上的文件,请传递已签名的url。当内容是请求主体的一部分时,数据元素的列表应仅包含一个对象。 如果传递了多个对象,则只处理第一个对象。
content-type 用于指示输入是请求主体的一部分还是S3存储段的已签名URL。 此属性的默认值为inline
encoding 输入图像的文件格式。 目前只能处理JPEG和PNG图像。 此属性的默认值为jpeg
threshold 需要返回结果的分数阈值(0到1)。 使用值0返回所有结果。 此属性的默认值为0
top-N 要返回的结果数(不能为负整数)。 使用值0返回所有结果。 与threshold一起使用时,返回的结果数是任一限制集中的较小者。 此属性的默认值为0
custom 要传递的任何自定义参数。
historic-metadata 可传递元数据的数组。

响应

成功的响应会返回一个response数组,该数组包含feature_valuefeature_name,分别用于目录中找到的每个视觉相似的图像。

以下示例响应中返回了以下看上去相似的图像:

相似图像

{
  "status": 200,
  "content_id": "test_image.jpg",
  "cas_responses": [
    {
      "status": 200,
      "analyzer_id": "Feature:cintel-deep-product-search:Service-316a8cf750c6440396061c8f73a7a585",
      "content_id": "test_image.jpg",
      "result": {
        "response_type": "feature",
        "response": [
          {
            "feature_value": [
              {
                "feature_value": "678",
                "feature_name": "G34WS945.F1"
              },
              {
                "feature_value": "678",
                "feature_name": "1431RDM JANELLE RAW JACKE"
              },
              {
                "feature_value": "657",
                "feature_name": "GF4045877841 CARLA FLR"
              },
              {
                "feature_name": "1707-686-SGU PATCH XYZ",
                "feature_value": "657"
              },
              {
                "feature_name": "5495MJT AJA BLK",
                "feature_value": "646"
              },
              {
                "feature_name": "IDEAL",
                "feature_value": "645"
              },
              {
                "feature_value": "644",
                "feature_name": "HCAJRA439 CALI JEAN"
              },
              {
                "feature_name": "KT279RK-ONL",
                "feature_value": "644"
              },
              {
                "feature_name": "SP190404-ELLIS",
                "feature_value": "642"
              },
              {
                "feature_name": "GF4174848718 KENDALL DIS",
                "feature_value": "640"
              }
            ],
            "feature_name": "visual_similarity"
          }
        ]
      }
    }
  ],
  "error": []
}

在此页面上