本文介紹調用視頻同步檢測接口（/green/video/syncscan）審核視頻內容的方法。視頻審核幫助您檢測視頻中的風險或違規內容，具體包括以下場景：視頻智能鑒黃、視頻暴恐涉政、視頻圖文違規、視頻不良場景、視頻logo。
使用說明
業務接口：/green/video/syncscan，表示視頻同步檢測。
您可以調用該接口創建視頻同步檢測任務。關于如何構造HTTP請求，請參見請求結構；您也可以直接選用已構造好的HTTP請求，更多信息，請參見SDK概覽。
計費信息：
該接口為收費接口。關于計費方式，請參見內容安全產品定價。
同時檢測多個場景的情況下，將按照
每個場景的檢測視頻截幀數量×每個場景的單價進行累加計費。檢測對象：
視頻同步檢測接口只支持通過上傳視頻截幀圖片的方式進行檢測。如果您想通過上傳視頻URL的方式進行檢測，推薦您使用視頻異步檢測接口。
視頻截幀要求：
視頻幀鏈接支持以下協議：HTTP和HTTPS。
視頻幀支持以下格式：PNG、JPG、JPEG、BMP、GIF、WEBP。
視頻幀大小限制為10 MB以內。
視頻幀像素建議不低于256*256（px），像素過低可能會影響識別效果。
視頻檢測接口的響應時間依賴視頻幀的下載時間。請保證被檢測視頻幀所在的存儲服務穩定可靠，建議您使用阿里云OSS存儲或者CDN緩存等。
場景 | 描述 | 檢測結果分類 |
視頻智能鑒黃 | 檢測視頻中是否包含色情內容。 | 正常、色情 |
視頻暴恐涉政 | 檢測視頻中是否包含暴恐涉政內容。 | 正常、暴恐涉政 |
視頻不良場景 | 檢測視頻中是否包含不良場景。 | 正常、不良場景（例如黑屏、白屏） |
視頻logo | 檢測視頻中是否包含特定的logo。 | 正常、logo |
視頻圖文違規 | 檢測視頻中是否包含廣告或違規的文字內容。 | 正常、廣告或文字違規 |
視頻語音違規 說明 該場景僅支持通過視頻異步檢測接口調用。如需使用，請參見異步檢測。 | 檢測視頻中的語音內容是否包含違規信息。 說明 默認識別語言為中文。如果您需要識別英文內容，請聯系商務經理。 | 正常、含垃圾信息、廣告、涉政、暴恐、辱罵、色情、灌水、違禁、自定義（例如命中自定義關鍵詞） |
QPS限制
本接口的單用戶QPS限制為50次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。
請求參數
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
bizType | String | 否 | default | |
scenes | StringArray | 是 | ["porn"] | 指定視頻檢測場景。取值：
|
tasks | JSONArray | 是 | 指定檢測對象，JSON數組中的每個元素是一個檢測任務結構體。最多支持100個元素，即每次提交100條內容進行檢測，支持100個元素的前提是需要將并發任務調整到100個以上。關于每個元素的具體結構描述，請參見task。 |
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
clientInfo | JSONObject | 否 | {"userId":"12023****","userNick":"Mike","userType":"others"} | 客戶端信息，請參見公共參數中的公共查詢參數。 服務器會把全局的clientInfo和此處獨立的clientInfo合并。 說明 獨立的clientInfo優先級更高。 |
dataId | String | 否 | videoId**** | 檢測對象對應的數據ID。 由大小寫英文字母、數字、下劃線（_）、短劃線（-）、英文句號（.）組成，不超過128個字符，可以用于唯一標識您的業務數據。 |
frames | JSONArray | 是 | 待檢測視頻的截幀信息。frames中的每個元素是個結構體，關于每個元素的具體結構描述，請參見frame。 單次檢測視頻的截幀個數最多為200個。 | |
framePrefix | String | 否 | 截幀地址的前綴，與 |
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
url | String | 是 | http://www.aliyundoc.com/test0001.jpg | 檢測對象的URL。
|
offset | Integer | 否 | 10 | 截幀距離片頭的時間戳，單位為秒。 |
返回數據
名稱 | 類型 | 示例值 | 描述 |
code | Integer | 200 | 錯誤碼，和HTTP狀態碼一致。 更多信息，請參見公共錯誤碼。 |
msg | String | OK | 請求參數的響應信息。 |
dataId | String | videoId**** | 檢測對象對應的數據ID。 說明 如果在檢測請求參數中傳入了dataId，則此處返回對應的dataId。 |
taskId | String | taskId**** | 檢測任務的ID。 |
results | JSONArray | 返回結果，調用成功時（code=200），返回結果中包含一個或多個元素。每個元素是個結構體，具體結構描述，請參見result。 |
名稱 | 類型 | 示例值 | 描述 |
scene | String | porn | 視頻檢測場景，和調用請求中的場景對應。取值：
|
label | String | porn | 視頻檢測結果的分類。不同檢測場景的結果分類不同，具體如下：
|
sublabel | String | porn | 如果檢測場景包含智能鑒黃（porn）和暴恐涉政（terrorism），則該字段可以返回檢測結果的細分類標簽。 該字段默認不會返回。如果有需要，請加入釘群（釘群號：35573806），聯系產品技術專家進行咨詢。 |
suggestion | String | block | 建議您執行的后續操作。取值：
|
rate | Float | 99.2 | 置信度分數，取值范圍：0（表示置信度最低）~100（表示置信度最高）。 如果suggestion為pass，則置信度越高，表示內容正常的可能性越高；如果suggestion為review或block，則置信度越高，表示內容違規的可能性越高。 重要 建議您參考suggestion和label（或者部分接口返回的sublabel）結果用于內容違規判定。 |
frames | JSONArray | 包含違規內容的視頻截幀的信息。具體結構描述，請參見frame。 | |
extras | JSONObject | 額外附加信息。 圖文違規（ad）場景中，該參數可能返回以下內容。 hitLibInfo：如果視頻中的文字命中了自定義文本庫，則返回命中的文本庫信息。具體結構描述，請參見hitLibInfo。 | |
hintWordsInfo | JSONArray | 視頻中含有廣告或文字違規信息時，返回視頻中廣告文字命中的風險關鍵詞信息。具體結構描述，請參見hintWordsInfo。 說明 只有圖文違規（ad）場景會返回該結果。 | |
logoData | JSONArray | 視頻中含有logo時，返回識別出來的logo信息，具體結構描述，請參見logoData。 說明 只有視頻logo（logo）場景會返回該結果。 | |
sfaceData | JSONArray | 視頻中包含暴恐涉政內容時，返回識別出來的暴恐涉政信息，具體結構描述，請參見sfaceData。 說明 只有視頻暴恐涉政（terrorism）場景會返回該結果。 |
名稱 | 類型 | 示例值 | 描述 |
url | String | http://www.aliyundoc.com/test0001.jpg | 檢測對象的URL。
|
offset | Integer | 50 | 視頻截幀距離片頭的時間戳，單位為秒。 |
label | String | porn | 視頻截幀的檢測結果分類。 |
rate | Float | 99.1 | 置信度分數，取值范圍：0~100，置信度越高表示檢測結果的可信度越高。建議您不要在業務中使用該分數。 |
| 名稱 | 類型 | 示例值 | 描述 |
| type | String | TV | 識別出的logo類型，取值為TV（臺標）。 |
| name | String | xxx臺 | 識別出的logo名稱。 |
| x | Float | 140 | 以圖片左上角為坐標原點，logo區域左上角到y軸距離，單位：像素。 |
| y | Float | 68 | 以圖片左上角為坐標原點，logo區域左上角到x軸距離，單位：像素。 |
| w | Float | 106 | logo區域寬度，單位：像素。 |
| h | Float | 106 | logo區域高度，單位：像素。 |
| 名稱 | 類型 | 示例值 | 描述 |
| x | Float | 49 | 以圖片左上角為坐標原點，人臉區域左上角到y軸距離，單位：像素。 |
| y | Float | 39 | 以圖片左上角為坐標原點，人臉區域左上角到x軸距離，單位：像素。 |
| w | Float | 97 | 人臉區域寬度，單位：像素。 |
| h | Float | 131 | 人臉區域高度，單位：像素。 |
| faces | JSONArray | [{"name":"命中人名","rate":91.54,"id":"AliFace_0123****"}] | 識別出的人臉信息，具體結構如下：
|
| 名稱 | 類型 | 示例值 | 描述 |
| context | String | 好看視頻 | 文字命中的自定義文本內容。 |
| libCode | String | 123456 | 文字命中的自定義文本內容對應的庫code。 |
| libName | String | abc | 文字命中的自定義文本內容對應的庫名稱。 |
| 名稱 | 類型 | 示例值 | 描述 |
| context | String | 好看視頻 | 文字命中的風險關鍵詞內容。 |
示例
請求示例
http(s)://[Endpoint]/green/video/syncscan
&<公共請求參數>
{
"scenes": [
"porn"
],
"tasks": [
{
"dataId": "videoId****",
"frames": [
{
"offset": 10,
"url": "http://www.aliyundoc.com/0B860000586C0A0300038A0460000"
},
{
"offset": 20,
"url": "http://www.aliyundoc.com/0B860000586C0A0300038A0460001"
},
{
"offset": 30,
"url": "http://www.aliyundoc.com/0B860000586C0A0300038A0460002"
},
{
"offset": 40,
"url": "http://www.aliyundoc.com/0B860000586C0A0300038A0460003"
},
{
"offset": 50,
"url": "http://www.aliyundoc.com/0B860000586C0A0300038A0460003"
},
{
"offset": 60,
"url": "http://www.aliyundoc.com/0B860000586C0A0300038A046000x"
}
]
}
]
}正常返回示例
{
"code": 200,
"msg": "OK",
"requestId": "requestID****",
"data": [
{
"code": 200,
"msg": "OK",
"dataId": "videoId****",
"taskId": "taskId****",
"results": [
{
"label": "porn",
"rate": 99.2,
"scene": "porn",
"suggestion": "block",
"frames": [
{
"offset": 50,
"url": "http://www.aliyundoc.comm/0B860000586C0A0300038A0460003",
"label": "porn",
"rate": 99.1
}
]
}
]
}
]
}