组合服务接口

接口描述

提供一个API接口,同时调用多个模型服务。支持文字识别的多个接口、网络图片文字识别、色情识别、暴恐识别、政治敏感识别、广告检测、图文审核、恶心图像识别、图像质量检测一系列模型服务的调用。可通过入参灵活指定需要调用的模型服务,传入图片或图片URL,返回指定模型的识别结果。
色情识别会基于百度默认的审核标准给出一个推荐值(conclusion),如果您需要对具体的标签做重新的划分,建议使用细粒度标签分类的结果(result_fine)

组合服务接口根据请求参数确定要使用的模型服务类型,具体的请求参数和返回结果见下方描述。


其中文字识别相关接口同时提供独立的服务接口,针对每个模型的出入参,可参考百度AI官网每个独立服务接口的文档。色情识别、暴恐识别、政治敏感识别、广告检测、图文审核、恶心图像识别、图像质量检测不提供独立的服务接口,相关出入参详细描述见下方。

接口使用说明


接口权限管理:
使用图像审核组合服务接口,您需要首先在控制台中开通单个模型服务的权限。例如:您希望通过图像审核组合服务接口调用通用文字识别、色情识别、广告检测三个模型服务,则您需要登录并进入图像审核控制台,新建应用并勾选文字识别下的通用文字识别、图像审核下的色情识别、广告检测。


接口调用量限制:
使用图像审核组合服务接口,您的每日最大调用次数限制、最大并发限制,依赖于您选择调用的具体模型服务的调用次数限制和并发限制。具体数值可以在相应的服务控制台中查看。


接口调用量报表:
图像审核组合服务接口不提供单独的调用量报表,根据您每次调用实际选择的模型服务,在控制台监控报表中可查看每个模型服务的调用量统计。

请求说明

请求示例

HTTP 方法:POST

请求URL: https://aip.baidubce.com/api/v1/solution/direct/img_censor

URL参数:

参数
access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取

Header如下:

参数
Content-Type application/json;charset=utf-8

Body中放置请求参数,参数详情如下:

请求参数

参数 类型 是否必须 说明
image string 图像数据,base64编码,不能与imgUrl并存
imgUrl string 图像Url,不能与image并存,不需要urlEncode
scenes array 指定本次调用的模型服务,以字符串数组表示。元素含义如下:
ocr:通用文字识别
politician:政治敏感识别
antiporn:色情识别
terror:暴恐识别
anti_spam:图文审核(对图像中的文字内容进行合规性审核)
webimage:网络图片文字识别
disgust:恶心图像识别
watermark:广告检测
quality:图像质量检测
accurate:通用文字识别(高精度含位置版)
accuratebasic:通用文字识别(高精度版)
scenesConf jsonObject 对特定服务,支持的个性化参数,若不填则使用默认设置。jsonObject说明:
key为要设置入参的服务类型,可取值同scenes字段,例如:
1、ocr:通用文字识别
2、webimage:网络图片文字识别
value为各模型服务个性化参数,详情请参照下文或百度AI官网“文字识别具体接口文档

Body示例:

{    // image 与 imgUrl二选其一
    "image": "/9j/4AAQSkZJRgABAQEPMJkR0FdXVridlPy/9k=",
    "imgUrl": "http://aip.bdstatic.com/portal/dist/1522402512491/ai_images/technology/imagecensoring/demo-card-4.jpg",
    "scenes": ["ocr", "politician", "antiporn", "terror", "webimage", "disgust", "watermark", "quality", "accurate", "accuratebasic"],
    "sceneConf": { // 可不填写
        "webimage": {}, // 可不填写
        "ocr": {
            "detect_direction": "false",
            "recognize_granularity": "big",
            "language_type": "CHN_ENG",
            "mask": "-"
        }
    }
}

请求示例代码

提示一:使用示例代码前,请记得替换其中的示例Token、图片地址或Base64信息。

提示二:部分语言依赖的类或库,请在代码注释中查看下载地址。

返回说明

返回参数

字段 类型 是否必须 说明
log_id uint64 请求标识码,随机数,唯一。
result object 返回结果json串,其内包含用户要调用的各个模型服务的返回结果。
ocr object 文字识别服务返回结果。请参照下文,文字识别说明或“通用文字识别接口文档
politician object 政治敏感识别返回结果。 请参照下文,政治敏感识别说明。
antiporn object 色情识别返回结果。请参照下文,色情识别说明。
terror object 暴恐识别返回结果。请参照下文,暴恐识别说明。
webimage object 网络图片文字识别结果。请参照下文,网络图片文字识别说明或“网络图片文字识别接口文档
disgust object 恶心图像识别结果。请参照下文,恶心图像识别说明。
watermark object 广告检测返回结果。请参照下文,广告检测说明。
quality object 图像质量检测返回结果。请参照下文,图像质量检测说明。
accurate object 通用文字识别(高精度含位置版)返回结果。请参照下文,通用文字识别(高精度含位置版)说明或“通用文字识别(含位置高精度版)接口文档
accuratebasic object 通用文字识别(高精度版)返回结果。请参照下文,通用文字识别(高精度版)说明或“通用文字识别(高精度版)接口文档



返回示例

{
    "result": {
        "antiporn": {
            "result": [{
                "probability": 0.000078,
                "class_name": "性感"
            }, {
                "probability": 0.000001,
                "class_name": "色情"
            }, {
                "probability": 0.999922,
                "class_name": "正常"
            }],
            "conclusion": "正常",
            "log_id": 1612587304059199822,
            "result_fine": [{
                "probability": 0.0,
                "class_name": "一般色情"
            }, {
                "probability": 0.998109,
                "class_name": "一般正常"
            }, {
                "probability": 0.0,
                "class_name": "卡通色情"
            }, {
                "probability": 0.001783,
                "class_name": "卡通正常"
            }, {
                "probability": 0.000026,
                "class_name": "特殊类"
            }, {
                "probability": 0.000077,
                "class_name": "女性性感"
            }, {
                "probability": 0.000001,
                "class_name": "男性性感"
            }, {
                "probability": 0.0,
                "class_name": "SM"
            }, {
                "probability": 0.0,
                "class_name": "低俗"
            }, {
                "probability": 0.000001,
                "class_name": "性玩具"
            }, {
                "probability": 0.000002,
                "class_name": "亲密行为"
            }],
            "result_num": 11,
            "confidence_coefficient": "确定"
        },
        "webimage": {
            "log_id": 8274566822628354611,
            "words_result": [{
                "words": "百度A|开放平台·深度学习平台"
            }, {
                "words": "吧包"
            }, {
                "words": "Paddlepaddle是并行分布式全功能深度学习框架"
            }, {
                "words": "易学易用、高效灵活"
            }, {
                "words": "支持海量图像识别分类/机器翻译/自动驾驶等多个领域"
            }, {
                "words": "现已全面开源, Intel已加入开源贡献"
            }, {
                "words": "Paddlepaddle成为第一个官方支持MKL-DNN的深度学习框架"
            }, {
                "words": "邮件咨询: siebold.com"
            }, {
                "words": "Paddlepaddle开放路线图"
            }, {
                "words": "口防口"
            }],
            "words_result_num": 10,
            "direction": 0
        },
        "terror": {
            "result": 4.6869706693542E-7,
            "log_id": 2466710332049314848,
            "result_fine": [{
                "score": 0.99997806549072,
                "name": "正常"
            }, {
                "score": 0.000021282241505105,
                "name": "警察部队"
            }, {
                "score": 1.4284228022632E-8,
                "name": "血腥"
            }, {
                "score": 1.1518556419787E-7,
                "name": "尸体"
            }, {
                "score": 2.634956217662E-7,
                "name": "爆炸火灾"
            }, {
                "score": 1.5594283198084E-8,
                "name": "杀人"
            }, {
                "score": 3.0972262976547E-8,
                "name": "暴乱"
            }, {
                "score": 2.6761359350758E-8,
                "name": "暴恐人物"
            }, {
                "score": 1.6384501577704E-7,
                "name": "军事武器"
            }, {
                "score": 2.4037409840361E-9,
                "name": "暴恐旗帜"
            }, {
                "score": 3.3956993661377E-8,
                "name": "血腥动物或动物尸体"
            }],
            "result_coarse": [{
                "score": 0.99999958276749,
                "name": "正常"
            }, {
                "score": 4.6869706693542E-7,
                "name": "暴恐"
            }]
        },
        "watermark": {
            "result": [{
                "probability": 0.92880970239639,
                "type": "QR code"
            }],
            "log_id": 964898612068672707,
            "result_num": 1
        },
        "accurate": {
            "log_id": 7895736306899747812,
            "words_result": [{
                "words": "百度A|开放平台·深度学习平台",
                "location": {
                    "top": 159,
                    "left": 1161,
                    "width": 234,
                    "height": 19
                },
                "chars": [{
                    "char": "百",
                    "location": {
                        "top": 159,
                        "left": 1161,
                        "width": 16,
                        "height": 19
                    }
                }, {
                    "char": "度",
                    "location": {
                        "top": 159,
                        "left": 1177,
                        "width": 16,
                        "height": 19
                    }
                }, {
                    "char": "A",
                    "location": {
                        "top": 159,
                        "left": 1194,
                        "width": 12,
                        "height": 19