视频直播流审核增强版API

接入指引

1. 注册阿里云账号：立即注册，按照操作提示完成账号注册。

2. 开通内容安全按量付费：请确保已开通服务，具体操作，请参见开通服务。开通不收费，接口接入使用后系统会按使用量自动出账，具体信息，请参见计费说明。您也可以购买按量抵扣资源包，资源包相较于后付费存在一定阶梯抵扣，适合使用量级可预期和较大的用户，具体信息，请参见购买按量抵扣资源包。

3. 创建AccessKey：请确保您已通过RAM创建AccessKey，具体操作，请参见创建AccessKey。如果您使用的是RAM用户（子账号）AccessKey，您需要通过阿里云账号（主账号）给RAM用户赋予AliyunYundunGreenWebFullAccess权限，具体操作，请参见RAM授权。

4. 开发接入：推荐使用SDK方式调用。具体信息，请参见视频审核增强版SDK及接入指南。

5. 视频直播流审核服务包含以下3个接口：

   • VideoModeration：提交直播审核任务

   • VideoModerationResult：获取直播审核任务结果

   • VideoModerationCancel：取消直播审核任务

提交审核任务

接口说明

• 业务接口：VideoModeration，视频直播流仅提供异步检测接口。

• 支持的地域及接入地址：

  地域	外网接入地址	内网接入地址	支持的服务
  华东2（上海）	green-cip.cn-shanghai.aliyuncs.com	green-cip-vpc.cn-shanghai.aliyuncs.com	liveStreamDetection
  华北2（北京）	green-cip.cn-beijing.aliyuncs.com	green-cip-vpc.cn-beijing.aliyuncs.com
  华东1（杭州）	green-cip.cn-hangzhou.aliyuncs.com	green-cip-vpc.cn-hangzhou.aliyuncs.com
  华南1（深圳）	https://green-cip.cn-shenzhen.aliyuncs.com	green-cip-vpc.cn-shenzhen.aliyuncs.com
  新加坡	green-cip.ap-southeast-1.aliyuncs.com	green-cip-vpc.ap-southeast-1.aliyuncs.com	liveStreamDetection_cb

• 计费信息：

  该接口为收费接口。会根据您设置的直播画面检测策略和直播语音检测策略进行计费，直播画面可选择多个服务（service），将按照画面截帧数量*每个服务的单价进行累加计费。如果同时检测直播中的语音内容违规，则还将增加视频时长*语音违规功能的单价的费用。关于计费方式，请参见计费说明。

• 检测对象：支持检测直播流。

• 返回结果：异步检测任务不会实时返回检测结果，您需要通过callback或者轮询的方式获取检测结果。检测结果最长保留24小时。

  • callback获取检测结果：提交异步检测任务时，在请求参数中传入callback参数，用来自动接收检测结果。

  • 轮询获取检测结果：提交异步检测任务时，无需传入callback参数；提交异步检测任务后，调用结果查询接口获取检测结果。

• 直播流要求：

  • 直播流支持以下协议：RTMP、HLS、HTTP-FLV、RTSP。

  • 直播流时长限制：单个视频流检测任务最长支持24小时，超过24小时任务自动结束。

• 检测规则配置：

  • 初次调用时请在内容安全控制台进行直播审核规则设置。

  • 如果您不设置，直播审核增强版API的默认配置如下：

    直播流检测（liveStreamDetection）	直播流检测_海外版（liveStreamDetection_cb）
    固定频率截帧：1秒/帧 视频画面检测服务：视频/直播截图检测（liveStreamCheck） 视频语音检测：开启 视频语音检测服务：社交娱乐直播检测（live_stream_detection） 结果返回方式：仅返回有检出风险的结果	固定频率截帧：1秒/帧 视频画面检测服务：通用基线检测_海外版（liveStreamCheck_cb） 视频语音检测：开启 视频语音检测服务：社交娱乐直播检测（live_stream_detection_cb） 结果返回方式：仅返回有检出风险的结果

QPS限制

本接口的单用户QPS限制为100次/秒，并发审核路数限制为50路（即同一时间只能处理50个任务，如需要提升并发路数请咨询您的商务经理）。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。

调试

在接入前，您也可以通过阿里云OpenAPI在线调试VideoModeration接口，查看调用示例代码及SDK依赖信息，方便概览接口的使用方法和参数。

请求参数

表1 ServiceParameters

返回数据

示例

请求示例

{
    "Service": "liveStreamDetection",
    "ServiceParameters": {
        "url": "http://www.aliyundoc.com/a.flv",
        "dataId": "videoId****",
        "liveId": "liveId****"
    }
}

正常返回示例

{
    "Msg": "OK",
    "Code": 200,
    "Data":
    {
        "TaskId": "AAAAA-BBBBB",
        "DataId": "videoId****"
    },
    "RequestId": "ABCD1234-1234-1234-1234-123****"
}

获取直播审核任务结果

接口说明

• 业务接口：VideoModerationResult。

• 计费信息：该接口不计费。

• 查询超时：建议您将查询间隔设置为30秒（即在提交异步检测任务30秒后查询结果），最长不能超出24小时，否则结果将会自动删除。

• 结果返回：如果直播在进行中，则每次查询返回最近10条检测结果；如果直播流已经结束，则会返回所有检测结果。

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。

调试

在接入前，您也可以通过阿里云OpenAPI在线调试VideoModerationResult接口，查看调用示例代码及SDK依赖信息，方便概览接口的使用方法和参数。

请求参数

表1 ServiceParameters

返回数据

表2 Data

表3 FrameResult

表4 FrameSummarys

表5 Frames

表6 Results

表7 Result

表8 audioResult

表9 AudioSummarys

表10 SliceDetails

示例

请求示例

{
    "Service": "liveStreamDetection",
    "ServiceParameters": {
        "taskId": "abcd****"
    }
}

正常返回示例

• 仅检测直播图画

{
    "Code": 200,
    "RequestId": "25106421-XXXX-XXXX-XXXX-15DA5AAAC546",
    "Message": "success finished",
    "Data": {
        "DataId": "dc16c28f-xxxx-xxxx-xxxx-51efe0131080",
        "LiveId": "live0307-0728-****",
        "RiskLevel": "high",
        "FrameResult": {
            "FrameNum": 2,
            "FrameSummarys": [
                {
                    "Label": "violent_explosion",
                    "Description": "疑似含有烟火类内容元素",
                    "LabelSum": 8
                },
                {
                    "Label": "sexual_cleavage",
                    "Description": "疑似含有包含肢体裸露或性感内容",
                    "LabelSum": 8
                }
            ],
            "RiskLevel": "medium",
            "Frames": [
                {
                    "Offset": 1,
                    "RiskLevel": "none",
                    "Results": [
                        {
                            "Result": [
                                {
                                    "Label": "nonLabel",
                                    "Description": "未检测出风险"
                                }
                            ],
                            "Service": "baselineCheck"
                        },
                        {
                            "Result": [
                                {
                                    "Label": "nonLabel",
                                    "Description": "未检测出风险"
                                }
                            ],
                            "Service": "baselineCheck_pro"
                        }
                    ],
                    "TempUrl": "http://abc.oss-cn-shanghai.aliyuncs.com/test1.jpg",
                    "Timestamp": 1704769999000
                },
                {
                    "Offset": 2,
                    "RiskLevel": "medium",
                    "Results": [
                        {
                            "Result": [
                                {
                                    "Confidence": 74.18,
                                    "Label": "violent_explosion",
                                    "Description": "疑似含有烟火类内容元素"
                                }
                            ],
                            "Service": "baselineCheck"
                        },
                        {
                            "Result": [
                                {
                                    "Confidence": 78.88,
                                    "Label": "sexual_cleavage",
                                    "Description": "疑似含有包含肢体裸露或性感内容"
                                }
                            ],
                            "Service": "baselineCheck_pro"
                        }
                    ],
                    "TempUrl": "http://abc.oss-cn-shanghai.aliyuncs.com/test2.jpg",
                    "Timestamp": 1704769989000
                }
            ]
        }
    }
}

• 同时检测直播图画和直播语音

{
    "Code": 200,
    "RequestId": "25106421-XXXX-XXXX-XXXX-15DA5AAAC546",
    "Message": "success finished",
    "Data": {
        "DataId": "dc16c28f-xxxx-xxxx-xxxx-51efe0131080",
        "LiveId": "live0307-0728-****",
        "RiskLevel": "high",
        "AudioResult": {
            "AudioSummarys": [
                {
                    "Label": "sexual_sounds",
                    "LabelSum": 3
                }
            ],
            "RiskLevel": "high",
            "SliceDetails": [
                {
                    "EndTime": 60,
                    "EndTimestamp": 1698912813192,
                    "Labels": "",
                    "RiskLevel": "none",
                    "StartTime": 30,
                    "StartTimestamp": 1698912783192,
                    "Text": "内容安全",
                    "Url": "http://abc.oss-cn-shanghai.aliyuncs.com/test.wav"
                },
                {
                    "EndTime": 30,
                    "EndTimestamp": 1698912813192,
                    "Extend": "{\"customizedWords\":\"服务\",\"customizedLibs\":\"test\"}",
                    "Labels": "C_customized",
                    "RiskLevel": "high",
                    "StartTime": 0,
                    "StartTimestamp": 1698912783192,
                    "Text": "欢迎使用阿里云内容安全服务",
                    "Url": "http://abc.oss-cn-shanghai.aliyuncs.com/test.wav"
                }
            ]
        },
        "FrameResult": {
            "FrameNum": 2,
            "FrameSummarys": [
                {
                    "Label": "violent_explosion",
                    "Description": "疑似含有烟火类内容元素",
                    "LabelSum": 8
                },
                {
                    "Label": "sexual_cleavage",
                    "Description": "疑似含有包含肢体裸露或性感内容",
                    "LabelSum": 8
                }
            ],
            "RiskLevel": "medium",
            "Frames": [
                {
                    "Offset": 1,
                    "RiskLevel": "none",
                    "Results": [
                        {
                            "Result": [
                                {
                                    "Label": "nonLabel",
                                    "Description": "未检测出风险"
                                }
                            ],
                            "Service": "baselineCheck"
                        },
                        {
                            "Result": [
                                {
                                    "Label": "nonLabel",
                                    "Description": "未检测出风险"
                                }
                            ],
                            "Service": "baselineCheck_pro"
                        }
                    ],
                    "TempUrl": "http://abc.oss-cn-shanghai.aliyuncs.com/test1.jpg",
                    "Timestamp": 1704769999000
                },
                {
                    "Offset": 2,
                    "RiskLevel": "medium",
                    "Results": [
                        {
                            "Result": [
                                {
                                    "Confidence": 74.18,
                                    "Label": "violent_explosion",
                                    "Description": "疑似含有烟火类内容元素"
                                }
                            ],
                            "Service": "baselineCheck"
                        },
                        {
                            "Result": [
                                {
                                    "Confidence": 78.88,
                                    "Label": "sexual_cleavage",
                                    "Description": "疑似含有包含肢体裸露或性感内容"
                                }
                            ],
                            "Service": "baselineCheck_pro"
                        }
                    ],
                    "TempUrl": "http://abc.oss-cn-shanghai.aliyuncs.com/test2.jpg",
                    "Timestamp": 1704769989000
                }
            ]
        }
    }
}

取消直播审核任务

接口说明

您可以调用该接口取消直播流审核任务。

• 业务接口：VideoModerationCancel。

• 计费信息：该接口不计费。

调试

在接入前，您也可以通过阿里云OpenAPI在线调试VideoModerationCancel接口，查看调用示例代码及SDK依赖信息，方便概览接口的使用方法和参数。

请求参数

表11 ServiceParameters

返回参数

示例

请求示例

{
    "Service": "liveStreamDetection",
    "ServiceParameters": {
        "taskId": "abcd****"
    }
}

返回结果参考

{
    "Msg": "OK",
    "Code": 200,
    "RequestId": "70ED13B0-BC22-576D-9CCF-1CC12FEAC477"
}

Code说明

以下为视频直播流审核增强版接口返回Code的含义说明，系统仅对Code返回为200和280的请求计量计费，其他Code不会计费。