调用本接口向相似图库中增加相似图样本。

描述

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

增加相似图样本时,您可以为其指定标签(即请求参数中的tags);样本被命中后,其标签信息也会被返回。

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

请求参数

关于在请求中必须包含的公共请求参数,请参考公共参数

请求body是一个JSON对象,字段说明如下:
名称 类型 是否必需 描述
tasks JSON数组 要增加的样本图片列表。每个元素是个结构体,具体结构见task
表 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": ["涉黄", "渉政"]
    }
  ]
}
返回示例
{
  "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"
    }
  ]
}