全部產品
Search

搜尋本產品

    Intelligent Media Services：SubmitMediaCensorJob - 提交媒體審核作業

    文件中心

    Intelligent Media Services：SubmitMediaCensorJob - 提交媒體審核作業

    更新時間：Jun 06, 2026

    允許使用者想智能媒體服務提交一個媒體檔案的審核任務，該介面支援對視頻、音頻或映像內容進行自動化的審核，以檢測其中可能包含的違規、敏感或不適宜的內容。

    介面說明

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

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    ice:SubmitMediaCensorJob

    create

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    TemplateId

    string

    否

    統一模板 ID，為空白使用預設範本進行審核。

    S00000001-100060
    CoverImages

    string

    否

    封面圖片的 OSS 檔案，最多支援 5 個封面圖片，JSON 數組。

    說明

    如果設定，會優先使用這個欄位中的封面代替 Media 中的封面。

    [{"Bucket":"example-bucket-****","Location":"oss-cn-shanghai","Object":"example-****.jpeg","RoleArn":"acs:ram::1997018457688683:role/AliyunICEDefaultRole"}]
    Title

    string

    否

    視頻標題，最大長度 64 個位元組。

    說明

    如果設定，會優先使用這個欄位中的標題代替 Media 中的標題。

    Hello World
    Description

    string

    否

    視頻介紹，最大長度 128 個位元組。

    說明

    如果設定，會優先使用這個欄位中的描述代替 Media 中的描述。

    example description
    Barrages

    string

    否

    視頻彈幕。

    說明

    如果設定，會優先使用這個欄位中的描述代替 Media 中的描述。

    hello world
    Output

    string

    否

    截圖輸出。審核任務會在檔案輸入檔案對應的 path 下面產生審核截圖和結果 JSON 檔案。

    • 輸出格式參考：oss://bucket/snapshot-{Count}.jpg，其中，bucket 為和當前專案處於同一地區的 oss bucket 名稱，{Count}為截幀圖片序號替換符。

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

    oss://sashimi-cn-shanghai/censor/snapshot-{Count}.jpg
    UserData

    string

    否

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

    UserDatatestid-001-****
    NotifyUrl

    string

    否

    Callback 路徑，支援 MNS 和 HTTP 回調。

    mns://125340688170****.oss-cn-shanghai.aliyuncs.com/queues/example-pipeline
    Input

    object

    否

    輸入待審核檔案資訊。

    Type

    string

    否

    輸入檔案類型：

    OSS：OSS 路徑

    Media：媒資 ID

    Media
    Media

    string

    否

    輸入檔案資訊，支援 OSS 地址和媒資 ID 兩種。 OSS 地址規則為

    1、oss://bucket/object

    2、http(s)://bucket.oss-[regionId].aliyuncs.com/object

    其中 bucket 為和當前專案處於同一地區的 oss bucket 名稱，object 為檔案路徑。

    1b1b9cd148034739af413150fded****
    ScheduleConfig

    object

    否

    調度配置。

    PipelineId

    string

    否

    管道 ID。

    5246b8d12a62433ab77845074039****
    Priority

    integer

    否

    任務優先順序。數值越大優先順序越高，取值範圍：1~10。

    6

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回參數。

    RequestId

    string

    請求 ID。

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

    string

    視頻審核作業 ID。建議您儲存此 ID 便於後續調用其他介面時使用。

    88c6ca184c0e47098a5b665e2****

    樣本

    正常返回樣本

    JSON格式

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

    錯誤碼

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

    變更歷史

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