数据万象 -SDK 文档-文档中心-腾讯云

简介
内容审核功能是由 数据万象（Cloud Infinite，CI）提供的，数据万象将处理能力与 COS SDK 完全结合，您可以直接按照本篇文档指引进行使用。
说明
使用内容审核服务需拥有数据万象使用权限：
主账号请 单击此处 进行角色授权。
子账号请参见 授权子账号接入数据万象服务 文档。
本文档提供图片审核相关的 API 概览以及 SDK 示例代码。
API
操作描述
图片单次审核
图片审核的存量扫描功能借助数据万象的持久化处理接口，实现对对象存储（Cloud Object Storage，COS）存量数据的涉黄、违法违规以及广告引导类图片的扫描。内容审核请求包属于 GET 请求。
图片批量审核
图片批量审核接口为同步请求方式，您可以通过本接口对多个图片文件进行内容审核。该接口属于 POST 请求。
图片单次审核
功能说明
对 COS 上的图片进行审核，审核类型包括涉黄、违法违规以及广告引导类。
示例代码
    """测试ci文件内容识别的接口"""
    from qcloud_cos import CosConfig
    from qcloud_cos import CosS3Client
    from qcloud_cos.cos_comm import CiDetectType
    # 先创建 cos client
    response = client.get_object_sensitive_content_recognition(
        Bucket=test_bucket,
        Key=test_object,
        DetectUrl='https://examplebucket-1250000000.cos.ap-chongqing.myqcloud.com/tttt.jpg',
    )
    print(response)
参数说明
调用 get_object_sensitive_content_recognition 函数，具体请求参数如下：
参数名称
描述
类型
是否必选
Bucket
存储桶名称。
Sting
是
Key
对象文件名，例如 picture.jpg。
Sting
否
BizType
表示审核策略的唯一标识，您可以通过控制台上的审核策略页面，配置您希望审核的场景，如涉黄、广告、违法违规等，配置指引： 设置公共审核策略。您可以在控制台上获取到 BizType。BizType 填写时，此条审核请求将按照该审核策略中配置的场景进行审核。BizType 不填写时，将自动使用默认的审核策略。
Sting
否
Interval
截帧频率，GIF 图/长图检测专用，默认值为0，表示只会检测 GIF 图/长图的第一帧。
Int
否
MaxFrames
最大截帧数量，GIF 图/长图检测专用，默认值为1，表示只取 GIF 的第1帧图片进行审核，或长图不做切分识别。
Int
否
DetectUrl
您可以通过填写 detect-url 审核任意公网可访问的图片链接。不填写 detect-url 时，后台会默认审核 ObjectKey。填写了 detect-url 时，后台会审核 detect-url 链接，无需再填写 ObjectKey。detect-url 示例：http://www.example.com/abc.jpg。
Sting
否
LargeImageDetect
对于超过大小限制的图片是否进行压缩后再审核，取值为： 0（不压缩），1（压缩）。默认为0。注：图片压缩功能最大支持32MB的图片，且会收取图片压缩费用。
Int
否
DataId
图片标识，该字段在结果中返回原始内容，长度限制为512字节。
String
否
Async
是否异步进行审核，取值 0：同步返回结果；1：异步进行审核，默认为0。
Int
否
Callback
审核结果（Detail版本）以回调形式发送至您的回调地址，异步审核时生效，支持以http:// 或者 https:// 开头的地址，例http://www.callback.com。
String
否
返回参数说明
调用 get_object_sensitive_content_recognition 函数，会把 api 里面的 xml 返回转换成 dict，具体返回参数可查看 图片同步审核接口 文档。
图片批量审核
功能说明
对 COS 上的多张图片进行审核，审核类型包括涉黄、违法违规以及广告引导类。
示例代码
    """测试ci批量图片内容审核的接口"""
    from qcloud_cos import CosConfig
    from qcloud_cos import CosS3Client
    from qcloud_cos.cos_comm import CiDetectType
    # 先创建 cos client
    response = client.ci_auditing_image_batch(
        Bucket=bucket_name,
        Input=[{
            'Url':'https://examplebucket-1250000000.cos.ap-chongqing.myqcloud.com/porn_ocr.png',
            'DataId': 'testdataid-111111',
            'UserInfo':{
                'TokenId': 'token',
                'Nickname': 'test',
                'DeviceId': 'DeviceId-test',
                'AppId': 'AppId-test',
                'Room': 'Room-test',
                'IP': 'IP-test',
                'Type': 'Type-test',
            },
        },{
            'Object':'test-0.jpg',
            'LargeImageDetect' :1,
        },{
            'Url':'https://examplebucket-1250000000.cos.ap-chongqing.myqcloud.com/pron_plitics_ads_terrism.png',
        }]
    )
    print(response)
参数说明
调用 ci_auditing_image_batch 函数，具体请求参数如下：
参数名称
描述
类型
是否必选
Bucket
存储桶名称。
Sting
是
BizType
审核策略的唯一标识，由后台自动生成，在控制台中对应为 Biztype 值。
Sting
否
Input
需要审核的图片信息，每个 array 元素为 dict 类型，支持的参数如下
Array
是
Input 单元素的具体数据描述如下：
参数名称
描述
类型
是否必选
Object
存储在 COS 存储桶中的图片文件名称，例如在目录 test 中的文件 image.jpg，则文件名称为 test/image.jpg。Content、Object 和 Url 只能选择其中一种，传入多个时仅一个生效，按 Content，Object， Url 顺序。
Sting
否
Url
图片文件的链接地址，例如 http://a-1250000.cos.ap-shanghai.tencentcos.cn/image.jpg。Content、Object 和 Url 只能选择其中一种，传入多个时仅一个生效，按 Content、Object、 Url 顺序。
Sting
否
Content
图片文件的内容，需要先经过 base64 编码。Content、Object 和 Url 只能选择其中一种，传入多个时仅一个生效，按 Content、Object、 Url 顺序。
Sting
否
Interval
截帧频率，GIF 图检测专用，默认值为5，表示从第一帧（包含）开始每隔5帧截取一帧
Int
否
MaxFrames
最大截帧数量，GIF 图检测专用，默认值为5，表示只截取 GIF 的5帧图片进行审核，必须大于0。
Int
否
DataId
图片标识，该字段在结果中返回原始内容，长度限制为512字节。
Sting
否
LargeImageDetect
对于超过大小限制的图片是否进行压缩后再审核，取值为： 0（不压缩），1（压缩）。默认为0。注：图片压缩功能最大支持32MB的图片，且会收取图片压缩费用。
Int
否
UserInfo
用户业务字段。
dict
否
UserInfo的具体数据描述如下：
参数名称
描述
类型
是否必选
TokenId
一般用于表示账号信息，长度不超过128字节。
Sting
否
Nickname
一般用于表示昵称信息，长度不超过128字节。
Sting
否
DeviceId
一般用于表示设备信息，长度不超过128字节。
Sting
否
AppId
一般用于表示 App 的唯一标识，长度不超过128字节。
Sting
否
Room
一般用于表示房间号信息，长度不超过128字节。
Sting
否
IP
一般用于表示 IP 地址信息，长度不超过128字节。
Sting
否
Type
一般用于表示业务类型，长度不超过128字节。
Sting
否
ReceiveTokenId
一般用于表示接收消息的用户账号，长度不超过128字节。
Sting
否
Gender
一般用于表示性别信息，长度不超过128字节。
Sting
否
Level
一般用于表示等级信息，长度不超过128字节。
Sting
否
Role
一般用于表示角色信息，长度不超过128字节。
Sting
否
返回参数说明
调用 ci_auditing_image_batch 函数，会把 api 里面的 xml 返回转换成 dict，具体返回参数可参见 图片批量审核接口 文档。

API	操作描述
图片单次审核	图片审核的存量扫描功能借助数据万象的持久化处理接口，实现对对象存储（Cloud Object Storage，COS）存量数据的涉黄、违法违规以及广告引导类图片的扫描。内容审核请求包属于 GET 请求。
图片批量审核	图片批量审核接口为同步请求方式，您可以通过本接口对多个图片文件进行内容审核。该接口属于 POST 请求。

参数名称	描述	类型	是否必选
Bucket	存储桶名称。	Sting	是
Key	对象文件名，例如 picture.jpg。	Sting	否
BizType	表示审核策略的唯一标识，您可以通过控制台上的审核策略页面，配置您希望审核的场景，如涉黄、广告、违法违规等，配置指引：设置公共审核策略。您可以在控制台上获取到 BizType。BizType 填写时，此条审核请求将按照该审核策略中配置的场景进行审核。BizType 不填写时，将自动使用默认的审核策略。	Sting	否
Interval	截帧频率，GIF 图/长图检测专用，默认值为0，表示只会检测 GIF 图/长图的第一帧。	Int	否
MaxFrames	最大截帧数量，GIF 图/长图检测专用，默认值为1，表示只取 GIF 的第1帧图片进行审核，或长图不做切分识别。	Int	否
DetectUrl	您可以通过填写 detect-url 审核任意公网可访问的图片链接。不填写 detect-url 时，后台会默认审核 ObjectKey。填写了 detect-url 时，后台会审核 detect-url 链接，无需再填写 ObjectKey。detect-url 示例：http://www.example.com/abc.jpg。	Sting	否
LargeImageDetect	对于超过大小限制的图片是否进行压缩后再审核，取值为： 0（不压缩），1（压缩）。默认为0。注：图片压缩功能最大支持32MB的图片，且会收取图片压缩费用。	Int	否
DataId	图片标识，该字段在结果中返回原始内容，长度限制为512字节。	String	否
Async	是否异步进行审核，取值 0：同步返回结果；1：异步进行审核，默认为0。	Int	否
Callback	审核结果（Detail版本）以回调形式发送至您的回调地址，异步审核时生效，支持以http:// 或者 https:// 开头的地址，例http://www.callback.com。	String	否

本页目录：

简介

图片单次审核

功能说明

示例代码

参数说明

返回参数说明

图片批量审核

功能说明

示例代码

参数说明

返回参数说明