控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

图片审核

最近更新时间:2022-04-21 21:29:37

简介

本文档提供关于图片审核的相关的 API 概览以及 SDK 示例代码。

API 操作描述
图片审核 借助数据万象的持久化处理接口,实现对 COS 存量数据的涉黄、违法违规以及广告引导类图片的扫描

功能说明

图片审核的存量扫描功能通过借助数据万象的持久化处理接口,实现对 COS 存量数据的涉黄、违法违规以及广告引导类图片的扫描。图片审核请求包属于 GET 请求。

方法原型

// 基本操作
func (s *CIService) ImageRecognition(ctx context.Context, name string, DetectType string) (*ImageRecognitionResult, *Response, error)
// 支持指定更多参数
func (s *CIService) ImageAuditing(ctx context.Context, name string, opt *ImageRecognitionOptions) (*ImageRecognitionResult, *Response, error) {

请求示例

DetectType := "porn,ads"
name := "test.jpg"
res, _, err := c.CI.ImageRecognition(context.Background(), name, DetectType)


opt := &cos.ImageRecognitionOptions{
    CIProcess: "sensitive-content-recognition",
    DetectType: "porn,ads",
    DetectUrl:   "http://www.example.com/test.jpg",
    BizType:     "ce25f391a72e11eb99f********",
}
res, _, err := c.CI.ImageAuditing(context.Background(), "", opt)

参数说明

type ImageRecognitionOptions struct {
    CIProcess  string
    DetectType string
    DetectUrl  string
    Interval   int
    MaxFrames  int
    BizType    string
}

参数名称 描述 类型 是否必选
name COS 存储桶中的图片文件名称,COS 存储桶由Host指定,例如在北京的 examplebucket-1250000000 存储桶中的目录 test 下的文件 img.jpg,则 Host 填写 examplebucket-1250000000.cos.ap-beijing.myqcloud.com,ObjectKey填写 test/img.jpg。如使用 ImageAuditing 接口审核 url 图片链接,传空字符串 String
CIProcess 标识数据处理功能的字段,内容审核的值为:sensitive-content-recognition String
BizType 审核策略,不填写则使用默认策略。可在控制台进行配置,详情请参见 设置审核策略 String
DetectType 审核类型,拥有 porn(涉黄识别)、ads(广告识别)。用户可选择多种识别类型,例如 detect-type=porn,ads 表示对图片进行涉黄及广告审核 String
DetectUrl 您可以通过填写 detect-url 审核任意公网可访问的图片链接。不填写 detect-url 时,后台会默认审核 ObjectKey。填写了 detect-url 时,后台会审核 detect-url 链接,无需再填写 ObjectKey。detect-url 示例:http://www.example.com/abc.jpg String
Interval 审核 GIF 动图时,可使用该参数进行截帧配置,代表截帧的间隔。例如值设为5,则表示从第1帧开始截取,每隔5帧截取一帧,默认值5 Integer
MaxFrames 针对 GIF 动图审核的最大截帧数量,需大于0。例如值设为5,则表示最大截取5帧,默认值为5 Integer

结果说明

调用 ImageRecognition 或 ImageAuditing 函数,会解析 api 返回的 xml 内容到 ImageRecognitionResult 结构,具体返回参数可查看 图片同步审核 文档。