通過SubmitIProductionJob提交智能生產作業-ApsaraVideo for Media Processing-阿里雲 - ApsaraVideo Media Processing

提交智能生產作業。

介面說明

使用本介面提交的作業是非同步執行方式。作業添加到管道中調度排隊和執行，可以調用查詢智能生產作業介面查詢作業執行結果，也可以使用非同步訊息通知機制擷取結果。

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 風格、人臉風格化（如需使用人臉風格化的功能請聯絡DingTalk號：yuanzhigao1209 對接） AudioQualityAssessment：音質檢測 FaceBeauty：視頻美顏 SpeechDenoise：智能降噪說明音質檢測輸入音頻支援 16bit 量化的 WAV 音頻檔案，支援單雙聲道，支援的採樣率範圍為 8000~48000Hz。	ImageCartoonize
ModelId	string	否	演算法模型 ID。如果為空白，則選擇對應功能的預設模型（此參數保持為空白即可，一般無需傳入，直接使用預設模型）。	null
JobParams	string	否	演算法作業參數，JSON 對象，不同演算法對應參數內容不同。更多資訊請參見智能生產介面參數補充說明。	{"Model":"gif"}
ScheduleParams	string	否	作業調度參數，設定任務調度配置（非必填，保持為空白即可）。	null
NotifyUrl	string	否	Callback 路徑，目前僅支援 MNS 訊息佇列。訊息佇列的路徑可以通過 MNS 控制台 > 隊列列表 > 詳情查看。	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 控制台選擇對應的 Bucke 擷取路徑。說明由於演算法不同，Input 在某些情境下為必填項。請根據您的實際業務需要選擇是否傳入此參數。	oss://example-****.oss-cn-shanghai.aliyuncs.com/example.mp4
Output	string	否	輸出檔案的 OSS Bucket（目前僅支援 OSS 路徑），可以通過 MPS 控制台 > 媒體管理 > 媒體列表擷取或 OSS 控制台選擇對應的 Bucke 擷取路徑。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\" }"
}

錯誤碼

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

變更歷史

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