接入指引

1. 注冊阿里云賬號：立即注冊，按照操作提示完成賬號注冊。

2. 開通內容安全按量付費：請確保已開通服務，具體操作，請參見開通服務。開通不收費，接口接入使用后系統會按使用量自動出賬，具體信息，請參見計費說明。您也可以購買按量抵扣資源包，資源包相較于后付費存在一定階梯抵扣，適合使用量級可預期和較大的用戶，具體信息，請參見購買按量抵扣資源包。

3. 創建AccessKey：請確保您已通過RAM創建AccessKey，具體操作，請參見創建AccessKey。如果您使用的是RAM用戶（子賬號）AccessKey，您需要通過阿里云賬號（主賬號）給RAM用戶賦予AliyunYundunGreenWebFullAccess權限，具體操作，請參見RAM授權。

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

5. 視頻文件審核服務包含以下2個接口：

   • VideoModeration：提交視頻文件審核任務

   • VideoModerationResult：獲取視頻文件審核結果

提交審核任務

接口說明

• 業務接口：VideoModeration，視頻僅提供異步檢測接口。

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

  地域	外網接入地址	內網接入地址	支持的服務
  華東2（上海）	green-cip.cn-shanghai.aliyuncs.com	green-cip-vpc.cn-shanghai.aliyuncs.com	videoDetection
  華北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.ap-southeast-1.aliyuncs.com	green-cip-vpc.ap-southeast-1.aliyuncs.com	videoDetection_cb

• 計費信息：

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

• 檢測對象：支持檢測視頻文件。

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

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

  • 輪詢獲取檢測結果：提交異步檢測任務時，無需傳入callback參數；提交異步檢測任務后，調用結果查詢接口獲取檢測結果。

• 視頻要求：

  • 視頻文件鏈接支持以下協議：HTTP和HTTPS。

  • 視頻文件支持以下格式：AVI、FLV、MP4、MPG、ASF、WMV、MOV、WMA、RMVB、RM、FLASH、TS。

  • 視頻大小限制：默認單個視頻大小不超過500 MB。如果您的需求超過500 MB，您可以對視頻進行分片處理。或者聯系工作人員幫您調整大小限制。

  • 視頻文件檢測的時間依賴于視頻的下載時間。請保證被檢測的視頻文件所在的存儲服務穩定可靠，建議您使用阿里云OSS存儲服務存儲視頻文件。

• 檢測規則配置：

  • 初次調用時請在內容安全控制臺進行視頻審核規則設置。

  • 如果您不設置，視頻審核增強版API的默認配置如下：

    視頻文件檢測（videoDetection）	視頻文件檢測_海外版（videoDetection_cb）
    固定頻率截幀：1秒/幀 視頻畫面檢測服務：視頻/直播截圖檢測（liveStreamCheck） 視頻語音檢測：開啟 視頻語音檢測服務：音視頻媒體檢測（audio_media_detection） 結果返回方式：僅返回有檢出風險的結果	固定頻率截幀：1秒/幀 視頻畫面檢測服務：通用基線檢測_海外版（baselineCheck_cb） 視頻語音檢測：開啟 視頻語音檢測服務：音視頻媒體檢測_海外版（audio_media_detection_cb） 結果返回方式：僅返回有檢出風險的結果

QPS限制

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

調試

在接入前，您也可以通過阿里云OpenAPI在線調試VideoModeration接口，查看調用示例代碼及SDK依賴信息，方便概覽接口的使用方法和參數。

請求參數

表1 ServiceParameters

返回數據

示例

請求示例

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

正常返回示例

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

獲取視頻文件審核任務結果

接口說明

• 業務接口：VideoModerationResult，表示獲取視頻文件審核任務結果。

• 計費信息：該接口不計費。

• 查詢超時：建議您將查詢間隔設置為30秒（即在提交異步檢測任務30秒后查詢結果），最長不能超出24小時，否則結果將會自動刪除。

QPS限制

本接口的單用戶QPS限制為100次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。

調試

在接入前，您也可以通過阿里云OpenAPI在線調試VideoModerationResult接口，查看調用示例代碼及SDK依賴信息，方便概覽接口的使用方法和參數。

請求參數

表1 ServiceParameters

返回數據

表2 Data

表3 FrameResult

表4 FrameSummary

表5 Frame

表6 Results

表7 Result

表8 audioResult

表9 AudioSummarys

表10 SliceDetails

示例

請求示例

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

正常返回示例

• 僅檢測視頻圖畫

{
    "Code": 200,
    "RequestId": "25106421-XXXX-XXXX-XXXX-15DA5AAAC546",
    "Message": "success finished",
    "Data": {
        "DataId": "ABCDEF-TESTDATAID",
        "TaskId": "AAAAA-BBBBB-2024-0307-0728",
        "RiskLevel": "medium",
        "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"
                                }
                            ],
                            "Service": "baselineCheck_pro"
                        }
                    ],
                    "TempUrl": "http://abc.oss-cn-shanghai.aliyuncs.com/test1.jpg"
                },
                {
                    "Offset": 2,
                    "RiskLevel": "medium",
                    "Results": [
                        {
                            "Result": [
                                {
                                    "Confidence": 74.1,
                                    "Label": "violent_explosion",
                                    "Description": "疑似含有煙火類內容元素"
                                }
                            ],
                            "Service": "baselineCheck"
                        },
                        {
                            "Result": [
                                {
                                    "Confidence": 1,
                                    "Label": "sexual_cleavage",
                                    "Description": "疑似含有包含肢體裸露或性感內容"
                                }
                            ],
                            "Service": "baselineCheck_pro"
                        }
                    ],
                    "TempUrl": "http://abc.oss-cn-shanghai.aliyuncs.com/test2.jpg"
                }
            ]
        }
    }
}

• 同時檢測視頻圖畫和視頻語音

{
    "Code": 200,
    "RequestId": "ABCEDF-XXXX-XXXX-XXXX-202403070728520",
    "Message": "success finished",
    "Data": {
        "DataId": "ABCDEF-TESTDATAID",
        "TaskId": "AAAAA-BBBBB-2024-0307-0728",
        "RiskLevel": "medium",
        "AudioResult": {
            "AudioSummarys": [
                {
                    "Label": "sexual_sounds",
                    "LabelSum": 3
                }
            ],
            "RiskLevel": "medium",
            "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"
                        }
                    ],
                    "TempUrl": "http://abc.oss-cn-shanghai.aliyuncs.com/test1.jpg"
                },
                {
                    "Offset": 2,
                    "RiskLevel": "none",
                    "Results": [
                        {
                            "Result": [
                                {
                                    "Confidence": 1,
                                    "Label": "sexual_cleavage",
                                    "Description": "疑似含有包含肢體裸露或性感內容"
                                },
                                {
                                    "Confidence": 74.1,
                                    "Label": "violent_explosion",
                                    "Description": "疑似含有煙火類內容元素"
                                }
                            ],
                            "Service": "baselineCheck"
                        }
                    ],
                    "TempUrl": "http://abc.oss-cn-shanghai.aliyuncs.com/test2.jpg"
                }
            ]
        }
    }
}

Code說明

以下為視頻文件審核增強版接口返回Code的含義說明，系統僅對Code返回為200和280的請求計量計費，其他Code不會計費。