Todos os produtos
Search
Central de documentação

:SubmitDynamicImageJob

Última atualização: Jun 27, 2026

Envia um job de imagem animada e inicia o processamento assíncrono.

Nota
  • 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

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

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.