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

描述

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

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

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

待检测图片需要满足以下要求:
  • 图片链接支持以下协议:HTTP和HTTPS。
  • 图片支持以下格式:PNG、JPG、JPEG、BMP、GIF、WEBP。
  • 图片大小限制为10MB以内(适用于同步和异步调用)。如您有特殊需求(大图片),可以提工单进行调整。
  • 图片下载时间限制为3秒内,如果下载时间超过3秒,返回下载超时。
  • 图片像素建议不低于256*256,像素过低可能会影响识别效果。
  • 图片检测接口响应时间依赖图片的下载时间。请保证被检测图片所在的存储服务稳定可靠,建议您使用阿里云OSS存储或者CDN缓存等。

请求参数

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

返回参数

名称 类型 是否必须 描述
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"
        }
    ]
}