提交视频质量审核作业接口,作业是异步执行方式,作业添加到管道中调度排队和执行。可以调用“查询视频质量审核作业”接口查询作业执行结果,也可以使用异步的消息通知机制。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String SubmitVideoQualityJob

系统规定参数。取值:SubmitVideoQualityJob。

Input String oss://mts-sh-out.oss-cn-shanghai.aliyuncs.com/blockness.mp4

输入文件,目前只支持oss。

例如:oss://mts-sh-out.oss-cn-shanghai.aliyuncs.com/001.mp4

Output String oss://mts-sh-out.oss-cn-shanghai.aliyuncs.com/blockness.txt

输出文件路径,用户自定义,目前只支持oss。

例如:oss://mts-ai-cn-shanghai-pre.oss-cn-shanghai.aliyuncs.com/ai/vqs/002.txt

SourceType String Video

文件类型。取值:Video

UserId Long 1253406881704637

用户标识。

PipelineId String 50842ce19a684a189625e9ab777f4d7b

作业管道id,用以确认作业回调队列以及提供租户隔离能力。若不传,则使用默认管道,默认作业并发数2,不绑定消息通知。

ModelId String system-video-quality

算法模型id,如为空,则选择对应功能的默认模型。

UserData String userdata

通过MNS回调时透传回来的信息,长度不能超过1KB。

NotifyUrl String mns://1253406881704637.mns.cn-shanghai.aliyuncs.com/queues/mts-videoquality-notify-queue-pre

callback路径,目前只支持mns队列。

例如:mns://1426105496228119.mns.cn-shanghai.aliyuncs.com/queues/mts-videoquality-notify-queue-pre

返回数据

名称 类型 示例值 描述
Code String Success

错误码。请求成功返回"Success"。

JobId String 0c8f04aa60bd4377a906bd6c91ec****

作业id。

Message String The job is completed successfully

错误信息。

RequestId String 5210DBB0-E327-4D45-ADBC-0B83C879****

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=SubmitVideoQualityJob
&Input=oss://mts-sh-out.oss-cn-shanghai.aliyuncs.com/blockness.mp4
&Output=oss://mts-sh-out.oss-cn-shanghai.aliyuncs.com/blockness.txt
&SourceType=Video
&UserId=1253406881704637
&<公共请求参数>

正常返回示例

XML格式

<RequestId>5210DBB0-E327-4D45-ADBC-0B83C879****</RequestId>
<Message>The job is completed successfully</Message>
<Code>Success</Code>
<JobId>0c8f04aa60bd4377a906bd6c91ec****</JobId>

JSON格式

{
    "RequestId": "5210DBB0-E327-4D45-ADBC-0B83C879****",
    "Message": "The job is completed successfully",
    "Code": "Success",
    "JobId": "0c8f04aa60bd4377a906bd6c91ec****"
}

错误码

HttpCode 错误码 错误信息 描述
500 InternalError The operation has failed due to some unknown error, exception or failure. 内部错误,偶发请重试。

访问错误中心查看更多错误码。