提交智能生產(chǎn)作業(yè)。
接口說明
使用本接口提交的作業(yè)是異步執(zhí)行方式。作業(yè)添加到管道中調(diào)度排隊(duì)和執(zhí)行，可以調(diào)用查詢智能生產(chǎn)作業(yè)接口查詢作業(yè)執(zhí)行結(jié)果，也可以使用異步的消息通知機(jī)制獲取結(jié)果。
QPS 限制
本接口的單用戶 QPS 限制為 100 次/秒。超過限制，API 調(diào)用會(huì)被限流，這可能會(huì)影響您的業(yè)務(wù)，請(qǐng)合理調(diào)用。更多信息，請(qǐng)參見 QPS 限制。
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息，可以在RAM權(quán)限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下：
- 操作：是指具體的權(quán)限點(diǎn)。
- 訪問級(jí)別：是指每個(gè)操作的訪問級(jí)別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權(quán)的資源類型。具體說明如下：
- 對(duì)于必選的資源類型，用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作，用
全部資源表示。
- 條件關(guān)鍵字：是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作：是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限，操作才能成功。
| 操作 | 訪問級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
|---|---|---|---|---|
| mts:SubmitIProductionJob |
|
| 無 |
請(qǐng)求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| FunctionName | string | 是 | 功能算法名稱。各功能算法支持的地域請(qǐng)參見服務(wù)地域。取值：
| ImageCartoonize |
| ModelId | string | 否 | 算法模型 ID。如果為空，則選擇對(duì)應(yīng)功能的默認(rèn)模型（此參數(shù)保持為空即可，一般無需傳入，直接使用默認(rèn)模型）。 | null |
| JobParams | string | 是 | 算法作業(yè)參數(shù)，JSON 對(duì)象，不同算法對(duì)應(yīng)參數(shù)內(nèi)容不同。更多信息請(qǐng)參見智能生產(chǎn)接口參數(shù)補(bǔ)充說明。 | {"Model":"gif"} |
| ScheduleParams | string | 否 | 作業(yè)調(diào)度參數(shù)，設(shè)置任務(wù)調(diào)度配置（非必填，保持為空即可）。 | null |
| NotifyUrl | string | 否 | Callback 路徑，目前僅支持 MNS 消息隊(duì)列。消息隊(duì)列的路徑可以通過 MNS 控制臺(tái) > 隊(duì)列列表 > 詳情查看。 | mns://125340688170****.mns.cn-beijing.aliyuncs.com/queues/example-pipeline |
| UserData | string | 否 | 用戶的業(yè)務(wù)數(shù)據(jù)，隨回調(diào)信息回傳給回調(diào)地址（非必填，保持為空即可）。 | null |
| PipelineId | string | 否 | 作業(yè)管道 ID，可以通過 MPS 控制臺(tái) > 全局設(shè)置 > 管道獲取。用于確認(rèn)作業(yè)回調(diào)隊(duì)列以及提供租戶隔離能力。若不傳，則使用默認(rèn)管道，默認(rèn)作業(yè)并發(fā)數(shù) 10，不綁定消息通知。 | 39f8e0bc005e4f309379701645f4**** |
| Input | string | 否 | 輸入文件的 OSS Bucket（目前僅支持 OSS 路徑，且 OSS 的地域需要與當(dāng)前 MPS 所在地域保持一致），可以通過 MPS 控制臺(tái) > 媒體管理 > 媒體列表獲取或 OSS 控制臺(tái)選擇對(duì)應(yīng)的 Bucke 獲取路徑。 說明
由于算法不同，Input 在某些場景下為必填項(xiàng)。請(qǐng)根據(jù)您的實(shí)際業(yè)務(wù)需要選擇是否傳入此參數(shù)。
| oss://example-****.oss-cn-shanghai.aliyuncs.com/example.mp4 |
| Output | string | 否 | 輸出文件的 OSS Bucket（目前僅支持 OSS 路徑），可以通過 MPS 控制臺(tái) > 媒體管理 > 媒體列表獲取或 OSS 控制臺(tái)選擇對(duì)應(yīng)的 Bucke 獲取路徑。OSS 的地域需要與當(dāng)前 MPS 所在地域保持一致。 說明
格式為： oss://example-****.oss-cn-shanghai.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt，其中{source}、{timestamp}和{sequenceId}為占位符，分別填充輸入文件名、Unix 時(shí)間戳和生成序號(hào)，占位符不必須，但對(duì)于多輸出算法，比如智能封面等，需要注意加入序號(hào)占位符確保輸出文件路徑不重復(fù)，文件后綴名規(guī)則由用戶自定義。
| oss://example-****.oss-cn-shanghai.aliyuncs.com/iproduction/{source}-{timestamp}-{sequenceId}.srt |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "5210DBB0-E327-4D45-ADBC-0B83C8796E26",
"JobId": "39f8e0bc005e4f309379701645f4****",
"Result": "{ \"Code\":\"Success\", \"Details\":[], \"FunctionName\":\"ImageCartoonize\", \"JobId\":\"39f8e0bc005e4f309379701645f4****\", \"Message\":\"success\", \"State\":\"Success\", \"Type\":\"IProduction\" }"
}錯(cuò)誤碼
訪問錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
| 變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
|---|