调用API从相似图库删除样本图片-内容安全-阿里云-AI 安全护栏(AI Guardrails)-阿里云帮助中心

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

使用说明

业务接口：/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"
        }
    ]
}