全部產品
Search

搜尋本產品

    ApsaraVideo VOD：SubmitAIMediaAuditJob

    文件中心

    ApsaraVideo VOD：SubmitAIMediaAuditJob

    更新時間：Aug 26, 2026

    呼叫此介面提交影音智慧審核作業。作業在提交成功後會非同步執行，不保證介面返回時作業已處理完成。

    介面說明

    • 請確保在使用該介面前，已充分了解影片點播產品的收費方式和價格。智慧審核為付費功能，計費詳情，請提交工單或聯絡阿里雲商務經理了解。

    • 此介面目前僅支援上海、北京、新加坡地域。

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

    • 智慧審核提交相關開發指南，請參見智慧審核。

    • 智慧審核作業完成後，智慧審核作業過程中產生的圖片資源僅在影片點播分配的點播系統 Bucket 上免費保留 2 週，超過 2 週將自動刪除。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:SubmitAIMediaAuditJob

    create

    *全部資源。

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    MediaId

    string

    是

    音訊/影片 ID。可登入點播主控台，選擇審核管理 > 影片審核檢視音訊/影片 ID。

    fe028d09441afffb138cd7ee****
    TemplateId

    string

    否

    AI 範本 ID。可透過以下方式獲取：

    • 呼叫新增 AI 範本介面新增 AI 範本時，AI 範本 ID 為返回參數 TemplateId 的值。

    • AI 範本新增後，可呼叫查詢 AI 範本列表介面查詢 AI 範本 ID，為請求後返回參數 TemplateId 的值。

    說明

    未指定 AI 範本 ID 時，則使用智慧審核預設 AI 範本 ID。

    a07a7f7d7d10eb9fd999e56ecc****
    UserData

    string

    否

    自訂設定。為 JSON 字串，支援訊息回呼等設定。更多詳情，請參見 UserData 。

    說明

    此參數中訊息回呼的使用前提是需要先在主控台設定 HTTP 回呼地址並勾選對應的回呼事件類型才能使用，否則回呼設定不生效。主控台設定 HTTP 回呼的操作，請參考回呼設定。

    {"MessageCallback":{"CallbackURL":"http://test.test.com"},"Extend":{"localId":"xxx","test":"www"}}
    MediaType

    string

    否

    video
    MediaAuditConfiguration

    string

    否

    {"ResourceType":"****_movie"}

    否

    否

    否

    媒體類型。目前僅支援：video。

    video

    否

    審核任務設定資訊。

    • 審核任務其他設定項目，當前僅支援 ResourceType 欄位，用於控制媒體檔案類型，且可針對該類型調整審核標準和規則。

    • 需要針對 ResourceType 調整審核標準和規則，請提交工單獲取技術支援，關於如何提交工單，請參見聯絡我們。

    • ResourceType 使用說明：只允許英文、數字、底線。

    {"ResourceType":"****_movie"}

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    RequestId

    string

    請求 ID。

    F4631053-8D9F-42B2-4A67281DB88E****
    MediaId

    string

    音訊/影片 ID。

    fe028d09441afffb138cd7ee****
    JobId

    string

    作業 ID。

    bdbc266af6893943a70176d92e99****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "F4631053-8D9F-42B2-4A67281DB88E****",
  "MediaId": "fe028d09441afffb138cd7ee****",
  "JobId": "bdbc266af6893943a70176d92e99****"
}

    錯誤碼

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

    變更歷史

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