全部产品
云市场

提交媒体转码作业

更新时间:2019-01-25 15:59:53

描述

提交媒体转码作业,开始异步转码处理。

注意:

  • 只有状态为 上传完成正常审核中 的视频才能发起转码。
  • 如需要获取转码结果,可接收回调消息:单个清晰度转码完成全部转码完成
  • 该接口不支持HLS自适应码流打包、DASH打包。

请求参数

名称类型是否必需描述
ActionString系统规定参数。取值: SubmitTranscodeJobs
VideoIdString视频ID。
TemplateGroupIdString使用指定的模板组进行转码,可在 控制台转码设置 里查看模版组ID。
PriorityString当前发起的转码作业在所有排队作业中的优先级
  • 取值范围:[1-10]
  • 最高优先级:10
  • 默认取值:6
EncryptConfigEncryptConfig加密配置,为JSON字符串,只有使用HLS标准加密时才需要此参数。
OverrideParamsOverrideParams覆盖参数(JSON字符串),支持对转码模板关联的指定图片水印文件、文字水印内容、字幕文件地址以及字幕文件编码格式的覆盖。

参数说明:

  • Priority 参数只影响当前发起的转码作业在所有排队状态作业中的优先级,但不影响已经转码处理中的任务优先级。
  • EncryptConfig 结构体中CipherText参数必须为通过GenerateDataKey生成的AES_128密文秘钥,否则标准加密转码失败,标准加密接入流程请参阅 HLS标准加密
  • 无论标准加密、私有加密,TemplateGroupId 对应的模板数据,必须都勾选HLS加密选项,否则不加密。

返回参数

名称类型描述
RequestIdString请求ID
TranscodeJobsTranscodeJob[]媒体作业信息

API示例

请求示例

  1. https://vod.cn-shanghai.aliyuncs.com?Action=SubmitTranscodeJobs&VideoId=d3e680e618708fef7cefbf2cae7cc931&TemplateGroupId=56e680e618708fef7cefbf2cae7cc9yu&EncryptConfig=%7bDecryptKeyUri%3a%22http%3a%2f%2fdecrypt.demo.com%2fdecrypt%3fCipherText%3ddddddddddddd%22%2cCiphertext%3a%22ddddddddd%22%2cKeyServiceType%3a%22KMS%22%7d

注意:示例中的“公共参数”参见 公共参数说明文档

返回示例

JSON格式

  1. {
  2. "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  3. "TranscodeJobs": [{
  4. "JobId": "ad90a501b1b94ba6afb72374ad005046"
  5. }
  6. ...
  7. ]
  8. }

错误码

错误代码错误信息HTTP 状态码说明
InvalidVideo.NotFoundThe video does not exist.404视频不存在。
NoSuchResourceThe specified resource %s does not exist.404用户相关的资源数据不存在, %s表示具体资源信息。
Forbidden.IllegalStatusStatus of the video is illegal.400视频状态无效。只有状态为 上传完成正常审核中 的视频才能发起转码。

SDK示例

建议使用 服务端SDK 来调用API,此API各语言调用的示例代码,请参考如下: