图片审核

简介

内容审核功能是由 数据万象（Cloud Infinite，CI）提供的，数据万象将处理能力与 COS SDK 完全结合，您可以直接按照本篇文档指引进行使用。

说明：

使用内容审核服务需拥有数据万象使用权限：

• 主账号请 单击此处 进行角色授权。
• 子账号请参见 授权子账号接入数据万象服务 文档。

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

图片单次审核

功能说明

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

方法原型

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

请求示例

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


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

参数说明

type ImageRecognitionOptions struct {
    CIProcess        string
    DetectUrl        string
    Interval         int
    MaxFrames        int
    BizType          string
    LargeImageDetect int
    DataId           string
    Async            int
    Callback         string
}

结果说明

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

图片批量审核

功能说明

图片批量审核接口为同步请求方式，您可以通过本接口对多个图片文件进行内容审核。该接口属于 POST 请求。

方法原型

// 图片批量审核
func (s *CIService) BatchImageAuditing(ctx context.Context, opt *BatchImageAuditingOptions) (*BatchImageAuditingJobResult, *Response, error)

请求示例

// 将 examplebucket-1250000000 和 COS_REGION 修改为真实的信息
// CI 任务需要提供 CIURL
bu, _ := url.Parse("https://examplebucket-1250000000.cos.COS_REGION.myqcloud.com")
cu, _ := url.Parse("https://examplebucket-1250000000.ci.COS_REGION.myqcloud.com")
b := &cos.BaseURL{BucketURL: bu, CIURL: cu}
c := cos.NewClient(b, &http.Client{
        Transport: &cos.AuthorizationTransport{
            SecretID:  os.Getenv("SECRETID"),
            SecretKey: os.Getenv("SECRETKEY"),
        },
})
opt := &cos.BatchImageAuditingOptions{
    Input: []cos.ImageAuditingInputOptions{
        cos.ImageAuditingInputOptions{
                DataId: "1",
                Object: "test.jpg",
        },
        cos.ImageAuditingInputOptions{
                DataId: "2",
                Url: "http://www.example.com/test.jpg",
        },
    },
    Conf: &cos.ImageAuditingJobConf{
    },
}
res, _, err := c.CI.BatchImageAuditing(context.Background(), opt)

参数说明

type ImageAuditingInputOptions struct {
    DataId           string
    Object           string
    Url              string
    Interval         int
    MaxFrames        int
    LargeImageDetect int
    UserInfo         *UserExtraInfo
}
type UserExtraInfo struct {
    TokenId  string
    Nickname string
    DeviceId string
    AppId    string
    Room     string
    IP       string
    Type     string
}
type ImageAuditingJobConf struct {
    BizType    string
    Async      int
    Callback   string
}
type BatchImageAuditingOptions struct {
    Input   []ImageAuditingInputOptions
    Conf    *ImageAuditingJobConf
}

结果说明

调用 BatchImageAuditing 函数，会解析 api 返回的 xml 内容到 BatchImageAuditingJobResult 结构，具体返回参数可查看 图片批量审核 文档。

查询图片审核任务结果

功能说明

用于查询一个图片审核任务的结果详情。该接口属于 GET 请求。

方法原型

// 图片审核-查询任务
func (s *CIService) GetImageAuditingJob(ctx context.Context, jobid string) (*GetImageAuditingJobResult, *Response, error)

请求示例

jobId := "iace25f391a72e11eb99f********"
res, _, err := c.CI.GetImageAuditingJob(context.Background(), jobId)

参数说明

结果说明

调用 GetImageAuditingJob 函数，会解析 api 返回的 xml 内容到 GetImageAuditingJobResult 结构，具体返回参数可查看 查询图片审核任务结果 文档。