调用SubmitDynamicImageJob提交媒体动图作业,开始异步处理。
- 只有状态为上传完成、转码中、正常、审核中和屏蔽的视频才能发起动图作业。
- 动图生产计入视频转码费用,且计费标准一致,按照分辨率和时长计费。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | SubmitDynamicImageJob |
系统规定参数。取值: SubmitDynamicImageJob。 |
DynamicImageTemplateId | String | 是 | 1a443dc52e*****f10abc4794d70 |
动图模板ID。 |
VideoId | String | 是 | 7d2fbc3e273441*****bdb0e08e55f |
视频ID。 |
OverrideParams | String | 否 | {"Watermarks":[{"Content":"用户ID:66666","WatermarkId":"8ca03c884944bd0*****5efccc312367"}]} |
覆盖参数(JSON字符串)。具体详情,请参见OverrideParams。支持对动图模板配置中的参数进行覆盖。具体内容,请参见DynamicImageTemplateConfig。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
DynamicImageJob | Struct |
动图作业信息。 |
|
JobId | String | ad90a501b1b*****fb72374ad005046 |
动图作业ID。 |
RequestId | String | 25818875-5F78*****BEF6-D7393642CA58 |
请求ID。 |
示例
请求示例
https://vod.aliyuncs.com/?Action=SubmitDynamicImageJob
&DynamicImageTemplateId=1a443dc52e*****f10abc4794d70
&VideoId=7d2fbc3e273441*****bdb0e08e55f
&<公共请求参数>
正常返回示例
XML
格式
<SubmitDynamicImageJobResponse>
<RequestId>25818875-5F78*****BEF6-D7393642CA58</RequestId>
<DynamicImageJob>
<JobId>ad90a501b1b*****fb72374ad005046</JobId>
</DynamicImageJob>
</SubmitDynamicImageJobResponse>
JSON
格式
{
"RequestId": "25818875-5F78*****BEF6-D7393642CA58",
"DynamicImageJob": {
"JobId": "ad90a501b1b*****fb72374ad005046"
}
}
错误码
访问错误中心查看更多错误码。
接口错误码
下表列举了本接口特有的错误码。
错误代码 |
错误信息 |
HTTP 状态码 |
说明 |
---|---|---|---|
InvalidVideo.NotFound |
The video does not exist. |
404 |
视频不存在。 |
NoSuchResource |
The specified resource %s does not exist. |
404 |
用户相关的资源数据不存在, %s表示具体资源信息。 |
Forbidden.IllegalStatus |
Status of the video is illegal. |
400 |
视频状态无效。只有状态为上传完成、转码中、正常、审核中和屏蔽的视频才能发起动图作业。 |
在文档使用中是否遇到以下问题
更多建议
匿名提交