Envia um job de imagem animada e inicia o processamento assíncrono.
A captura de trechos de vídeo para gerar imagens animadas só é possível quando o vídeo está no estado UploadSucces, Transcoding, Normal, Checking ou Blocked.
O custo de geração de imagens animadas está incluído nas taxas de transcodificação de vídeo. Ambos os serviços são cobrados por resolução e duração.
Depuração
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
Action |
String |
Sim |
SubmitDynamicImageJob |
Operação a ser executada. Defina o valor como SubmitDynamicImageJob. |
|
DynamicImageTemplateId |
String |
Sim |
1a443dc52e*f10abc4794d70 |
ID do modelo de imagem animada. |
|
VideoId |
String |
Sim |
7d2fbc3e273441*bdb0e08e55f |
ID do vídeo. |
|
OverrideParams |
String |
Não |
{"Watermarks":[{"Content":"User ID: 66666","WatermarkId":"8ca03c884944bd0*5efccc312367"}]} |
Parâmetros de substituição. O valor é uma string formatada em JSON. Para mais informações, consulte a seção "OverrideParams" do tópico Parâmetros de processamento de mídia. Esses parâmetros substituem os valores definidos no modelo de imagem animada. Para mais detalhes, veja o tópico Tipos de dados básicos. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
DynamicImageJob |
Struct |
Informações sobre o job de imagem animada. |
|
|
JobId |
String |
ad90a501b1b*fb72374ad005046 |
ID do job de imagem animada. |
|
RequestId |
String |
25818875-5F78*BEF6-D7393642CA58 |
ID da solicitação. |
Exemplos
Exemplos de solicitações
https://vod.{ApiRegion}.aliyuncs.com/?Action=SubmitDynamicImageJob
&DynamicImageTemplateId=1a443dc52e*****f10abc4794d70
&VideoId=7d2fbc3e273441*****bdb0e08e55f
&<Common request parameters>
Exemplos de respostas de sucesso
Formato XML
<SubmitDynamicImageJobResponse>
<RequestId>25818875-5F78*****BEF6-D7393642CA58</RequestId>
<DynamicImageJob>
<JobId>ad90a501b1b*****fb72374ad005046</JobId>
</DynamicImageJob>
</SubmitDynamicImageJobResponse>
Formato JSON
{
"RequestId": "25818875-5F78*****BEF6-D7393642CA58",
"DynamicImageJob": {
"JobId": "ad90a501b1b*****fb72374ad005046"
}
}
Códigos de erro
Para obter uma lista de códigos de erro, visite o API Error Center.
Erros comuns
A tabela a seguir descreve os erros comuns retornados por esta operação.
|
Código de erro |
Mensagem de erro |
Código de status HTTP |
Descrição |
|
InvalidVideo.NotFound |
The video does not exist. |
404 |
Mensagem de erro retornada porque o vídeo não existe. |
|
NoSuchResource |
The specified resource %s does not exist. |
404 |
Mensagem de erro retornada porque o recurso associado ao usuário não existe. %s indica as informações específicas do recurso. |
|
Forbidden.IllegalStatus |
Status of the video is illegal. |
400 |
Mensagem de erro retornada porque o status do vídeo é inválido. A captura de trechos de vídeo para gerar imagens animadas só é possível quando o vídeo está no estado UploadSucces, Transcoding, Normal, Checking ou Blocked. |