对象存储直播审核

简介
本文档提供视频审核相关的 API 概览以及 SDK 示例代码。
注意
使用内容审核服务需拥有数据万象使用权限：
主账号请 单击此处 进行角色授权。
子账号请参见 授权子账号接入数据万象服务 文档。
 该功能需要 COS Python SDK v5 1.9.10 及以上版本。如果当前您的COS Python SDK v5版本低于1.9.10，请升级版本。 
API
操作描述
﻿提交直播审核任务﻿
用于提交一个直播审核任务。
﻿查询直播审核任务结果﻿
用来查询指定的直播审核任务。
﻿取消直播审核任务﻿
用于取消一个在进行中的直播审核任务。
提交直播审核任务
功能说明
本接口用于提交一个直播流审核任务。直播流审核功能为异步任务方式，您可以通过提交直播流审核任务审核您的直播流，然后通过查询直播流审核任务接口查询审核结果。
示例代码
def ci_live_video_auditing():    
    # 提交直播审核任务    
    response = client.ci_auditing_live_video_submit(        
        Bucket=bucket_name,        
        Url='rtmp://example.com/live/123',        
        Callback='http://callback.com/',        
        DataId='testdataid-111111',        
        UserInfo={            
            'TokenId': 'token',            
            'Nickname': 'test',            
            'DeviceId': 'DeviceId-test',            
            'AppId': 'AppId-test',            
            'Room': 'Room-test',            
            'IP': 'IP-test',            
            'Type': 'Type-test',        
        },        
        BizType='d0292362d07428b4f6982a31bf97c246',        
        CallbackType=1    
    )        
    print(response)
参数说明
调用 ci_auditing_live_video_submit 函数，具体请求参数如下：
参数名称
描述
类型
是否必选
Bucket
存储桶名称。
String
是
BizType
表示审核策略的唯一标识，您可以通过控制台上的审核策略页面，配置您希望审核的场景，如涉黄、广告、违法违规等，配置指引： 设置公共审核策略。您可以在控制台上获取到 BizType。BizType 填写时，此条审核请求将按照该审核策略中配置的场景进行审核。BizType 不填写时，将自动使用默认的审核策略。
String
是
Url
需要审核的直播流播放地址，例如 rtmp://example.com/live/123。
String
是
Callback
回调地址，以 http:// 或者 https:// 开头的地址。
String
否
CallbackType
回调片段类型，有效值：1（回调全部截帧和音频片段）、2（回调违规截帧和音频片段）。默认为1 。
Int
否
UserInfo
用户业务字段。可传入的参数请参见 提交直播审核任务 的 UserInfo 字段。
Dict
否
DataId
该字段在审核结果中会返回原始内容，长度限制为512字节。您可以使用该字段对待审核的数据进行唯一业务标识。
String
否
StorageConf
包含直播流转存的配置信息。参数请参见提交直播审核任务 的 StorageConf 字段。
Dict
否
返回参数说明
调用 ci_auditing_live_video_submit 函数，会把 api 里面的 xml 返回转换成 Dict，具体返回参数可参见 提交直播审核任务 文档。
查询直播审核任务结果
功能说明
本接口用于主动查询指定的直播审核任务结果。直播审核功能为异步任务方式，您可以通过提交直播审核任务审核您的直播流，然后通过查询直播审核任务接口轮询获取审核结果。
示例代码
def ci_auditing_video_query():
    response = client.ci_auditing_video_query(Bucket=bucket_name, 
                                              JobID="avxxxxxxxxxxxxxxxx")
    print(response)
参数说明
调用 ci_auditing_video_query 函数，具体请求参数如下：
参数名称
描述
类型
是否必选
Bucket
存储桶名称。
String
是
JobID
任务 ID。
String
是
返回参数说明
调用 ci_auditing_video_query 函数，会把 api 里面的 xml 返回转换成 Dict，具体返回参数可参见 查询直播审核任务结果 文档。
取消直播审核任务
功能说明
本接口用于取消一个在进行中的直播审核任务，成功取消后将返回已终止任务的 JobID。
示例代码
def ci_live_video_auditing_cancel():    
    # 取消直播审核任务    
    response = client.ci_auditing_live_video_cancle(
                Bucket=bucket_name,
                JobID='avdefxxxxxxxxxxxxxxxxxxxxxxx',
    )
    print(response)
参数说明
调用 ci_auditing_live_video_cancle 函数，具体请求参数如下：
参数名称
描述
类型
是否必选
Bucket
存储桶名称。
String
是
JobID
任务 ID。
String
是
返回参数说明
调用 ci_auditing_live_video_cancle 函数，会把 api 里面的 xml 返回转换成 Dict，具体返回参数可参见 取消直播审核任务 文档。
﻿
﻿
﻿

API	操作描述
提交直播审核任务	用于提交一个直播审核任务。
查询直播审核任务结果	用来查询指定的直播审核任务。
取消直播审核任务	用于取消一个在进行中的直播审核任务。

参数名称	描述	类型	是否必选
Bucket	存储桶名称。	String	是
BizType	表示审核策略的唯一标识，您可以通过控制台上的审核策略页面，配置您希望审核的场景，如涉黄、广告、违法违规等，配置指引：设置公共审核策略。您可以在控制台上获取到 BizType。BizType 填写时，此条审核请求将按照该审核策略中配置的场景进行审核。BizType 不填写时，将自动使用默认的审核策略。	String	是
Url	需要审核的直播流播放地址，例如 rtmp://example.com/live/123。	String	是
Callback	回调地址，以 http:// 或者 https:// 开头的地址。	String	否
CallbackType	回调片段类型，有效值：1（回调全部截帧和音频片段）、2（回调违规截帧和音频片段）。默认为1 。	Int	否
UserInfo	用户业务字段。可传入的参数请参见提交直播审核任务的 UserInfo 字段。	Dict	否
DataId	该字段在审核结果中会返回原始内容，长度限制为512字节。您可以使用该字段对待审核的数据进行唯一业务标识。	String	否
StorageConf	包含直播流转存的配置信息。参数请参见提交直播审核任务的 StorageConf 字段。	Dict	否

直播审核

本页目录：

简介

提交直播审核任务

功能说明

示例代码

参数说明

返回参数说明

查询直播审核任务结果

功能说明

示例代码

参数说明

返回参数说明

取消直播审核任务

功能说明

示例代码

参数说明

返回参数说明