图片审核增强版API_内容安全-阿里云帮助中心

API功能介绍

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

接入指引

注册阿里云账号：立即注册，按照操作提示完成账号注册。内容安全产品面向企业提供，请完成企业认证。
开通内容安全按量付费：请确保您已开通内容审核增强版，开通不收费，接口接入使用后系统会按使用量自动出账，详情参考图片增强版介绍及计费说明。您也可以购买按量抵扣资源包，资源包相较于后付费存在一定阶梯抵扣，适合使用量级可预期和较大的用户。
创建AccessKey：请确保您已通过RAM创建AccessKey，如果您使用的是子账号AccessKey，您需要通过主账号给子账号赋予AliyunYundunGreenWebFullAccess权限，具体操作，请参见RAM授权。
开发接入：推荐使用SDK方式调用，具体方法请详见SDK调用。

使用说明

业务接口：https://green-cip.{region}.aliyuncs.com。

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

支持的地域及接入地址：


地域	外网接入地址	内网接入地址
华东2（上海）	green-cip.cn-shanghai.aliyuncs.com	green-cip-vpc.cn-shanghai.aliyuncs.com
华北2（北京）	green-cip.cn-beijing.aliyuncs.com	green-cip-vpc.cn-beijing.aliyuncs.com
华南1（深圳）	green-cip.cn-shenzhen.aliyuncs.com	暂无

计费信息：
该接口为收费接口。仅对HTTP状态码为200的请求进行计量计费，产生其他错误码时不会计费。关于计费方式，请参见图片增强版介绍及计费说明。
图片要求：
- 图片支持以下格式：PNG、JPG、JPEG、BMP、WEBP。
- 图片大小限制在10 MB以内，像素建议大于200*200（px），像素过低会影响内容安全检测算法的效果。
- 图片下载时间限制为3秒内，如果下载时间超过3秒，返回下载超时。

QPS限制

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

调试

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

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

请求参数

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

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


名称	类型	是否必选	示例值	描述
Service	String	是	baselineCheck	图片检测增强版支持的检测类型。取值： baselineCheck：通用基线检测 tonalityImprove：内容治理检测
ServiceParameters	JSON String	是		内容检测对象的相关参数集。JSON字符串格式，关于每个字符串的描述，请参见ServiceParameters。

表 1. ServiceParameters
名称	类型	是否必选	示例值	描述
imageUrl	String	是	http://www.aliyundoc.com/xxx.jpg	待检测对象的URL，请确保该URL能通过公网访问到，且URL地址长度不超过2048个字符。说明 URL地址中不能包含中文，且一次请求请确保仅传入1条URL。
dataId	String	否	img123******	检测对象对应的数据ID。由大小写英文字母、数字、下划线（_）、短划线（-）、英文句号（.）组成，不超过64个字符，可以用于唯一标识您的业务数据。

返回数据


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

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

表 3. result
名称	类型	示例值	描述
label	String	violent_explosion	图片内容检测运算后返回的标签。同一张图片可能会检出多个标签和分值。支持标签请参见：通用基线检测（baselineCheck）支持标签内容治理检测（tonalityImprove）支持标签
confidence	Float	81.22	置信分值，0到100分，保留到小数点后2位。部分标签无置信分，更多信息，请参见风险标签释义表。

示例

请求示例

{
  "service": "baselineCheck",
  "serviceParameters":
  {
    "imageUrl": "https://img.alicdn.com/tfs/TB1Mq6ZmCslXu8jSZFuXXXg7FXa-1440-568.jpg",
    "dataId": "img1234567"
  }
}

返回示例

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

{
    "Msg": "OK",
    "Code": 200,
    "Data": {
        "dataId": "uimg1234567",
        "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": "uimg1234567",
        "result": [
            {
                "label": "nonLabel"
            }
        ]
    },
    "RequestId": "ABCD1234-1234-1234-1234-1234XYZ"
}

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

{
    "Msg": "OK",
    "Code": 200,
    "Data": {
        "dataId": "uimg1234567",
        "result": [
            {
                "label": "nonLabel_lib",
                "confidence": 83
            }
        ]
    },
    "RequestId": "ABCD1234-1234-1234-1234-1234XYZ"
}

风险标签释义表

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

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

表 4. 通用基线检测（baselineCheck）支持标签
标签值（label）	置信分区间（confidence）	中文含义
pornographic_adultContent	0~100分，分数越高置信度越高	疑似含有成人色情内容。更多信息请参见内容安全控制台。
pornographic_adultContent_tii	0~100分，分数越高置信度越高	图中文字疑似含有色情内容。更多信息请参见内容安全控制台。
sexual_suggestiveContent	0~100分，分数越高置信度越高	疑似含有疑似低俗或性暗示内容。更多信息请参见内容安全控制台。
sexual_partialNudity	0~100分，分数越高置信度越高	疑似含有包含肢体裸露或性感内容。更多信息请参见内容安全控制台。
sexual_affectionDisplay	0~100分，分数越高置信度越高	疑似含有亲密行为的内容。更多信息请参见内容安全控制台。
political_historicalNihility	0~100分，分数越高置信度越高	疑似含有历史虚无内容。更多信息请参见内容安全控制台。
political_historicalNihility_tii	0~100分，分数越高置信度越高	图中文字疑似含有历史虚无信息。
political_politicalFigure	0~100分，分数越高置信度越高	疑似含有政治人物的内容。更多信息请参见内容安全控制台。
political_politicalFigure_name_tii	0~100分，分数越高置信度越高	图中文字疑似含有领导人姓名。
political_politicalFigure_metaphor_tii	0~100分，分数越高置信度越高	图中文字疑似含有对主要领导人的代称、暗喻。
political_prohibitedPerson	0~100分，分数越高置信度越高	疑似含有不宜宣传的人物的内容。更多信息请参见内容安全控制台。
political_prohibitedPerson_tii	0~100分，分数越高置信度越高	图中文字疑似含有落马官员的姓名。
political_taintedCelebrity	0~100分，分数越高置信度越高	疑似含有重大负面的公众人物的内容。更多信息请参见内容安全控制台。
political_taintedCelebrity_tii	0~100分，分数越高置信度越高	图中文字疑似含有劣迹艺人的姓名。
political_flag	0~100分，分数越高置信度越高	疑似含有国家或地区旗帜。更多信息请参见内容安全控制台。
political_map	0~100分，分数越高置信度越高	疑似含有中国地图。更多信息请参见内容安全控制台。
political_TVLogo	0~100分，分数越高置信度越高	疑似含有特定电视台台标。更多信息请参见内容安全控制台。
political_outfit	0~100分，分数越高置信度越高	疑似含有公务服装。更多信息请参见内容安全控制台。
political_religion_tii	0~100分，分数越高置信度越高	图中文字疑似含有宗教元素或者信息。
political_racism_tii	0~100分，分数越高置信度越高	图中文字疑似含有歧视的表达内容。
violent_explosion	0~100分，分数越高置信度越高	疑似含有烟火类内容元素。更多信息请参见内容安全控制台。
violent_armedForces	0~100分，分数越高置信度越高	疑似含有武装元素。
violent_crowding	0~100分，分数越高置信度越高	疑似含有人群聚集元素。
violent_gunKnives	0~100分，分数越高置信度越高	疑似含有刀具、枪支等内容。更多信息请参见内容安全控制台。
violent_gunKnives_tii	0~100分，分数越高置信度越高	图中文字疑似含枪支刀具的描述。
violent_horrificContent	0~100分，分数越高置信度越高	疑似含有惊悚、血腥等内容。更多信息请参见内容安全控制台。
violent_horrific_tii	0~100分，分数越高置信度越高	图中文字疑似描述暴力、恐怖的内容。
contraband_drug	0~100分，分数越高置信度越高	含有疑似毒品等内容。
contraband_drug_tii	0~100分，分数越高置信度越高	图中文字疑似描述违禁毒品。
contraband_gamble	0~100分，分数越高置信度越高	含有疑似赌博等内容。
contraband_gamble_tii	0~100分，分数越高置信度越高	图中文字疑似描述赌博行为。

表 5. 内容治理检测（tonalityImprove）支持标签
标签值（label）	置信分区间（confidence）	中文含义
pt_toSocialNetwork_logo	0~100分，分数越高置信度越高	疑似含有logo。更多信息请参见内容安全控制台。
pt_qrCode	0~100分，分数越高置信度越高	疑似含有二维码。
pt_programCode	0~100分，分数越高置信度越高	疑似含有小程序码。
pt_toDirectContact_tii	0~100分，分数越高置信度越高	图中文字疑似含有特定引流信息。更多信息请参见内容安全控制台。
pt_toSocialNetwork_tii	0~100分，分数越高置信度越高
pt_toShortVideos_tii	0~100分，分数越高置信度越高
pt_investment_tii	0~100分，分数越高置信度越高
pt_recruitment_tii	0~100分，分数越高置信度越高
pt_certificate_tii	0~100分，分数越高置信度越高
inappropriate_smoking	0~100分，分数越高置信度越高	疑似含有烟相关内容。
inappropriate_drinking	0~100分，分数越高置信度越高	疑似含有酒相关内容。
inappropriate_tattoo	0~100分，分数越高置信度越高	疑似含有纹身相关内容。
inappropriate_middleFinger	0~100分，分数越高置信度越高	疑似含有竖中指相关内容。
inappropriate_foodWasting	0~100分，分数越高置信度越高	疑似含有浪费粮食相关内容。
PDA_kiss	0~100分，分数越高置信度越高	疑似含有亲吻内容。
PDA_physicalContact	0~100分，分数越高置信度越高	疑似含有亲密行为内容。
PDA_physicalContact_cartoon	0~100分，分数越高置信度越高	疑似含有特定画面。更多信息请参见内容安全控制台。
religion_funeral	0~100分，分数越高置信度越高	疑似含有葬礼灵堂内容。
religion_buddhism	0~100分，分数越高置信度越高	疑似含有特定服饰及标识。更多信息请参见内容安全控制台。
religion_christianity	0~100分，分数越高置信度越高
religion_muslim	0~100分，分数越高置信度越高
religion_tii	0~100分，分数越高置信度越高	图中文字疑似含特定元素或者信息。更多信息请参见内容安全控制台。
racism_tii	0~100分，分数越高置信度越高	图中文字疑似含特定元素或者信息。更多信息请参见内容安全控制台。
object_landmark	0~100分，分数越高置信度越高	疑似含特定地标。更多信息请参见内容安全控制台。
object_rmb	0~100分，分数越高置信度越高	疑似含有特定货币。更多信息请参见内容安全控制台。
object_wn	0~100分，分数越高置信度越高	疑似含有特定画面。更多信息请参见内容安全控制台。
logo_brand	0~100分，分数越高置信度越高	疑似含有商标内容。
quality_meaningless	0~100分，分数越高置信度越高	图片元素过少。更多信息请参见内容安全控制台
profanity_oral_tii	0~100分，分数越高置信度越高	图中文字疑似含不文明低俗口头语。
profanity_offensive_tii	0~100分，分数越高置信度越高	图中文字疑似含严重辱骂内容。
ad_compliance_tii	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	系统异常。