调用SubmitPreprocessJobs,通过导播台对视频进行转码处理。
- 视频预处理实际是转码过程,生成符合导播台播放要求的视频,所以会有计量计费信息产生,详细请工单咨询导播台服务。
- 接收转码完成的回调消息,来获取处理结果。当回调消息Preprocess=true时,表示预处理完成回调。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | SubmitPreprocessJobs |
系统规定参数。取值: SubmitPreprocessJobs。 |
PreprocessType | String | 是 | LivePreprocess |
预处理类型。取固定值:LivePreprocess(导播台视频预处理)。 |
VideoId | String | 是 | 7d2fbc3e27*****0bdb0e08e55f |
视频ID。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
PreprocessJobs | Array of PreprocessJob |
作业信息。 |
|
PreprocessJob | |||
JobId | String | bb396607fd*****11fee9effbb99c |
作业ID。 |
RequestId | String | D08EF493-1A69-42*****6D-EC66BE3339B3 |
请求ID。 |
示例
请求示例
https://vod.aliyuncs.com/?Action=SubmitPreprocessJobs
&PreprocessType=LivePreprocess
&VideoId=7d2fbc3e27*****0bdb0e08e55f
&<公共请求参数>
正常返回示例
XML
格式
<SubmitPreprocessJobsRespon>
<RequestId>D08EF493-1A69-42*****6D-EC66BE3339B3</RequestId>
<PreprocessJobs>
<PreprocessJob>
<JobId>bb396607fd*****11fee9effbb99c</JobId>
</PreprocessJob>
</PreprocessJobs>
</SubmitPreprocessJobsRespon>
JSON
格式
{
"SubmitPreprocessJobsRespon": {
"RequestId": "D08EF493-1A69-42*****6D-EC66BE3339B3",
"PreprocessJobs": {
"PreprocessJob": {
"JobId": "bb396607fd*****11fee9effbb99c"
}
}
}
}
错误码
访问错误中心查看更多错误码。
接口错误码
下表列举了本接口特有的错误码。
错误代码 |
错误信息 |
HTTP 状态码 |
说明 |
---|---|---|---|
InvalidVideo.NotFound |
The video does not exist. |
404 |
视频不存在。 |
NoSuchResource |
The specified resource %s does not exist. |
404 |
指定资源不存在。 |
Forbidden.IllegalStatus |
Status of the video is illegal. |
400 |
视频状态无效。只有状态为上传完成、正常、审核中以及转码中的视频才能发起视频预处理。 |
SDK示例
建议使用服务端SDK来调用API,此API各语言调用的示例代码,请参见:
在文档使用中是否遇到以下问题
更多建议
匿名提交