調用SubmitVideoQualityJob提交視頻質量審核作業。
使用說明
- 本接口目前支持的地域為華東2（上海）。
- 本接口提交的作業是異步執行方式，作業添加到管道中調度排隊和執行。可以通過查詢視頻質量審核作業查詢作業執行情況，也可以使用異步的消息通知機制。
QPS限制
本接口的單用戶QPS限制為50次/秒。超過限制，API調用會被限流，這可能會影響您的業務，請合理調用。更多信息，請參見QPS限制。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
| 名稱 | 類型 | 是否必選 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | SubmitVideoQualityJob | 系統規定參數，取值：SubmitVideoQualityJob。 |
| UserId | Long | 是 | 174809843091**** | 用戶ID。可以通過MPS控制臺頂部導航欄左側單擊頭像查看。 |
| PipelineId | String | 否 | 50842ce19a684a189625e9ab777f**** | 管道ID，可以通過MPS控制臺 > 全局設置 > 管道獲取。用于確認作業回調隊列以及提供租戶隔離能力。如果不傳，則使用默認管道，默認作業并發數2，不綁定消息通知。 |
| SourceType | String | 是 | Video | 文件類型。取值：Video。 |
| ModelId | String | 否 | null | 算法模型ID。如果為空，則選擇對應功能的默認模型（此參數保持為空即可，一般無需傳入，直接使用默認模型）。 |
| Input | String | 是 | oss://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example.mp4 | 輸入文件的OSS Bucket，目前只支持OSS路徑傳入。可以通過OSS控制臺 > 我的訪問路徑獲取。 |
| Output | String | 是 | oss://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example1.txt | 輸出文件的OSS Bucket，用戶自定義，目前只支持OSS路徑。可以通過OSS控制臺 > 我的訪問路徑獲取。 |
| JobParams | String | 否 | 0 | 算法作業參數。 |
| ScheduleParams | String | 否 | 0 | 作業調度參數，設置任務調度配置（非必填，保持為空即可）。 |
| UserData | String | 否 | example data | 通過MNS回調時傳回來的信息，支持中英文、數字等，大小不能超過1KB。 |
| NotifyUrl | String | 否 | mns://142610549622****.mns.cn-shanghai.aliyuncs.com/queues/quequ-**** | Callback路徑，目前只支持MNS隊列。可以通過MNS控制臺 > 隊列列表 > 詳情獲取。 |
返回數據
| 名稱 | 類型 | 示例值 | 描述 |
|---|---|---|---|
| Message | String | The job is completed successfully | 作業信息。 |
| RequestId | String | 5210DBB0-E327-4D45-ADBC-0B83C8796E26 | 請求ID。 |
| Code | String | Success | 錯誤碼。請求成功時返回"Success"。 |
| JobId | String | 0c8f04aa60bd4377a906bd6c91ec**** | 作業ID。建議您保存此ID便于后續調用其他接口時使用。 |
示例
請求示例
http(s)://mts.cn-shanghai.aliyuncs.com/?Action=SubmitVideoQualityJob
&PipelineId=50842ce19a684a189625e9ab777f****
&SourceType=Video
&ModelId=null
&Input=oss://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example.mp4
&Output=oss://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example1.txt
&JobParams=0
&ScheduleParams=0
&UserData=example data
&NotifyUrl=mns://142610549622****.mns.cn-shanghai.aliyuncs.com/queues/quequ-****
&<公共請求參數>正常返回示例
XML格式
HTTP/1.1 200 OK
Content-Type:application/xml
<SubmitVideoQualityJobResponse>
<Message>The job is completed successfully</Message>
<RequestId>5210DBB0-E327-4D45-ADBC-0B83C8796E26</RequestId>
<Code>Success</Code>
<JobId>0c8f04aa60bd4377a906bd6c91ec****</JobId>
</SubmitVideoQualityJobResponse>JSON格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Message" : "The job is completed successfully",
"RequestId" : "5210DBB0-E327-4D45-ADBC-0B83C8796E26",
"Code" : "Success",
"JobId" : "0c8f04aa60bd4377a906bd6c91ec****"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。