图片审核接口

更新时间：2023-07-05

提交图片审核（同步）

用户提供图片URL或BOS路径，进行图片审核。

该接口为同步接口，即直接在HTTP response body中返回图片审核结果。

请求语法

PUT /v<version>/image HTTP/1.1
host: vcr.bj.baidubce.com
authorization: <bce-authorization-string>
x-bce-date: <bce-authorization-utc-date>
content-type: application/json

请求参数

无

请求体

参数	类型	描述	是否必须
source	String	图片路径，支持bos或url两种格式	是
preset	String	模板	否

说明：

对于BOS图片，source="bos://<bos-bucket>/<bos-object>”，例如"bos://testbucket/dir/image.jpg”，用户需要确保bos路径可访问。

对于url图片，source="http://domain.com/dir/image.jpg"，目前支持http/https两种协议的url，用户需确保该url外网可访问。

请求示例

提供图片BOS路径进行审核：

PUT /v1/image HTTP/1.1
host: vcr.bj.baidubce.com
content-type: application/json
authorization: <bce-authorization-string>
x-bce-date: <bce-authorization-utc-date>

{
    "source": "bos://demo_bucket/demo_image.jpg"
}

提供图片URL进行审核：

PUT /v1/image HTTP/1.1
host: vcr.bj.baidubce.com
content-type: application/json
authorization: <bce-authorization-string>
x-bce-date: <bce-authorization-utc-date>

{
    "source": "http://pic28.photophoto.cn/20130725/0036036328955515_b.jpg"
}

响应参数

无

响应体

参数	类型	描述
source	String	图片路径
label	String	审核结果标记
results	Array	审核结果，仅当label=REJECT时存在
+ type	String	审核类型
+ items	Array	审核结果项数组
++ subType	String	审核项
++ target	String	审核物料类型，可选值：thumbnail, character
++ confidence	Double	该审核结果项的置信度，0~100的浮点数
++ label	String	审核结果项标记
++ extra	String	额外信息，如有；例如政治敏感人物识别出来的人名
++ evidence	Object	审核证据
+++ location	Object	证据位置信息
++++ leftOffsetInPixel	Number	左偏移
++++ topOffsetInPixel	Number	上偏移
++++ widthInPixel	Number	宽度
++++ heightInPixel	Number	高度
+++ text	String	文本证据

响应示例

HTTP/1.1 200 OK
{
    "source": "bos://demo_bucket/demo_image.jpg",
    "label": "REJECT",
    "results": [ {
        "type": "politician",
        "items": {
            "subType": "politician_positive",
            "target": "character",
            "confidence": 92.37,
            "label": "REJECT",
            "extra": "达赖",
            "evidence": {
                "text": "达赖是文本识别的涉政文本",
                "location": {
                    "leftOffsetInPixel": 50,
                    "topOffsetInPixel": 50,
                    "widthInPixel": 200,
                    "heightInPixel": 20
                }
            }
        }
    } ]
}

提交图片审核（异步）

用户提供图片URL或BOS路径，进行图片审核,支持GIF图片审核（GIF图片帧数不能超过100张）。

该接口为异步接口，使用通知服务将图片审核结果进行回调。用户也可在短时间内（10分钟）通过图片异步审核查询接口来查询缓存的审核结果。

请求语法

PUT /v<version>/image HTTP/1.1
host: vcr.bj.baidubce.com
authorization: <bce-authorization-string>
x-bce-date: <bce-authorization-utc-date>
content-type: application/json

请求参数

无

请求体

参数	类型	描述	是否必须
source	String	图片路径，支持bos或url两种格式	是
preset	String	模板	否
notification	String	通知名称,如果为空则审核结果不进行回调通知	否

说明：

对于BOS图片，source="bos://<bos-bucket>/<bos-object>”，例如"bos://testbucket/dir/image.jpg”，用户需要确保bos路径可访问。

对于url图片，source="http://domain.com/dir/image.jpg"，目前仅支持http协议url，用户需要确保该url外网可访问。

请求示例

提供图片BOS路径进行审核：

PUT /v2/image HTTP/1.1
host: vcr.bj.baidubce.com
content-type: application/json
authorization: <bce-authorization-string>
x-bce-date: <bce-authorization-utc-date>

{
    "source": "bos://demo_bucket/demo_image.jpg",
    "preset": "default",
    "notification": "notification_1"
}

提供图片URL进行审核：

PUT /v2/image HTTP/1.1
host: vcr.bj.baidubce.com
content-type: application/json
authorization: <bce-authorization-string>
x-bce-date: <bce-authorization-utc-date>

{
    "source": "http://pic28.photophoto.cn/20130725/0036036328955515_b.jpg",
    "preset": "default",
    "notification": "notification_1"
}

响应参数

无

响应体

无

响应示例

HTTP/1.1 200 OK

图片异步审核查询

用户提供发起图片异步审核的信息，查询审核结果，结果保存时间10分钟。

请求语法

GET /v<version>/image HTTP/1.1
host: vcr.bj.baidubce.com
authorization: <bce-authorization-string>
x-bce-date: <bce-authorization-utc-date>
content-type: application/json

请求参数

参数	类型	描述	是否必须
source	String	图片路径，支持bos或url两种格式	是
preset	String	模板,该字段与发起图片异步审核请求时保持一致	否
description	String	图片审核描述，默认空字符串，不超过256字符	否

请求体

无

请求示例

提供图片审核信息进行查询：

GET /v2/image?source=bos%3a%2f%2ftestbucket%2fdir%2fdemo_image.jpg&preset=default HTTP/1.1
host: vcr.bj.baidubce.com
content-type: application/json
authorization: <bce-authorization-string>
x-bce-date: <bce-authorization-utc-date>

响应参数

无

响应体

参数	类型	描述
source	String	图片路径
description	String	图片审核描述，默认空字符串，不超过256字符
label	String	审核结果标记,status为FINISHED时存在
status	String	PROVISIONING/PROCESSING/FINISHED/ERROR, 审核任务状态：创建/审核中/完成/错误
error	String	审核错误
+ code	String	错误码
+ message	String	错误信息
results	Array	审核结果，仅当label=REJECT时存在
+ type	String	审核类型
+ items	Array	审核结果项数组
++ subType	String	审核项
++ target	String	审核物料类型，可选值：thumbnail, character
++ confidence	Double	该审核结果项的置信度，0~100的浮点数
++ label	String	审核结果项标记
++ extra	String	额外信息，如有；例如政治敏感人物识别出来的人名
++ evidence	Object	审核证据
+++ location	Object	证据位置信息
++++ leftOffsetInPixel	Number	左偏移
++++ topOffsetInPixel	Number	上偏移
++++ widthInPixel	Number	宽度
++++ heightInPixel	Number	高度
+++ text	String	文本证据

响应示例

HTTP/1.1 200 OK
{
    "source": "bos://demo_bucket/demo_image.jpg",
    "description":"这是描述",
    "label": "REJECT",
    "status": "FINISHED",
    "results": [ {
        "type": "politician",
        "items": {
            "subType": "politician_positive",
            "target": "character",
            "confidence": 92.37,
            "label": "REJECT",
            "extra": "达赖",
            "evidence": {
                "text": "达赖是文本识别的涉政文本",
                "location": {
                    "leftOffsetInPixel": 50,
                    "topOffsetInPixel": 50,
                    "widthInPixel": 200,
                    "heightInPixel": 20
                }
            }
        }
    } ]
}

图片审核结果说明

图片审核结果

每张图片的审核结果格式为：

参数	类型	描述
source	String	图片路径
label	String	审核结果标记，可选值：NORMAL/REVIEW/REJECT
results	Array	审核结果
+ type	String	审核类型
+ items	Array	审核结果项数组

图片审核标记

图片审核结果标记label，简称审核标记，其可选值包括NORMAL/REVIEW/REJECT，分别表示正常/疑似违规/确认违规。

图片审核标记是根据 VCR 审核结果的置信度和VCR内部配置疑似置信度阈值和确认置信度阈值生成的。

举个例子，VCR在对图像进行审核时，判断某一张图片为涉黄场景下的色情类图片的置信度为C，用户使用的审核模板中配置的疑似置信度阈值和确认置信度阈值分别为T_Review和T_Reject：

C < T_Review，VCR忽视该图片的涉黄-色情审核结果；
T_Review <= C < T_Reject，VCR输出一个label=REVIEW的审核结果项；
T_Reject <= C，VCR会输出一个label=REJECT的审核结果项。

图片的审核结果标记由各审核结果项（见下）汇总得到，汇总规则：

审核结果数组为空，即没有审核结果项时视频label = NORMAL；
任一审核结果项label = REJECT时，图片label = REJECT；
其余情况下（所有审核结果项label = REVIEW）图片label = REVIEW

图片审核类型

图片审核结果中的type表示”审核类型”。每类审核场景下包含着多种审核类型，不同审核类型支持的审核物料也不一样。随着智能内容审核服务的迭代升级，会不断扩展审核场景和审核类型。

审核类型列表

审核场景	子审核类型	描述	支持的审核物料类型
涉黄审核	sexual_porn	色情审核	thumbnail,audio,character,speech
涉黄审核	sexual_sexy	性感审核	thumbnail
涉黄审核	sexual_intimacy	亲密行为审核	thumbnail
涉黄审核	sexual_vulgar	低俗行为	thumbnail
涉黄审核	sexual_special	特殊行为	thumbnail
暴恐审核	terrorist_group	暴恐组织审核	thumbnail,speech,character
暴恐审核	terrorist	暴恐人物审核	thumbnail,speech,character
暴恐审核	terror_event	暴力事件审核	thumbnail,speech,character
涉政审核	politician	涉政人物审核	thumbnail,character,speech
涉政审核	political_event	涉政事件审核	character,speech
涉政审核	political_group	涉政组织审核	thumbnail,character,speech
广告审核	ad_brand	品牌广告审核	thumbnail,character,speech
广告审核	ad_marketing	欺诈及营销广告审核	thumbnail,character,speech
广告审核	ad_brand_negative	品牌负面评论审核	character,speech
违禁审核	bad_behavior	不良行为审核	thumbnail
违禁审核	illegal_gamble	赌博审核	character,speech
违禁审核	illegal_forgery	假冒伪劣及造假盗窃审核	character,speech
违禁审核	illegal_trade	非法交易审核	character,speech
违禁审核	illegal_privacy	非法获取私人信息审核	character,speech
质量审核审核	disgust	恶心审核	thumbnail

图片审核结果项

在审核结果中，每个审核类型都对应一个items，表示该子审核的结果。数组中的元素称为审核结果项，其具体格式为：

参数	类型	描述
subType	String	审核项
target	String	审核物料类型，可选值：thumbnail, character
confidence	Double	审核结果项的置信度，0~100的浮点数
label	String	审核结果项标记
extra	String	额外信息，如有；例如涉政人物审核出来的人名
evidence	Object	图片审核证据

图片审核项

审核结果中的subType表示”审核项”。每种审核类型下细分了不同审核项。

审核项列表

审核场景	审核类型	审核项	审核项描述
涉黄审核	sexual_porn	behavior,sm,products,children,art	性行为及露点及招嫖,SM,性用品及性玩具,儿童,艺术品色情
涉黄审核	sexual_sexy	male,female	男性衣着暴露,女性衣着暴露
涉黄审核	sexual_intimacy	intimacy	亲密行为
涉黄审核	sexual_vulgar	vulgar	低俗行为
涉黄审核	sexual_special	pregnant	孕肚裸露
暴恐审核	terrorist_group	terrorist_group	恐怖组织
暴恐审核	terrorist	terrorist	暴恐人物
暴恐审核	terror_event	blood,corpse,murder,explosion,riot,weapon,police	血腥,尸体,绑架及杀人,爆炸火灾,暴乱,军事武器,警察部队
涉政审核	politician	politician_positive,politician_negative,bad_artist	涉政正面人物,涉政负面人物,劣迹艺人
涉政审核	political_event	political_event_positive,political_event_negative	涉政正面事件,涉政负面事件
涉政审核	political_group	political_group_positive,political_group_negative	涉政正面组织,涉政负面组织
广告审核	ad_brand	brand	品牌标识
广告审核	ad_marketing	arcode,contact,website,commercial,watermark	二维码,联系方式,网址,软文推广,水印
广告审核	ad_brand_negative	brand_negative_comment	品牌负面评论
违禁审核	bad_behavior	smoke,drink,bad_behavior_gamble,drug	吸烟,喝酒,赌博,毒品
违禁审核	illegal_gamble	gamble	赌博
违禁审核	illegal_forgery	forgery	假冒伪劣及造假盗窃
违禁审核	illegal_trade	trade	非法交易
违禁审核	illegal_privacy	privacy	非法获取私人信息
质量审核	disgust	disgust_image	恶心图
官方文本黑库	official_text_black_lib	baidu_illegal_textlib	违禁词库
官方图片黑库	image_black_lib	default_image_black_lib,meg_image_lib	百度云风控,互联网安全管控

图片审核证据

根据不同的审核物料类型，审核证据也不相同。审核证据的格式为：

参数	类型	描述
location	Object	证据位置信息
+ leftOffsetInPixel	Number	左偏移
+ topOffsetInPixel	Number	上偏移
+ widthInPixel	Number	宽度
+ heightInPixel	Number	高度
text	String	文本证据

具体地说：

target=thumbnail，审核证据=location
target=character，审核证据=location + text

图片审核错误码列表

图片审核失败时，会返回审核失败错误信息。目前VCR支持如下错误码：

错误码	错误信息	备注
InvalidImage	only support jpg/png/bmp images	图片审核只支持jpg/png/bmp格式的图片
InvalidImage	image size should < 4MB and width/height < 4096	图片大小需小于4MB且长度/宽度须小于4096
InvalidImage	download image error	下载图片失败，确认图片是否存在
InternalError	Service Internal Error	VCR服务内部错误，可以尝试重试

图片审核结果示例

图片审核结果：

{
    "source": "bos://demo_bucket/demo_image.jpg",
    "label": "REJECT",
    "results": [ {
        "type": "politician",
        "items": {
            "subType": "politician_positive",
            "target": "character",
            "confidence": 92.37,
            "label": "REJECT",
            "extra": "达赖",
            "evidence": {
                "text": "达赖是文本识别的涉政文本",
                "location": {
                    "leftOffsetInPixel": 50,
                    "topOffsetInPixel": 50,
                    "widthInPixel": 200,
                    "heightInPixel": 20
                }
            }
        }
    },
    {
        "type": "ad_brand",
        "items": {
            "subType": "brand",
            "target": "character",
            "confidence": 92.37,
            "label": "REJECT",
            "evidence": {
                "text": "头条号",
                "location": {
                    "leftOffsetInPixel": 50,
                    "topOffsetInPixel": 50,
                    "widthInPixel": 200,
                    "heightInPixel": 20
                }
            }
        }
    } ]
}

音频审核接口

文本审核接口

百度智能云

媒体内容审核 VCR

媒体内容审核 VCR

图片审核接口

提交图片审核（同步）

提交图片审核（异步）

图片异步审核查询

图片审核结果说明

图片审核结果

图片审核标记

图片审核类型

图片审核结果项

图片审核项

图片审核证据

图片审核错误码列表

图片审核结果示例