全部產品
Search

搜尋本產品

    ApsaraVideo Media Processing：SubmitMediaCensorJob

    文件中心

    ApsaraVideo Media Processing：SubmitMediaCensorJob

    更新時間：Sep 17, 2026

    提交媒體審核作業。

    介面說明

    • 該介面為非同步介面，提交任務後返回任務 ID（此時任務尚未完成，任務將進入後台排隊非同步執行），最終結果將透過回呼通知，也可透過查詢媒體審核作業主動查詢任務狀態。

    • 媒體審核功能，目前開通的地域為華北 2（北京）、華東 2（上海）、亞太東南 1（新加坡），其他地域暫不支援。

    QPS 限制

    本介面的單使用者 QPS 限制為 100 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理呼叫。更多資訊，請參見 QPS 限制。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    mts:SubmitMediaCensorJob

    none

    *全部資源。

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Input

    string

    否

    待審核的媒體檔案 OSS 位址，支援影片檔案、音訊檔案。可以透過 MPS 主控台 > 媒體管理 > 媒體清單取得。如需要審核圖片檔案請使用CoverImage參數傳入。JSON 物件，更多資訊請參考參數詳情中 Input 詳情參數。

    • Bucket：輸入檔案 OSS Bucket 名稱。

    • Location：OSS 區域，必須和 MPS 服務所在區域一致。

    • Object：待檢測 OSS Object。

      說明

      Object 不能以斜線（/）開頭，否則會導致介面呼叫失敗。

    {"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.flv"}
    CoverImages

    string

    否

    封面圖片的 OSS 檔案，可以透過 MPS 主控台 > 媒體管理 > 媒體清單取得。最多支援 5 個封面圖片，JSON 陣列。

    • Bucket：輸入檔案 OSS Bucket 名稱。

    • Location：OSS 區域，必須和 MPS 服務所在區域一致。

    • Object：待檢測 OSS Object。

      說明

      Object 不能以斜線（/）開頭，否則會導致介面呼叫失敗。

    [{"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.jpeg"}]
    Title

    string

    否

    影片標題，最大長度 64 個位元組。

    Hello World
    Description

    string

    否

    影片介紹，最大長度 128 個位元組。

    example description
    Barrages

    string

    否

    字串。

    hello world
    PipelineId

    string

    否

    管線 ID，用於綁定訊息通知。可以透過 MPS 主控台 > 全域設定 > 管線取得。不填表示使用預設的管線執行任務。預設管線並行數為 10，需要提升並行數請提交工單。

    說明

    管線目前僅支援後台建立，相關查詢、更新介面請參見更新管線。

    b22c173cced04565b1f38f1ecc39****
    VideoCensorConfig

    string

    是

    影片審核設定和輸出截圖的 OSS 位址。可以透過 MPS 主控台 > 媒體管理 > 媒體清單取得。

    JSON 物件。

    • OutputFile：

      • Bucket：輸出檔案 OSS Bucket 名稱。

      • Location：OSS 區域，必須和 MPS 服務所在區域一致。

      • Object: 待檢測 OSS Object，其中{Count}為截幀圖片序號替換符。

      其中，審核結果詳細資訊儲存在 OutputFile 相同的資料夾下，命名為{jobId}.output，output 檔案具體欄位格式，請參見媒體審核結果檔案欄位。

    • StoreVideoTimeline: 審核是否要輸出{jobId}.video_timeline檔案，儲存在 OSS 中。true：表示要輸出，false 表示不輸出，不填預設不輸出。檔案格式，請參見，查詢媒體作業（videoTimeline 範例）。

    • SaveType：輸出模式。abnormal 表示只輸出有問題的截幀，all 表示輸出所有截幀。

    • Biztype：表示審核範本。common 為預設範本，不填預設為 common，如果需要自訂審核範本需要提工單，然後將使用者的 uid 填入此項。

    • Scene：檢測場景。Scenes 可以選擇檢測場景，不填預設檢測暴恐和涉黃。可選場景：

      • porn：涉黃

      • terrorism：暴恐

      • ad：圖文違規

      • live：不良場景

      • logo：圖示

      • audio：語音反垃圾

    說明

    對於有音訊軌道的輸入檔案，audio 場景會進行音訊審核，沒有音軌的輸入檔案不要填寫 audio。

    {"Scenes" : ["porn"], "OutputFile":{"Bucket": "example-001","Location": "oss-cn-hangzhou","Object": "test/example-{Count}.jpg"},"SaveType" : "abnormal","BizType":"common"}
    UserData

    string

    否

    使用者自訂資料，最大長度 128 個位元組。

    UserDatatestid-001-****
    ExternalUrl

    string

    否

    影片的 URL 連結。

    http://www.example.com/video-****/test-****.mp4

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回參數。

    RequestId

    string

    請求 ID。

    25818875-5F78-4A13-BEF6-D7393642CA58
    JobId

    string

    影片審核作業 ID。建議您儲存此 ID 便於後續呼叫其他介面時使用。

    88c6ca184c0e47098a5b665e2****

    非同步通知訊息參數

    參數類型描述
    TypeString訊息類型：MediaCensor
    MediaCensorJobNotifyAliyunMediaCensorJobNotify媒體審核作業通知
    UserDataString使用者自訂資料

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  "JobId": "88c6ca184c0e47098a5b665e2****"
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。