图片审核接口

提交图片审核(同步)

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

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

请求语法

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

请求参数

请求体

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

说明:

  1. 对于BOS图片,source="bos://<bos-bucket>/<bos-object>”,例如"bos://testbucket/dir/image.jpg”,用户需要确保bos路径可访问。
  2. 对于url图片,source="http://domain.com/dir/image.jpg",目前仅支持http协议url,用户需要确保该url外网可访问。

请求示例

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

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

{
    "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>

{
    "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>
content-type: application/json

请求参数

请求体

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

说明:

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

{
    "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>

{
    "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>
content-type: application/json

请求参数

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

请求体

请求示例

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

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>

响应参数

响应体

参数 类型 描述
source String 图片路径
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",
    "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_ReviewT_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
暴恐审核 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
违禁审核 illegal_gamble 赌博审核 character,speech
违禁审核 illegal_forgery 假冒伪劣及造假盗窃审核 character,speech
违禁审核 illegal_trade 非法交易审核 character,speech
违禁审核 illegal_privacy 非法获取私人信息审核 character,speech

图片审核结果项

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

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

图片审核项

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

审核项列表

审核场景 审核类型 审核项 审核项描述
涉黄审核 sexual_porn behaviorsm,products 性行为、露点及嫖娼,SM,性用品及性玩具
涉黄审核 sexual_sexy male,female 男性衣着暴露,女性衣着暴露
涉黄审核 sexual_intimacy intimacy 亲密行为
涉黄审核 sexual_vulgar vulgar 低俗行为
暴恐审核 terrorist_group terrorist_group 恐怖组织
暴恐审核 terrorist terrorist 暴恐人物
暴恐审核 terror_event blood,corpse,murder,explosion,riot,weapon,police 血腥,尸体,绑架及杀人,爆炸火灾,暴乱场面,军事武器,警察部队
涉政审核 politician politician_positive, politician_negative 涉政正面人物,涉政负面人物
涉政审核 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 二维码,联系方式,网站,软文推广
违禁审核 illegal_gamble gamble 赌博
违禁审核 illegal_forgery forgery 假冒伪劣及造假盗窃
违禁审核 illegal_trade trade 非法交易
违禁审核 illegal_privacy privacy 非法获取私人信息

图片审核证据

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

参数 类型 描述
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
                }
            }
        }
    } ]
}