> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jiekou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Wan 2.5 Preview Imagem para Vídeo

O modelo Wan 2.5 Preview de imagem para vídeo oferece suporte à geração de vídeos de 5 ou 10 segundos com base em uma imagem de primeiro quadro e texto. Novo recurso de áudio: compatível com narração automática e também permite arquivos de áudio personalizados.

<Tip>
  Esta é uma API **assíncrona**, que retorna apenas o task\_id da tarefa assíncrona. Você deve usar esse task\_id para chamar a [API de consulta de resultado da tarefa](/pt/docs/models/reference-get-async-task-result) para recuperar o resultado da geração do vídeo.
</Tip>

## Cabeçalhos da requisição

<ParamField header="Content-Type" type="string" required={true}>
  Valores enumerados: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Formato de autenticação Bearer: Bearer \{\{API Key}}.
</ParamField>

## Corpo da requisição

<ParamField body="input" type="object" required={true}>
  Informações básicas de entrada, como prompts etc.

  <Expandable title="Descrição dos campos" defaultOpen={true}>
    <ParamField body="prompt" type="string" required={false}>
      Prompt positivo em texto. Compatível com chinês e inglês, com no máximo 2000 caracteres; o excedente será truncado automaticamente.

      Valor de exemplo: Um gatinho correndo na grama.
    </ParamField>

    <ParamField body="negative_prompt" type="string" required={false}>
      Prompt negativo, usado para descrever o conteúdo que deve ser evitado ao gerar o vídeo, podendo orientar restrições ou evitar elementos na imagem.

      Compatível com chinês e inglês, com no máximo 500 caracteres; o excedente será truncado automaticamente.

      Valor de exemplo: baixa resolução, erro, pior qualidade, baixa qualidade, incompleto, dedos extras, proporção ruim etc.
    </ParamField>

    <ParamField body="img_url" type="string" required={true}>
      URL da imagem do quadro inicial usada para a geração do vídeo.

      A URL deve ser acessível publicamente e oferecer suporte aos protocolos HTTP ou HTTPS.

      Restrições da imagem:

      * Formatos de imagem: JPEG, JPG, PNG (sem suporte a transparência), BMP, WEBP;
      * Requisitos de dimensão: a largura e a altura da imagem devem estar no intervalo de \[360, 2000] pixels;
      * O tamanho do arquivo não deve exceder 10 MB.
    </ParamField>

    <ParamField body="audio_url" type="string" required={false}>
      URL do arquivo de áudio usado para a geração do vídeo. Para uso detalhado, consulte as instruções de configuração de áudio.

      Requisitos de áudio:

      * Formatos: wav, mp3;
      * Duração: 3-30 segundos;
      * Tamanho do arquivo não superior a 15 MB.

      Tratamento de áudio longo: se a duração do áudio exceder a duração do vídeo de destino (por exemplo, 5 ou 10 segundos), somente os primeiros 5 ou 10 segundos serão mantidos, e o restante será descartado automaticamente; se a duração do áudio for menor que a duração do vídeo, a parte excedente será um vídeo sem som. Por exemplo, se o áudio tiver 3 segundos e o vídeo tiver 5 segundos, os 3 primeiros segundos do vídeo de saída terão som, e os 2 segundos finais ficarão em silêncio.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="parameters" type="object" required={false}>
  Parâmetros de processamento de vídeo, por exemplo, para especificar a resolução e a duração do vídeo de saída.

  <Expandable title="Descrição dos campos" defaultOpen={true}>
    <ParamField body="resolution" type="string" required={false}>
      Nível de resolução do vídeo gerado.<br />
      Opções: `480P`, `720P`, `1080P`. Valor padrão: `1080P`.
    </ParamField>

    <ParamField body="duration" type="integer" required={false}>
      Especifica a duração do vídeo gerado, com valores aceitos: `5` ou `10` (unidade: segundos).

      Valor padrão: `5`.
    </ParamField>

    <ParamField body="prompt_extend" type="bool" required={false}>
      Define se a reescrita inteligente do prompt será ativada. Quando ativada, um modelo grande será usado para reescrever inteligentemente o prompt de entrada, o que pode melhorar significativamente o resultado gerado para prompts mais curtos, mas também aumentará o tempo de processamento.

      * `true`: padrão, ativa a reescrita inteligente;
      * `false`: não reescreve.

      Valor de exemplo: true.
    </ParamField>

    <ParamField body="audio" type="boolean" required={false}>
      Define se o áudio será adicionado.

      Prioridade dos parâmetros: audio\_url > audio; válido somente quando audio\_url estiver vazio.

      * `true`: padrão, adiciona narração automaticamente ao vídeo;
      * `false`: não adiciona áudio; a saída será um vídeo sem som.

      Valor de exemplo: true.
    </ParamField>

    <ParamField body="seed" type="integer" required={false}>
      Semente aleatória, usada para controlar a aleatoriedade do conteúdo gerado pelo modelo, com intervalo de valores: \[0, 2147483647].

      Se não for preenchida, um número aleatório será gerado automaticamente. Se desejar um resultado de geração mais estável, você pode informar o mesmo valor de seed.

      Valor de exemplo: 12345.
    </ParamField>
  </Expandable>
</ParamField>

## Informações da resposta

<ResponseField name="task_id" type="string" required={true}>
  task\_id da tarefa assíncrona. Você deve usar esse task\_id para chamar a [API de consulta de resultado da tarefa](/pt/docs/models/reference-get-async-task-result) para obter o resultado gerado
</ResponseField>