图片审核增强版多Service同步检测API-阿里云帮助中心

本文介绍图片审核增强版多Service检测API接口的使用方法，支持一次接口调用传入多个Service参数，可同时调用多个图片审核增强版检测服务。

API功能介绍

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

接入指引

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

使用说明

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

业务接口：ImageBatchModeration

支持的地域及接入地址：

地域	外网接入地址	内网接入地址	支持服务
华东2（上海）	https://green-cip.cn-shanghai.aliyuncs.com	https://green-cip-vpc.cn-shanghai.aliyuncs.com	baselineCheck、baselineCheck_pro、tonalityImprove、aigcCheck、profilePhotoCheck、postImageCheck、advertisingCheck、liveStreamCheck
华东1（杭州）	https://green-cip.cn-hangzhou.aliyuncs.com	https://green-cip-vpc.cn-hangzhou.aliyuncs.com
华北2（北京）	https://green-cip.cn-beijing.aliyuncs.com	https://green-cip-vpc.cn-beijing.aliyuncs.com
华南1（深圳）	https://green-cip.cn-shenzhen.aliyuncs.com	https://green-cip-vpc.cn-shenzhen.aliyuncs.com
西南1（成都）	https://green-cip.cn-chengdu.aliyuncs.com	暂无

计费信息：
该接口为收费接口。仅对HTTP状态码为200的请求进行计量计费，产生其他错误码时不会计费。关于计费方式，请参见计费说明。
图片要求：
- 图片支持以下格式：PNG、JPG、JPEG、BMP、WEBP、TIFF、SVG、HEIC（该格式最长边需小于8192 px）、GIF（取第一帧）、ICO（取最后一图）。
- 图片大小限制在20 MB以内，高或者宽不能超过16,384 px，且总像素不能超过1.67亿 px。像素建议大于200*200（px），像素过低会影响内容安全检测算法的效果。
- 图片下载时间限制为3秒内，如果下载时间超过3秒，返回下载超时。

QPS限制

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

调试

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

重要

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

请求参数

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

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

名称

类型

是否必选

示例值

描述

Service

String

是

baselineCheck,tonalityImprove

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

baselineCheck：通用基线检测
baselineCheck_pro：通用基线检测_专业版
baselineCheck_cb：通用基线检测_出海版
tonalityImprove：内容治理检测
aigcCheck：AIGC图片风险
aigcCheck_cb：AIGC图片风险检测_出海版
profilePhotoCheck：头像图片检测
postImageCheck：帖子评论图片检测
advertisingCheck：营销素材检测
liveStreamCheck：视频\直播截图检测
riskDetection：恶意图片检测

说明

不同服务区别请参考服务说明。AIGC专用服务请参考AIGC场景检测服务。可一次性传入多个service，不同service以英文逗号分割，例如：baselineCheck,tonalityImprove，表示同时进行通用基线检测和内容治理检测。

ServiceParameters

JSONString

是

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

表 1. ServiceParameters

名称	类型	是否必选	示例值	描述
imageUrl	String	是。图片审核增强版支持三种方式传入图片，请您选择其中一种：使用图片URL方式进行检测，传入imageUrl。使用OSS授权进行检测，必须同时传入ossBucketName、ossObjectName、ossRegionId。使用本地图片进行检测。上传本地图片检测，不占用您的OSS存储空间，且文件只存储30分钟。SDK接入已经集成本地图片上传功能，具体代码示例，请参见图片审核增强版SDK及接入指南。	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个字符。
infoType	String	是	customImage,textInImage	需要获取的辅助信息内容，取值： customImage：自定义图库命中信息 textInImage：图片中文字信息 publicFigure：命中人物信息 logoData：标识标志信息支持指定多个内容，以英文逗号分隔。例如， “customImage,textInImage”表示同时返回自定义图库和图片中文字信息。说明人物信息、标识标志信息支持在审核类型为图片审核高级的Service中返回。更多信息，请参考Service说明。

返回数据

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

表 2. Data

名称	类型	示例值	描述
Result	Array		图片整体的风险标签、置信分等参数结果。更多信息，请参见Result。
RiskLevel	String	high	风险等级，根据设置的高低风险分返回，返回值包括： high：高风险 medium：中风险 low：低风险 none：未检测到风险说明高风险内容建议直接处置；中风险内容建议人工复查；低风险内容建议在高召回需求时再做处理，日常建议和未检测到风险做相同处理。风险分值可以在内容安全控制台配置。
DataId	String	img123******	检测对象对应的数据ID。说明如果在检测请求参数中传入了dataId，则此处返回对应的dataId。
Results	Array		图片检测分Service的详细结果，请参见Results。

表 3. Result

名称	类型	示例值	描述
Label	String	violent_explosion	图片内容检测运算后返回的标签。同一张图片可能会检出多个标签和分值。支持的标签，请参见：通用基线检测（baselineCheck）支持标签通用基线检测_专业版（baselineCheck_pro）支持标签通用基线检测_出海版（baselineCheck_cb）支持标签内容治理检测（tonalityImprove）支持标签 AIGC图片风险检测（aigcCheck）支持标签 AIGC图片风险检测_出海版（aigcCheck_cb）支持标签头像图片检测（profilePhotoCheck）支持标签帖子评论图片检测（postImageCheck）支持标签营销素材检测（advertisingCheck）支持标签视频\直播截图检测（liveStreamCheck）支持标签恶意图片检测（riskDetection）支持标签
Confidence	Float	81.22	置信分值，0到100分，保留到小数点后2位。部分标签无置信分，更多信息，请参见风险标签释义表。
Description	String	烟火类内容	对Labal字段的说明。重要该字段为Label字段的解释说明，可能会变更调整，实际处理结果时建议处理Label字段，不要基于该字段进行结果处置。

表 4. Results

名称	类型	示例值	描述
Service	String	baselineCheck	调用的Service服务名。
RiskLevel	String	high	风险等级，根据设置的高低风险分返回，返回值包括： high：高风险 medium：中风险 low：低风险 none：未检测到风险
Result	Array		图片检测的风险标签、置信分等参数结果。更多信息，请参见Result。
Ext	Object		图片辅助参考信息。更多信息，请参见辅助信息。

返回的辅助信息（点击展开详情）

表 5. Ext

名称	类型	示例值	描述
CustomImage	JSONArray		如果命中自定义图库，返回命中的自定义图库信息。更多信息，请参见CustomImage。
TextInImage	Object		返回命中的图片中文字信息。更多信息，请参见TextInImage。
PublicFigure	JSONArray		图片中包含特定人物时，返回识别出来的人物编码。更多信息，请参见PublicFigure。
LogoData	JSONArray		返回命中的标识标志信息。更多信息，请参见LogoData。

表 6. CustomImage

名称	类型	示例值	描述
LibId	String	lib0001	命中的自定义图库ID。
LibName	String	自定义图库A	命中的自定义图库名。
ImageId	String	20240307	命中的自定义图片ID。

表 7. TextInImage

名称	类型	示例值	描述
OcrResult	JSONArray		返回识别到的图片中的每行文字信息。更多信息，请参见OcrResult。
RiskWord	StringArray	[ "风险词1", "风险词2"]	命中文本中的风险片段。在命中tii类型的标签时返回。
CustomText	JSONArray		如果命中自定义词库，返回命中的自定义词库信息。更多信息，请参见CustomText。

表 8. OcrResult

名称	类型	示例值	描述
Text	String	识别到的文字行1	返回识别到的图片中的文字行内容。

表 9. CustomText

名称	类型	示例值	描述
LibId	String	test20240307	命中的自定义词库ID。
LibName	String	自定义词库A	命中的自定义词库名。
KeyWords	String	关键词1	命中的自定义关键词。

表 10. PublicFigure

名称	类型	示例值	描述
FigureName	String	张三	识别出的人物信息。
FigureId	String	xxx001	识别出的人物编码。说明特定人物会返回编码，其他人物返回人物信息。建议先取人物信息，人物信息为空再取人物编码。
Location	JSONArray		人物的位置信息。更多信息，请参见Location。

表 11. LogoData

名称	类型	示例值	描述
Logo	JSONArray		标识信息。更多信息，请参见Logo。
Location	Object		标识的位置信息。更多信息，请参见Location。

表 12. Logo

名称	类型	示例值	描述
Name	String	钉钉	标识名
Label	String	logo_sns	命中标签
Confidence	Float	88.18	置信度

表 13. Location

名称	类型	示例值	描述
X	Float	41	以图片左上角为坐标原点，文字区域左上角到y轴的距离，单位：像素。
Y	Float	84	以图片左上角为坐标原点，文字区域左上角到x轴的距离，单位：像素。
W	Float	83	文字区域的宽度，单位：像素。
H	Float	26	文字区域的高度，单位：像素。

示例

请求示例

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

返回示例

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

{
    "Msg": "OK",
    "Code": 200,
    "Data": {
        "DataId": "img123****",
        "RiskLevel": "high",
        "Result": [
            {
                "Label": "violent_explosion",
                "Confidence": 81.88,
                "Description": "烟火类内容"
            },
            {
                "Label": "sexual_partialNudity",
                "Confidence": 98.18,
                "Description": "肢体裸露或性感"
            },
            {
                "Label": "pt_programCode",
                "Confidence": 70.11,
                "Description": "小程序码"
            }
        ],
        "Results": [
            {
                "Result": [
                    {
                        "Label": "violent_explosion",
                        "Confidence": 81.88,
                        "Description": "烟火类内容"
                    },
                    {
                        "Label": "sexual_partialNudity",
                        "Confidence": 98.18,
                        "Description": "肢体裸露或性感"
                    }
                ],
                "RiskLevel": "high",
                "Service": "baselineCheck"
            },
            {
                "Result": [
                    {
                        "Label": "pt_programCode",
                        "Confidence": 70.11,
                        "Description": "小程序码"
                    }
                ],
                "RiskLevel": "high",
                "Service": "tonalityImprove"
            }
        ]
    },
    "RequestId": "ABCD1234-2024-0307-8888-666ZHY"
}

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

{
    "Msg": "OK",
    "Code": 200,
    "Data": {
        "DataId": "img123****",
        "RiskLevel": "none",
        "Result": [
            {
                "Label": "nonLabel",
                "Description": "未检测出风险"
            }
        ],
        "Results": [
            {
                "Result": [
                    {
                        "Label": "nonLabel",
                        "Description": "未检测出风险"
                    }
                ],
                "RiskLevel": "none",
                "Service": "baselineCheck"
            },
            {
                "Result": [
                    {
                        "Label": "nonLabel",
                        "Description": "未检测出风险"
                    }
                ],
                "RiskLevel": "none",
                "Service": "tonalityImprove"
            }
        ]
    },
    "RequestId": "ABCD1234-2024-0307-8888-666ZHY"
}

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

{
    "Msg": "OK",
    "Code": 200,
    "Data": {
        "DataId": "img123****",
        "RiskLevel": "none",
        "Result": [
            {
                "Label": "nonLabel_lib",
                "Confidence": 83.18,
                "Description": "命中免审图库"
            }
        ],
        "Results": [
            {
                "Result": [
                    {
                        "Label": "nonLabel_lib",
                        "Confidence": 83.18,
                        "Description": "命中免审图库"
                    }
                ],
                "RiskLevel": "none",
                "Service": "baselineCheck"
            },
            {
                "Result": [
                    {
                        "Label": "nonLabel_lib",
                        "Confidence": 83.18,
                        "Description": "命中免审图库"
                    }
                ],
                "RiskLevel": "none",
                "Service": "tonalityImprove"
            }
        ]
    },
    "RequestId": "ABCD1234-1234-1234-1234-1234XYZ"
}

辅助信息返回示例（点击展开详情）

命中自定义图库时，返回示例：

{
    "Msg": "OK",
    "Code": 200,
    "Data": {
        "DataId": "img123****",
        "RiskLevel": "high",
        "Result": [
            {
                "Confidence": 100.0,
                "Label": "pornographic_adultContent_lib",
                "Description": "成人色情_命中自定义库"
            },
            {
                "Label": "pt_programCode",
                "Confidence": 70.11,
                "Description": "小程序码"
            }
        ],
        "Results": [
            {
                "Result": [
                    {
                        "Confidence": 100.0,
                        "Label": "pornographic_adultContent_lib",
                        "Description": "成人色情_命中自定义库"
                    }
                ],
                "Ext": {
                    "CustomImage": [
                        {
                            "ImageId": "12345",
                            "LibId": "TEST20240307",
                            "LibName": "风险图库A"
                        }
                    ]
                },
                "RiskLevel": "high",
                "Service": "baselineCheck"
            },
            {
                "Result": [
                    {
                        "Label": "pt_programCode",
                        "Confidence": 70.11,
                        "Description": "小程序码"
                    }
                ],
                "RiskLevel": "high",
                "Service": "tonalityImprove"
            }
        ]
    },
    "RequestId": "ABCD1234-2024-0307-8888-666ZHY"
}

命中自定义词库时，返回示例：

{
    "Msg": "OK",
    "Code": 200,
    "Data": {
        "DataId": "img123****",
        "RiskLevel": "high",
        "Result": [
            {
                "Confidence": 99.0,
                "Label": "pornographic_adultContent_tii_lib",
                "Description": "文字含有色情内容_命中自定义库"
            },
            {
                "Label": "pt_programCode",
                "Confidence": 70.11,
                "Description": "小程序码"
            }
        ],
        "Results": [
            {
                "Result": [
                    {
                        "Confidence": 99.0,
                        "Label": "pornographic_adultContent_tii_lib",
                        "Description": "文字含有色情内容_命中自定义库"
                    }
                ],
                "Ext": {
                    "TextInImage": {
                        "CustomText": [
                            {
                                "KeyWords": "自定义关键词1",
                                "LibId": "TEST20240307",
                                "LibName": "文本黑名单词库A"
                            }
                        ],
                        "OcrResult": [
                            {
                                "Text": "文字行1"
                            },
                            {
                                "Text": "文字行2"
                            },
                            {
                                "Text": "含自定义关键词的文字行3"
                            }
                        ],
                        "RiskWord": null
                    }
                },
                "RiskLevel": "high",
                "Service": "baselineCheck"
            },
            {
                "Result": [
                    {
                        "Label": "pt_programCode",
                        "Confidence": 70.11,
                        "Description": "小程序码"
                    }
                ],
                "RiskLevel": "high",
                "Service": "tonalityImprove"
            }
        ]
    },
    "RequestId": "ABCD1234-2024-0307-8888-666ZHY"
}

命中图片文本违规时，返回示例：

{
    "Msg": "OK",
    "Code": 200,
    "Data": {
        "DataId": "img123****",
        "RiskLevel": "high",
        "Result": [
            {
                "Confidence": 89.15,
                "Label": "political_politicalFigure_name_tii",
                "Description": "文字含领导人姓名"
            },
            {
                "Label": "pt_programCode",
                "Confidence": 70.11,
                "Description": "小程序码"
            }
        ],
        "Results": [
            {
                "Result": [
                    {
                        "Confidence": 89.15,
                        "Label": "political_politicalFigure_name_tii",
                        "Description": "文字含领导人姓名"
                    }
                ],
                "Ext": {
                    "TextInImage": {
                        "CustomText": null,
                        "OcrResult": [
                            {
                                "Text": "文字行1"
                            },
                            {
                                "Text": "文字行2"
                            },
                            {
                                "Text": "含风险词内容文字行3"
                            }
                        ],
                        "RiskWord": [
                            "风险词1"
                        ]
                    }
                },
                "RiskLevel": "high",
                "Service": "baselineCheck"
            },
            {
                "Result": [
                    {
                        "Label": "pt_programCode",
                        "Confidence": 70.11,
                        "Description": "小程序码"
                    }
                ],
                "RiskLevel": "high",
                "Service": "tonalityImprove"
            }
        ]
    },
    "RequestId": "ABCD1234-2024-0307-8888-666ZHY"
}

命中Logo信息时，返回示例：

{
    "Msg": "OK",
    "Code": 200,
    "Data": {
        "DataId": "img123****",
        "RiskLevel": "high",
        "Result": [
            {
                "Confidence": 96.15,
                "Label": "pt_logotoSocialNetwork",
                "Description": "社交平台logo"
            },
            {
                "Label": "pt_programCode",
                "Confidence": 70.11,
                "Description": "小程序码"
            }
        ],
        "Results": [
            {
                "Result": [
                    {
                        "Confidence": 96.15,
                        "Label": "pt_logotoSocialNetwork",
                        "Description": "社交平台logo"
                    }
                ],
                "Ext": {
                    "LogoData": [
                        {
                            "Location": {
                                "H": 44,
                                "W": 100,
                                "X": 45,
                                "Y": 30
                            },
                            "Logo": [
                                {
                                    "Confidence": 96.15,
                                    "Label": "pt_logotoSocialNetwork",
                                    "Name": "CCTV"
                                }
                            ]
                        }
                    ]
                },
                "RiskLevel": "high",
                "Service": "baselineCheck"
            },
            {
                "Result": [
                    {
                        "Label": "pt_programCode",
                        "Confidence": 70.11,
                        "Description": "小程序码"
                    }
                ],
                "RiskLevel": "high",
                "Service": "tonalityImprove"
            }
        ]
    },
    "RequestId": "ABCD1234-2024-0307-8888-666ZHY"
}

命中人物信息时，返回示例：

{
    "Msg": "OK",
    "Code": 200,
    "Data": {
        "DataId": "img123****",
        "RiskLevel": "high",
        "Result": [
            {
                "Confidence": 92.05,
                "Label": "political_politicalFigure_3",
                "Description": "省市政府人员"
            },
            {
                "Label": "pt_programCode",
                "Confidence": 70.11,
                "Description": "小程序码"
            }
        ],
        "Results": [
            {
                "Result": [
                    {
                        "Confidence": 92.05,
                        "Label": "political_politicalFigure_3",
                        "Description": "省市政府人员"
                    }
                ],
                "Ext": {
                    "PublicFigure": [
                        {
                            "FigureId": null,
                            "FigureName": "杨三",
                            "Location": [
                                {
                                    "H": 520,
                                    "W": 13,
                                    "X": 14,
                                    "Y": 999
                                }
                            ]
                        }
                    ]
                },
                "RiskLevel": "high",
                "Service": "baselineCheck"
            },
            {
                "Result": [
                    {
                        "Label": "pt_programCode",
                        "Confidence": 70.11,
                        "Description": "小程序码"
                    }
                ],
                "RiskLevel": "high",
                "Service": "tonalityImprove"
            }
        ]
    },
    "RequestId": "ABCD1234-2024-0307-8888-666ZHY"
}

说明

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

风险标签释义表

风险标签释义说明请查看风险标签释义表。每个风险标签均可以在控制台进行开关配置，部分风险标签会提供更细分检测范围的开关配置。具体操作，请参见控制台操作指南。

说明

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

Code说明

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

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