调用本接口从指定的相似图库中移除相似图样本。

使用说明

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

移除操作在1分钟之内生效。一次最多允许移除100张样本图片。

您可以调用该接口指定的相似图库中移除相似图样本。关于如何构造HTTP请求,请参见请求结构;您也可以直接选用已构造好的HTTP请求,更多信息,请参见SDK概览

QPS限制

本接口的单用户QPS限制为20次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。

请求参数

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

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

名称 类型 是否必选 示例值 描述
dataIds JSONArray ["1", "2"] 要移除的样本图片的dataId列表。每个元素是字符串类型,一次最多允许移除100张样本图片。
说明 如果指定了该参数,则不用指定urls
urls JSONArray ["http://example.com/427945583303_5.jpe", "http://example.com/09850722457524.jpg"] 要移除的样本图片的URL列表。每个元素是字符串类型,一次最多允许移除100张样本图片。
说明 如果指定了该参数,则不用指定dataIds
library String test 要操作的图库的名称。如果不指定该参数,即从默认图库中删除图片样本。默认图库的名称为default。

返回数据

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

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

名称 类型 示例值 描述
code Integer 200 错误码,和HTTP状态码一致。

更多信息,请参见公共错误码

msg String OK 请求信息的响应消息。
dataId String 2 对应请求中的dataId
url String http://example.com/09850722457524.jpg 对应请求中的url

示例

请求示例

http(s)://[Endpoint]/green/similarity/image/delete
&<公共请求参数>
{
  "dataIds": ["1", "2"],
  "library":"test"
}

返回示例

{
  "msg": "OK", 
  "code": 200, 
  "requestId": "33921869-CF8A-4E62-8C31-44F37341FFC1",
  "data":[
        {
            "code":200,
            "msg":"OK",
            "dataId":"1",
            "url":"http://example.com/427945583303_5.jpeg"
        },
        {
            "code":200,
            "msg":"OK",
            "dataId":"2",
            "url":"http://example.com/09850722457524.jpg"
        }
    ]
}