调用本接口从指定的相似图库中移除相似图样本。
使用说明
业务接口:/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"
}
]
}