如何使用图片审核增强版API - 内容安全

API功能介绍

图片审核2.0版API用于识别图像中是否有违反网络内容传播相关规定、影响平台内容秩序、影响用户体验的内容或元素，支持40+的内容风险标签和40+风险管控项。通过内容安全的图片审核2.0版，您可以根据业务所处的行业场景规范或平台内容治理规则，基于API返回的丰富的风险标签和置信分，对具体图片内容制定进一步的审核或治理措施。更多介绍，请参见图片审核2.0版介绍及计费说明。

接入指引

注册阿里云账号：立即注册，按照操作提示完成账号注册。
开通内容安全按量付费：请确保您已开通服务，开通不收费，接口接入使用后系统会按使用量自动出账，详情请参见计费说明。
创建AccessKey：请确保您已通过RAM创建AccessKey，如果您使用的是子账号AccessKey，您需要通过主账号给子账号赋予AliyunYundunGreenWebFullAccess权限，具体操作，请参见RAM授权。
开发接入：推荐使用SDK方式调用，具体方法请详见图片审核2.0版接入指南。

使用说明

您可以调用该接口创建图片内容检测任务。关于如何构造HTTP请求，请参见HTTP原生调用；您也可以直接选用已构造好的HTTP请求，更多信息，请参见接入指南。

业务接口：ImageModeration
支持的地域及接入地址：
地域
外网接入地址
内网接入地址
支持服务
新加坡
https://green-cip.ap-southeast-1.aliyuncs.com
https://green-cip-vpc.ap-southeast-1.aliyuncs.com
baselineCheck_global
计费信息：
该接口为收费接口。仅对HTTP状态码为200的请求进行计量计费，产生其他错误码时不会计费。关于计费方式，请参见计费说明。
图片要求：
- 图片支持以下格式：PNG、JPG、JPEG、BMP、WEBP、TIFF、SVG、HEIC（该格式最长边需小于8192 px）、GIF（取第一帧）、ICO（取最后一图）。
- 图片大小限制在20 MB以内，高或者宽不能超过30000 px，且总像素不能超过2.5亿 px。像素建议大于200*200（px），像素过低会影响内容安全检测算法的效果。
- 图片下载时间限制为3秒内，如果下载时间超过3秒，返回下载超时。

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。如果您业务量级较大或者有紧急扩容需求需要更大QPS，请联系您的商务经理。

调试

在接入前，您也可以通过阿里云OpenAPI在线调试图片审核2.0版的接口，查看调用示例代码及SDK依赖信息，方便概览接口的使用方法和参数。

重要

在线调试能力是基于当前登录账号调用内容安全的API接口，因此调用量会计入账号的收费用量中。

请求参数

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

请求body是一个JSON结构体，包含以下字段：

名称

类型

是否必选

示例值

描述

Service

String

是

baselineCheck_global

图片检测2.0版支持的检测服务。取值：

baselineCheck_global：通用基线检测

说明

不同服务区别请参考服务说明。

ServiceParameters

JSONString

是

内容检测对象的相关参数集。JSON字符串格式，关于每个字符串的描述，请参见ServiceParameters。

表 1. ServiceParameters

名称	类型	是否必选	示例值	描述
imageUrl	String	是。图片审核增强版支持三种方式传入图片，请您选择其中一种：使用图片URL方式进行检测，传入imageUrl。使用OSS授权进行检测，必须同时传入ossBucketName、ossObjectName、ossRegionId。使用本地图片进行检测。上传本地图片检测，不占用您的OSS存储空间，且文件只存储30分钟。SDK接入已经集成本地图片上传功能，具体代码示例，请参见图片审核2.0版接入指南。	https://img.alicdn.com/tfs/TB1U4r9AeH2gK0jSZJnXXaT1FXa-2880-480.png	待检测对象的URL，请确保该URL能通过公网访问到，且URL地址长度不超过2048个字符。说明 URL地址中不能包含中文，且一次请求请确保仅传入1条URL。
ossBucketName	String		bucket_01	已授权OSS空间的Bucket名。说明使用OSS图片内网地址时必须先使用阿里云账号（即主账号）访问云资源访问授权页面进行授权。
ossObjectName	String		2022023/04/24/test.jpg	已授权OSS空间的文件名。
ossRegionId	String		cn-beijing	OSS Bucket所在区域。
dataId	String	否	img123****	检测对象对应的数据ID。由大小写英文字母、数字、下划线（_）、短划线（-）、英文句号（.）组成，不超过64个字符，可以用于唯一标识您的业务数据。
referer	String	否	www.aliyun.com	referer请求头，用于防盗链等场景。长度不超过256个字符。

返回数据

名称	类型	示例值	描述
RequestId	String	70ED13B0-BC22-576D-9CCF-1CC12FEAC477	本次调用请求的ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。
Data	Object		图片内容检测结果。更多信息，请参见Data。
Code	Integer	200	状态码。更多信息，请参见Code说明。
Msg	String	OK	本次请求的响应消息。

表 2. Data

名称	类型	示例值	描述
Result	Array		图片检测的风险标签、置信分等参数结果。更多信息，请参见result。
DataId	String	img123******	检测对象对应的数据ID。说明如果在检测请求参数中传入了dataId，则此处返回对应的dataId。

表 3. result

名称

类型

示例值

描述

Label

String

violent_explosion

图片内容检测运算后返回的标签。同一张图片可能会检出多个标签和分值。支持的标签，请参见：

通用基线检测（baselineCheck_global）支持标签

Confidence

Float

81.22

置信分值，0到100分，保留到小数点后2位。部分标签无置信分，更多信息，请参见风险标签释义表。

示例

请求示例

{
    "Service": "baselineCheck_global",
    "ServiceParameters": {
        "imageUrl": "https://img.alicdn.com/tfs/TB1U4r9AeH2gK0jSZJnXXaT1FXa-2880-480.png",
        "dataId": "img123****"
    }
}

返回示例

系统检测到风险内容时，返回示例：

{
    "Msg": "OK",
    "Code": 200,
    "Data": {
        "DataId": "img123****",
        "Result": [
            {
                "Label": "pornographic_adultContent",
                "Confidence": 81
            },
            {
                "Label": "sexual_partialNudity",
                "Confidence": 98
            },
            {
                "Label": "violent_explosion",
                "Confidence": 70
            },
            {
                "Label": "violent_explosion_lib",
                "Confidence": 81
            }
        ]
    },
    "RequestId": "ABCD1234-1234-1234-1234-1234XYZ"
}

当系统没有检测到风险内容时，返回示例：

{
    "Msg": "OK",
    "Code": 200,
    "Data": {
        "DataId": "img123****",
        "Result": [
            {
                "Label": "nonLabel"
            }
        ]
    },
    "RequestId": "ABCD1234-1234-1234-1234-1234XYZ"
}

系统检测到您传入的图片命中了您配置的免审图库时，返回示例：

{
    "Msg": "OK",
    "Code": 200,
    "Data": {
        "DataId": "img123****",
        "Result": [
            {
                "Label": "nonLabel_lib",
                "Confidence": 83
            }
        ]
    },
    "RequestId": "ABCD1234-1234-1234-1234-1234XYZ"
}

说明

文档中的请求示例和返回示例为了便于阅读，做了格式化处理，实际返回结果是没有进行换行、缩进等处理。

风险标签释义表

以下是风险标签值、对应的分值区间以及对应的含义。每个风险标签均可以在控制台进行开关配置，部分风险标签会提供更细分检测范围的开关配置。具体操作，请参见控制台操作指南。

说明

建议您将系统返回的风险标签和置信分做一定周期的数据存储，以便于在后续内容治理时参考，可根据风险标签设定人工审核或标注的优先级、分层分类的内容治理措施。

表 4. 通用基线检测（baselineCheck_global）支持标签

标签值（label）	置信分区间（confidence）	中文含义
pornographic_adultContent	0~100分，分数越高置信度越高	画面疑似含有成人色情内容。
pornographic_cartoon	0~100分，分数越高置信度越高	画面疑似含有卡通色情内容。
pornographic_adultToys	0~100分，分数越高置信度越高	画面疑似含有成人器具内容。
pornographic_art	0~100分，分数越高置信度越高	画面疑似含有艺术品色情内容。
pornographic_adultContent_tii	0~100分，分数越高置信度越高	图中文字含色情内容。
pornographic_suggestive_tii	0~100分，分数越高置信度越高	图中文字含低俗内容。
pornographic_o_tii	0~100分，分数越高置信度越高	图中文字含特殊类内容。更多信息，请参见内容安全控制台。
pornographic_organs_tii	0~100分，分数越高置信度越高	图中文字含性器官描述内容。
pornographic_adultToys_tii	0~100分，分数越高置信度越高	图中文字含成人玩具类内容。
sexual_suggestiveContent	0~100分，分数越高置信度越高	疑似含有疑似低俗或性暗示内容。
sexual_femaleUnderwear	0~100分，分数越高置信度越高	画面疑似含有内衣泳衣内容。
sexual_cleavage	0~100分，分数越高置信度越高	画面疑似含有女性乳沟特征。
sexual_maleTopless	0~100分，分数越高置信度越高	画面疑似含有男性赤膊内容。
sexual_cartoon	0~100分，分数越高置信度越高	疑似含有动漫类性感内容。
sexual_shoulder	0~100分，分数越高置信度越高	画面疑似含有肩部性感内容。
sexual_femaleLeg	0~100分，分数越高置信度越高	画面疑似含有腿部性感内容。
sexual_pregnancy	0~100分，分数越高置信度越高	画面疑似含有孕照哺乳内容。
sexual_feet	0~100分，分数越高置信度越高	画面疑似含有脚部性感内容。
sexual_kiss	0~100分，分数越高置信度越高	画面疑似含有亲吻内容。
sexual_intimacy	0~100分，分数越高置信度越高	画面疑似含有亲密行为内容。
sexual_intimacyCartoon	0~100分，分数越高置信度越高	画面疑似含有卡通动漫亲密动作。
violent_explosion	0~100分，分数越高置信度越高	疑似含有烟火类内容元素。更多信息，请参见内容安全控制台。
violent_burning	0~100分，分数越高置信度越高	画面疑似包含燃烧内容。
violent_armedForces	0~100分，分数越高置信度越高	画面疑似包含暴恐组织。
violent_weapon	0~100分，分数越高置信度越高	画面疑似包含军器装备。
violent_crowding	0~100分，分数越高置信度越高	画面疑似有人群聚集。
violent_gun	0~100分，分数越高置信度越高	画面疑似包含枪支。
violent_knives	0~100分，分数越高置信度越高	画面疑似包含刀具。
violent_horrific	0~100分，分数越高置信度越高	画面疑似包含惊悚内容。
violent_nazi	0~100分，分数越高置信度越高	画面疑似包含纳粹内容。
violent_bloody	0~100分，分数越高置信度越高	画面疑似包含血腥内容。
violent_extremistGroups_tii	0~100分，分数越高置信度越高	图中文字含暴恐组织内容。
violent_extremistIncident_tii	0~100分，分数越高置信度越高	图中文字含暴恐事件内容。
violence_weapons_tii	0~100分，分数越高置信度越高	图中文字含枪支刀具的描述。
contraband_drug	0~100分，分数越高置信度越高	画面含有疑似毒品内容。
contraband_drug_tii	0~100分，分数越高置信度越高	图中文字疑似描述违禁毒品。
contraband_gamble	0~100分，分数越高置信度越高	画面疑似含有赌博内容。
contraband_gamble_tii	0~100分，分数越高置信度越高	图中文字疑似描述赌博行为。
inappropriate_smoking	0~100分，分数越高置信度越高	画面疑似含有烟相关内容。
inappropriate_drinking	0~100分，分数越高置信度越高	画面疑似含有酒相关内容。
inappropriate_tattoo	0~100分，分数越高置信度越高	画面疑似含有纹身内容。
inappropriate_middleFinger	0~100分，分数越高置信度越高	画面疑似含有竖中指内容。
inappropriate_foodWasting	0~100分，分数越高置信度越高	画面疑似含有浪费粮食内容。
profanity_Offensive_tii	0~100分，分数越高置信度越高	图中文字疑似含有较严重辱骂，言语攻击/冒犯等内容。
profanity_Oral_tii	0~100分，分数越高置信度越高	图中文字疑似含有口头语性质的辱骂。
religion_clothing	0~100分，分数越高置信度越高	画面疑似含有特殊标识和元素。更多信息，请参见内容安全控制台。
religion_logo	0~100分，分数越高置信度越高
religion_flag	0~100分，分数越高置信度越高
religion_taboo1_tii	0~100分，分数越高置信度越高	图中文字含禁忌类内容。更多信息，请参见内容安全控制台。
religion_taboo2_tii	0~100分，分数越高置信度越高	图中文字含禁忌类内容。更多信息，请参见内容安全控制台。
flag_country	0~100分，分数越高置信度越高	画面疑似含有旗帜相关内容。

说明

tii为text in image的缩写，结尾为tii的标签代表命中了图片中的文字违规内容。

此外，上述每个风险标签也支持配置自定义图库实现，如检测的图片与自定义图库中的图片相似度高，则系统会返回对应的风险标签。为了便于区分，标签值（label）格式为原风险标签值_lib。例如，您对“violent_explosion”配置了自定义图库，当检测的图片匹配到自定义图库中的任一一张图片且相似度较高，系统会在label参数中返回violent_explosion_lib，对应的 confidence参数会以分值的形式代表相似程度。

当系统对传入的图片检测未发现异常，或着与您配置的免审图片中任一一张相似度高，则系统返回的标签值和置信分满足如下表格。

标签值（label）	置信分区间（confidence）	中文含义
nonLabel	无该字段	该图片未检测出风险，或者您已全关闭检测项。更多信息，请参见内容安全控制台。
nonLabel_lib	0~100分，分数越高置信度越高	该图片与您选配的免审图片中存在较高相似度。更多信息，请参见内容安全控制台。

Code说明

以下为接口返回code的含义说明，系统仅对code返回为200的请求计量计费，其他code不会计费。

Code	说明
200	请求正常。
400	请求参数为空。
401	请求参数错误。
402	请求参数长度不符合接口规定，请检查并修改。
403	请求超过QPS限制，请检查并调整并发。
404	传入的图片下载遇到错误，请检查或重试。
405	传入的图片下载超时，可能是因为图片无法访问，请检查调整后重试。
406	传入的图片过大，请检查调整图片大小后再重试。
407	传入的图片格式暂不支持，请检查调整后重试。
408	该账号无权限调用该接口，可能是账号未开通或者已欠费，或者调用账号未被授权访问。
500	系统异常。

地域	外网接入地址	内网接入地址	支持服务
新加坡	https://green-cip.ap-southeast-1.aliyuncs.com	https://green-cip-vpc.ap-southeast-1.aliyuncs.com	baselineCheck_global