提交媒體審核作業介面,作業是非同步執行方式,作業添加到管道中調度排隊和執行。可以調用“查詢媒體審核作業”介面查詢作業執行結果,也可以使用非同步訊息通知機制。
請求參數
名稱 | 類型 | 必填項 | 描述 |
---|---|---|---|
Action | String | 是 | 操作介面名,系統規定參數,取值:SubmitMediaCensorJob |
Input | String | 是 | 媒體輸入檔案OSS地址。Json對象。 例如:{“Bucket”:”example-bucket”,“Location”:”oss-cn-shanghai”,“Object”:”example.flv”} |
PipelineId | String | 是 | 管道ID,用於綁定訊息通知。 |
VideoCensorConfig | String | 是 | 視頻審核配置和輸出截圖的oss地址。Json對象,VideoCensorConfig定義詳見參數詳情的’VideoCensorConfig’部分。 例如:{“CensorVideo”:”true”,“BizType”:”common”,“OutputFile”:{“Bucket”: “example-001”,“Location”: “oss-cn-hangzhou”,“Object”: “test/example-{Count}.jpg”}} |
CoverImages | String | 否 | 封面圖片的OSS檔案,最多支援5個封面圖片。 Json數組,例如:[{“Bucket”:”example-bucket”,“Location”:”oss-cn-shanghai”,“Object”:”example.jpeg”}] |
Title | String | 否 | 視頻標題,最大長度64個位元組。 |
Description | String | 否 | 視頻介紹,最大長度128個位元組。 |
Barrages | String | 否 | 視頻彈幕,最大長度8192個位元組。 |
UserData | String | 否 | 使用者自訂資料,最大長度128個位元組。 |
返回參數
名稱 | 類型 | 描述 |
---|---|---|
JobId | String | 視頻審核作業id |
非同步通知訊息參數
名稱 | 類型 | 描述 |
---|---|---|
Type | String | 訊息類型:MediaCensor |
MediaCensorJobNotify | AliyunMediaCensorJobNotify | 媒體審核作業通知 |
UserData | String | 使用者自訂資料 |
樣本
請求樣本
http://mts.cn-hangzhou.aliyuncs.com/?Signature=oXVx****&SignatureVersion=1.0&Action=SubmitMediaCensorJob&Input=%7B%22Bucket%22%3A%22example-bucket%22%2C%22Location%22%3A%22oss-cn-shanghai%22%2C%22Object%22%3A%22example.flv%22%7D&Format=XML&SignatureNonce=fbda****&Version=2014-06-18&AccessKeyId=Blct****&PipelineId=b22c****&SignatureMethod=HMAC-SHA1&VideoCensorConfig=%7B%22OutputFile%22%3A%7B%22Bucket%22%3A%20%22example-001%22%2C%22Location%22%3A%20%22oss-cn-hangzhou%22%2C%22Object%22%3A%20%22test%2Fexample-%7BCount%7D.jpg%22%7D%7D&Timestamp=2018-08-08T06%3A13%3A05Z<公用參數>
返回樣本
XML格式
<SubmitMediaCensorJobResponse>
<RequestId>
25818875-5F78-4A13-BEF6-D7393642CA58
</RequestId>
<JobId>88c6ca184c0e47098a5b665e2a126797</JobId>
</SubmitCensorJobResponse>
JSON格式
{
"RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
"JobId": "88c6ca184c0e47098a5b665e2a126797"
}