音频审核

简介

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

说明：

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

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

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

创建任务

PutAudioAuditingJob 接口用来提交一个音频审核任务。您可以通过主动设置回调地址接收审核信息，也可以通过 JobId 进行查询。

方法原型

func (s *CIService) PutAudioAuditingJob(ctx context.Context, opt *PutAudioAuditingJobOptions) (*PutAudioAuditingJobResult, *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.PutAudioAuditingJobOptions{
    InputObject: "test.mp3",
    Conf: &cos.AudioAuditingJobConf{
    },
}
res, _, err := c.CI.PutAudioAuditingJob(context.Background(), opt)

参数说明

type PutAudioAuditingJobOptions struct {
    InputObject   string
    InputUrl      string
    InputDataId   string
    InputUserInfo *UserExtraInfo
    Conf          *AudioAuditingJobConf
}
type UserExtraInfo struct {
    TokenId  string
    Nickname string
    DeviceId string
    AppId    string
    Room     string
    IP       string
    Type     string
}
type AudioAuditingJobConf struct {
    Callback        string
    CallbackVersion string
    BizType         string
}

结果说明

调用 PutAudioAuditingJob 函数，会解析 api 返回的 xml 内容到 PutAudioAuditingJobResult 结构，具体返回参数可查看 提交音频审核任务 文档。

查询任务

GetAudioAuditingJob 接口用来查询指定的音频审核任务。您可以根据音频审核任务的 JobId 来查询音频审核结果。

方法原型

func (s *CIService) GetAudioAuditingJob(ctx context.Context, jobid string) (*GetAudioAuditingJobResult, *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"),
        }
})
jobId := "sace25f391a72e11eb99f********"
res, _, err := c.CI.GetAudioAuditingJob(context.Background(), jobId)

参数说明

结果说明

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