> ## 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 Texto para vídeo

O modelo de texto para vídeo Wan 2.5 Preview suporta a geração de conteúdo de vídeo de alta qualidade a partir de descrições em texto, podendo gerar vídeos de 5 ou 10 segundos. Novo recurso de áudio: oferece suporte a narração automática e também a arquivos de áudio personalizados.

<Tip>
  Esta é uma API **assíncrona** e retornará apenas o task\_id da tarefa assíncrona. Você deve usar esse task\_id para solicitar a [API de consulta do resultado da tarefa](/pt/docs/models/reference-get-async-task-result) e 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={true}>
      Prompt positivo em texto. Suporta chinês e inglês, com no máximo 2000 caracteres; a parte excedente será truncada automaticamente.

      Valor de exemplo: um gatinho correndo sob a luz da lua.
    </ParamField>

    <ParamField body="negative_prompt" type="string" required={false}>
      Prompt negativo, usado para descrever conteúdos que devem ser evitados ao gerar o vídeo, permitindo evitar ou limitar elementos na imagem.

      Suporta chinês e inglês, com no máximo 500 caracteres; a parte excedente será truncada automaticamente.

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

    <ParamField body="audio_url" type="string" required={false}>
      URL do arquivo de áudio personalizado usado para a geração do vídeo. Consulte a descrição das configurações de áudio para ver como usar.

      Requisitos do áudio:

      * Formato: wav, mp3.
      * Duração: 3\~30 segundos.
      * Tamanho do arquivo: no máximo 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), apenas 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 primeiros 3 segundos do vídeo de saída terão som, e os 2 segundos restantes ficarão em silêncio.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="parameters" type="object" required={false}>
  Parâmetros de processamento de vídeo.

  <Expandable title="Descrição dos campos" defaultOpen={true}>
    <ParamField body="size" type="string" required={false}>
      Suporta resoluções 480P, 720P e 1080P. Valor padrão: `1920*1080` (ou seja, 1080P).
      O parâmetro `size` é usado para especificar a resolução de saída do vídeo, no formato largura\*altura. Os valores específicos compatíveis em cada faixa de resolução são:

      **Faixa 480P**: resoluções disponíveis

      * `832*480`: 16:9
      * `480*832`: 9:16
      * `624*624`: 1:1

      **Faixa 720P**: resoluções disponíveis

      * `1280*720`: 16:9
      * `720*1280`: 9:16
      * `960*960`: 1:1
      * `1088*832`: 4:3
      * `832*1088`: 3:4

      **Faixa 1080P**: resoluções disponíveis

      * `1920*1080`: 16:9
      * `1080*1920`: 9:16
      * `1440*1440`: 1:1
      * `1632*1248`: 4:3
      * `1248*1632`: 3:4

      <Warning>
        **Equívoco comum sobre o parâmetro size**: é necessário preencher uma resolução específica (como `1280*720`), não uma proporção (como `1:1`) nem o nome de uma faixa (como `480P`, `720P`).
      </Warning>
    </ParamField>

    <ParamField body="duration" type="integer" required={false}>
      Duração do vídeo de saída. Valores disponíveis: `5` segundos, `10` segundos.

      O valor padrão é `5`.
    </ParamField>

    <ParamField body="prompt_extend" type="bool" required={false}>
      Define se a reescrita inteligente de prompt deve ser ativada. Quando ativada, um modelo grande será usado para reescrever automaticamente o prompt de entrada, melhorando o efeito de geração para prompts mais curtos, mas aumentando o tempo de processamento.

      * `true`: padrão, ativa a reescrita inteligente
      * `false`: não reescreve
    </ParamField>

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

      Prioridade dos parâmetros: audio\_url > audio; este parâmetro só é válido 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 de número aleatório, usada para controlar a aleatoriedade do conteúdo gerado pelo modelo. Intervalo de valores: \[0, 2147483647].

      Se não for preenchida, o sistema gerará automaticamente uma semente aleatória. Se você quiser que o efeito gerado seja mais estável e consistente, especifique o mesmo valor de seed.
    </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 solicitar a [API de consulta do resultado da tarefa](/pt/docs/models/reference-get-async-task-result) a fim de obter o resultado gerado
</ResponseField>