Content Moderation：ApsaraVideo for Live流審核增強版2.0版API

接入指引

1. 註冊阿里雲帳號：立即註冊，按照操作提示完成帳號註冊。

2. 開通Alibaba Content Security Service隨用隨付：請確保已開通服務，具體操作，請參見開通服務。開通不收費，介面接入使用後系統會按使用量自動出賬，具體資訊，請參見計費說明。

3. 建立AccessKey：請確保您已通過RAM建立AccessKey，具體操作，請參見建立AccessKey。如果您使用的是RAM使用者（子帳號）AccessKey，您需要通過阿里雲帳號（主帳號）給RAM使用者賦予AliyunYundunGreenWebFullAccess許可權，具體操作，請參見RAM授權。

4. 開發接入：推薦使用SDK方式調用。具體資訊，請參見視頻審核增強版2.0版SDK及接入指南。

5. ApsaraVideo for Live流審核服務包含以下3個介面：

   • VideoModeration：提交直播審核任務

   • VideoModerationResult：擷取直播審核任務結果

   • VideoModerationCancel：取消直播審核任務

提交審核任務

介面說明

• 業務介面：VideoModeration，ApsaraVideo for Live流僅提供非同步檢測介面。

• 支援的地區及接入地址：

  地區	外網接入地址	內網接入地址	支援的服務
  新加坡	green-cip.ap-southeast-1.aliyuncs.com	green-cip-vpc.ap-southeast-1.aliyuncs.com	liveStreamDetection_global、liveStreamDetectionByVL_global
  美國（維吉尼亞）	https://green-cip.us-east-1.aliyuncs.com	https://green-cip-vpc.us-east-1.aliyuncs.com	liveStreamDetection_global
  美國（矽谷）	https://green-cip.us-west-1.aliyuncs.com	暫無
  德國（法蘭克福）	green-cip.eu-central-1.aliyuncs.com	暫無

• 計費資訊：

  該介面為收費介面。會根據您設定的直播畫面檢測策略和直播語音檢測策略進行計費，直播畫面可選擇多個服務（service），將按照畫面截幀數量*每個服務的單價進行累加計費。如果同時檢測直播中的語音內容違規，則還將增加視頻時間長度*語音違規功能的單價的費用。關於計費方式，請參見計費說明。

• 檢測對象：支援檢測直播流。

• 返回結果：非同步檢測任務不會即時返回檢測結果，您需要通過callback或者輪詢的方式擷取檢測結果。檢測結果最長保留24小時。

  • callback擷取檢測結果：提交非同步檢測任務時，在請求參數中傳入callback參數，用來自動接收檢測結果。

  • 輪詢擷取檢測結果：提交非同步檢測任務時，無需傳入callback參數；提交非同步檢測任務後，調用結果查詢介面擷取檢測結果。

• 直播流要求：

  • 直播流支援以下協議：RTMP、HLS、HTTP-FLV、RTSP。

  • 直播流時間長度限制：單個視頻流檢測任務最長支援24小時，超過24小時任務自動結束。

• 檢測規則配置：

  • 初次調用時請在Alibaba Content Security Service控制台進行直播審核規則設定。

  • 如果您不設定，直播審核2.0版API的預設配置如下：

    服務（Service）	預設配置
    直播流檢測（liveStreamDetection_global）	固定頻率截幀：1秒/幀 視頻畫面檢測服務：通用基準檢測（baselineCheck_global） 視頻語音檢測：開啟 視頻語音檢測服務：社交娛樂直播檢測（live_stream_detection_global） 結果返回方式：僅返回有檢出風險的結果
    ApsaraVideo for Live流檢測_大模型版（liveStreamDetectionByVL_global） 說明 當前僅北京、上海地區支援；大模型版並發路數限制為10路。	固定頻率截幀：1秒/幀 視頻畫面檢測服務：大小模型融合圖片審核服務（postImageCheckByVL） 視頻語音檢測：開啟 視頻語音檢測服務：社交娛樂直播檢測（live_stream_detection_cb） 結果返回方式：僅返回有檢出風險的結果

QPS限制

本介面的單使用者QPS限制為100次/秒，並發審核路數限制為50路（即同一時間只能處理50個任務，如需要提升並發路數請諮詢您的商務經理）。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。

調試

在接入前，您也可以通過阿里雲OpenAPI線上調試VideoModeration介面，查看調用範例程式碼及SDK依賴資訊，方便概覽介面的使用方法和參數。

請求參數

表1 ServiceParameters

返回資料

樣本

請求樣本

{
    "Service": "liveStreamDetection_global",
    "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_global",
    "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_global"
                        }
                    ],
                    "TempUrl": "http://abc.oss-ap-southeast-1.aliyuncs.com/test1.jpg",
                    "Timestamp": 1704769999000
                },
                {
                    "Offset": 2,
                    "RiskLevel": "medium",
                    "Results": [
                        {
                            "Result": [
                                {
                                    "Confidence": 78.88,
                                    "Label": "sexual_cleavage",
                                    "Description": "疑似含有包含肢體裸露或性感內容"
                                },
                              	{
                                    "Confidence": 74.18,
                                    "Label": "violent_explosion",
                                    "Description": "疑似含有煙火類內容元素"
                                }
                            ],
                            "Service": "baselineCheck_global"
                        }
                    ],
                    "TempUrl": "http://abc.oss-ap-southeast-1.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": "Alibaba Content Security Service",
                    "Url": "http://abc.oss-ap-southeast-1.aliyuncs.com/test.wav"
                },
                {
                    "EndTime": 30,
                    "EndTimestamp": 1698912813192,
                    "Extend": "{\"customizedWords\":\"服務\",\"customizedLibs\":\"test\"}",
                    "Labels": "C_customized",
                    "RiskLevel": "high",
                    "StartTime": 0,
                    "StartTimestamp": 1698912783192,
                    "Text": "歡迎使用阿里雲Alibaba Content Security Service服務",
                    "Url": "http://abc.oss-ap-southeast-1.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_global"
                        }
                    ],
                    "TempUrl": "http://abc.oss-ap-southeast-1.aliyuncs.com/test1.jpg",
                    "Timestamp": 1704769999000
                },
                {
                    "Offset": 2,
                    "RiskLevel": "medium",
                    "Results": [
                        {
                            "Result": [
                                {
                                    "Confidence": 74.18,
                                    "Label": "violent_explosion",
                                    "Description": "疑似含有煙火類內容元素"
                                },
                                {
                                    "Confidence": 78.88,
                                    "Label": "sexual_cleavage",
                                    "Description": "疑似含有包含肢體裸露或性感內容"
                                }
                            ],
                            "Service": "baselineCheck_global"
                        }
                    ],
                    "TempUrl": "http://abc.oss-ap-southeast-1.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說明

以下為ApsaraVideo for Live流審核2.0版介面返回Code的含義說明，系統僅對Code返回為200和280的請求計量計費，其他Code不會計費。