调用本接口向指定的相似图库中添加样本图片。

描述

业务接口/green/similarity/image/add

添加相似图样本时,您可以为图片设置标签;如果样本图片在检索时被命中,其标签信息也会被返回。

新增相似图样本在1分钟之内生效。

关于图片的限制
  • 图片链接支持以下协议:HTTP和HTTPS。
  • 图片支持以下格式:PNG、JPG、JPEG、BMP、GIF、WEBP。
  • 图片大小限制为10MB以内。如您有特殊需求(大图片),可以提工单进行调整。
  • 图片下载时间限制为3s内,如果下载时间超过3s,将返回下载超时。
  • 图片像素建议不低于256*256,像素过低可能会影响识别效果。

请求参数

关于公共请求参数,请参见公共参数

请求body是一个JSON对象,字段说明如下:

名称 类型 是否必需 描述
tasks JSON数组 要增加的图片样本列表。每个元素是个结构体,具体结构描述见task
library 字符串 要操作的图库的名称。如果不指定该参数,那么图片样本将被添加到默认图库中。默认图库名称为default。
表 1. task
名称 类型 是否必需 描述
dataId 字符串 该样本在您的业务系统里的唯一ID。例如,您可以指定该样本ID为"1"、"s-001"等。
url 字符串 样本图片的URL。
tags JSON数组 为该样本图片设置标签。每个元素是字符串,最多允许设置3个标签值。例如,您可以为样本图片添加["涉黄", "渉政"]标签。
说明 在命中该样本时,会返回相应的标签信息。

返回参数

关于返回参数的说明,请参见返回结果

返回body中的data字段是JSON数组,每一个元素包含如下字段:

名称 类型 是否必需 描述
code 整型 错误码,和HTTP的status code一致。
msg 字符串 错误描述信息。
dataId 字符串 对应请求中的dataId
url 字符串 对应请求中的url

示例

请求示例

{
  "tasks": [
    {
      "dataId": "1",
      "url": "http://foo.bar/1.jpg",
      "tags": ["涉黄", "渉政"]
    },
    {
      "dataId": "2",
      "url": "http://foo.bar/2.jpg",
      "tags": ["涉黄", "渉政"]
    }
  ],
  "library":"test"
}

返回示例

{
  "msg": "OK", 
  "code": 200, 
  "requestId": "33921869-CF8A-4E62-8C31-44F37341FFC1",
  "data": [
    { 
      "code": 200, 
      "msg": "OK",
      "dataId": "1",
      "url": "http://foo.bar/1.jpg"
    },
    { 
      "code": 200, 
      "msg": "OK",
      "dataId": "2",
      "url": "http://foo.bar/2.jpg"
    }
  ]
}