全部產品
Search

搜尋本產品

    ApsaraVideo Media Processing：SubmitIProductionJob

    文件中心

    ApsaraVideo Media Processing：SubmitIProductionJob

    更新時間：Aug 27, 2026

    提交智慧生產作業。

    介面說明

    使用本介面提交的作業是非同步執行方式。作業新增到管道中排程排隊和執行，可以呼叫查詢智慧生產作業介面查詢作業執行結果，也可以使用非同步的訊息通知機制取得結果。

    QPS 限制

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

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    mts:SubmitIProductionJob

    *全部資源。

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    FunctionName

    string

    是

    功能演算法名稱。各功能演算法支援的地域請參見服務地域。取值：

    • VideoH2V：影片橫轉豎

    • VideoDelogo：影片去浮水印

    • Cover：智慧封面

    • VideoClip：影片摘要

    • ImageH2V：橫轉豎

    • ImageDelogo：圖片去浮水印

    • CaptionExtraction：字幕擷取（演算法輸入待處理影片的 URL，輸出擷取的字幕檔案）

    • VideoDetext：影片去字幕

    • VideoGreenScreenMatting：綠幕摳圖（演算法輸入待摳圖影片的 URL 和替換的背景圖片 URL，輸出合成後的影片）

    • MusicSegmentDetect：副歌偵測（輸入待處理音訊、影片的 URL，輸出偵測出的每一段副歌的起止時間，若偵測不到副歌，則返回為空）

    • AudioMixing：混音處理

    • AudioBeatDetection：節奏偵測（輸入待處理音訊、影片的 URL，輸出偵測出的節拍時間清單 BeatList 和強拍時間清單 DownBeatList）

    • ImageCartoonize：3D 風格、人臉風格化（如需使用人臉風格化的功能請聯絡釘釘號：yuanzhigao1209 對接）

    • AudioQualityAssessment：音質偵測

    • FaceBeauty：影片美顏

    • SpeechDenoise：智慧降噪

      說明

      音質偵測輸入音訊支援 16bit 量化的 WAV 音訊檔案，支援單雙聲道，支援的取樣率範圍為 8000~48000Hz。

    ImageCartoonize
    ModelId

    string

    否

    演算法模型 ID。如果為空，則選擇對應功能的預設模型（此參數保持為空即可，一般無需傳入，直接使用預設模型）。

    null
    JobParams

    string

    否

    演算法作業參數，JSON 物件，不同演算法對應參數內容不同。更多資訊請參見智慧生產介面參數補充說明。

    {"Model":"gif"}
    ScheduleParams

    string

    否

    作業排程參數，設定任務排程組態（非必填，保持為空即可）。

    null
    NotifyUrl

    string

    否

    回呼路徑，目前僅支援 MNS 訊息佇列。訊息佇列的路徑可以透過 MPS 主控台 > 佇列清單 > 詳情檢視。

    mns://125340688170****.mns.cn-beijing.aliyuncs.com/queues/example-pipeline
    UserData

    string

    否

    使用者的業務資料，隨回呼資訊回傳給回呼地址（非必填，保持為空即可）。

    {\"key\":\"value\"}
    PipelineId

    string

    否

    作業管道 ID，可以透過 MPS 主控台 > 全域設定 > 管道取得。用於確認作業回呼佇列以及提供租戶隔離能力。若不傳，則使用預設管道，預設作業並行數 10，不綁定訊息通知。

    39f8e0bc005e4f309379701645f4****
    Input

    string

    否

    輸入檔案的 OSS Bucket（目前僅支援 OSS 路徑，且 OSS 的地域需要與當前 MPS 所在地域保持一致），可以透過 MPS 主控台 > 媒體管理 > 媒體清單取得或 OSS 主控台選擇對應的 Bucket 取得路徑。

    說明

    由於演算法不同，Input 在某些情境下為必填項。請根據您的實際業務需要選擇是否傳入此參數。

    oss://example-****.oss-cn-shanghai.aliyuncs.com/example.mp4
    Output

    string

    否

    輸出檔案的 OSS Bucket（目前僅支援 OSS 路徑），可以透過 MPS 主控台 > 媒體管理 > 媒體清單取得或 OSS 主控台選擇對應的 Bucket 取得路徑。OSS 的地域需要與當前 MPS 所在地域保持一致。

    說明

    格式為：oss://example-****.oss-cn-shanghai.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt，其中 {source}、{timestamp} 和 {sequenceId} 為預留位置，分別填入輸入檔案名稱、Unix 時間戳記和產生序號，預留位置非必須，但對於多輸出演算法，例如智慧封面等，需要注意加入序號預留位置確保輸出檔案路徑不重複，檔案副檔名規則由使用者自訂。

    oss://example-****.oss-cn-shanghai.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回參數。

    RequestId

    string

    請求 ID。

    5210DBB0-E327-4D45-ADBC-0B83C8796E26
    JobId

    string

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

    39f8e0bc005e4f309379701645f4****
    Result

    string

    返回結果。不同演算法返回結果不同，更多資訊請參見智慧生產介面參數補充說明。

    { "Code":"Success", "Details":[], "FunctionName":"ImageCartoonize", "JobId":"39f8e0bc005e4f309379701645f4****", "Message":"success", "State":"Success", "Type":"IProduction" }

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "5210DBB0-E327-4D45-ADBC-0B83C8796E26",
  "JobId": "39f8e0bc005e4f309379701645f4****",
  "Result": "{ \"Code\":\"Success\", \"Details\":[], \"FunctionName\":\"ImageCartoonize\", \"JobId\":\"39f8e0bc005e4f309379701645f4****\", \"Message\":\"success\", \"State\":\"Success\", \"Type\":\"IProduction\" }"
}

    錯誤碼

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

    變更歷史

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