> ## 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.6 Vídeo a partir de vídeo de referência

Esta é uma API assíncrona que retorna apenas o task\_id assíncrono. Você precisa usar o task\_id para chamar a API de consulta de resultado da tarefa e obter o resultado da geração do vídeo.

<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 gerado.
</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}>
  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="prompt" type="string" required={true}>
      Prompt de texto usado para descrever os elementos e as características visuais que se espera incluir no vídeo gerado. Suporta chinês e inglês; cada caractere chinês/letra conta como um caractere, e a parte excedente será truncada automaticamente.

      Limite de comprimento: 0 - 2000
    </ParamField>

    <ParamField body="audio_url" type="string">
      URL do arquivo de áudio; o modelo usará esse áudio para gerar o vídeo. Suporta os protocolos HTTP ou HTTPS. Restrições de áudio: formato wav ou mp3; duração de 3 a 30 s; tamanho do arquivo não superior a 15 MB. Tratamento de excedentes: se a duração do áudio exceder o valor de duration (5 segundos ou 10 segundos), os primeiros 5 segundos ou 10 segundos serão recortados automaticamente, e o restante será descartado. Se a duração do áudio for menor que a duração do vídeo, a parte que exceder a duração do áudio 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 finais ficarão sem som.
    </ParamField>

    <ParamField body="reference_urls" type="string[]" required={true}>
      De acordo com a ordem dos vídeos de referência, referencie os vídeos de referência como characterx. Por exemplo, quando houver dois vídeos de referência, escreva no prompt: “character1 cantando na beira da estrada, character2 dançando ao lado”. Mesmo com uma única referência, também é necessário escrever character1 incluindo o número 1.

      Comprimento do array: 1 - 3

      Formato mp4, mov; quantidade de 1 a 3 itens; duração de cada item de 2 a 30 s; cada arquivo com menos de 30 MB; não pode ser informado simultaneamente com audio
    </ParamField>

    <ParamField body="negative_prompt" type="string">
      Prompt negativo usado para descrever conteúdos que você não deseja ver nas imagens do vídeo, permitindo impor restrições à imagem do vídeo. Suporta chinês e inglês; o comprimento não deve exceder 500 caracteres, e a parte excedente será truncada automaticamente.

      Limite de comprimento: 0 - 500
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="parameters" type="object">
  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="seed" type="integer">
      Semente de número aleatório. O intervalo de valores é \[0, 2147483647]. Quando não especificada, o sistema gera automaticamente uma semente aleatória. Para aumentar a reprodutibilidade dos resultados gerados, recomenda-se fixar o valor de seed. Observe que, devido à natureza probabilística da geração do modelo, mesmo usando a mesma seed, não é possível garantir que os resultados gerados sejam completamente idênticos todas as vezes.

      Intervalo de valores: \[0, 2147483647]
    </ParamField>

    <ParamField body="size" type="string" default="1920*1080">
      Especifica a resolução do vídeo gerado, no formato largura*altura. Suporta a faixa 720P (1280*720/720*1280/960*960/1088*832/832*1088) e a faixa 1080P (1920*1080/1080*1920/1440*1440/1632*1248/1248\*1632).

      Valores opcionais: `1280*720`, `720*1280`, `960*960`, `1088*832`, `832*1088`, `1920*1080`, `1080*1920`, `1440*1440`, `1632*1248`, `1248*1632`
    </ParamField>

    <ParamField body="audio" type="boolean" default={true}>
      Define se áudio será adicionado. Prioridade dos parâmetros: audio\_url > audio; só entra em vigor quando audio\_url estiver vazio. true: valor padrão, adiciona áudio automaticamente ao vídeo; false: não adiciona áudio, gerando vídeo sem som.
    </ParamField>

    <ParamField body="duration" type="integer" default={5}>
      Duração do vídeo gerado, em segundos. Os valores opcionais são 5 e 10; o valor padrão é 5. duration afeta diretamente o custo: custo = preço unitário (com base na resolução) × duração (segundos). Confirme o preço do modelo antes da chamada.

      Valores opcionais: `5`, `10`
    </ParamField>

    <ParamField body="shot_type" type="string" default="multi">
      Modo de geração de vídeo. single: geração em tomada única; multi: geração com múltiplas tomadas.

      Valores opcionais: `single`, `multi`
    </ParamField>

    <ParamField body="watermark" type="boolean" default={false}>
      Define se uma marca d’água será adicionada. A marca d’água fica no canto inferior direito do vídeo, com o texto fixo "AI 生成". false: valor padrão, não adiciona marca d’água; true: adiciona marca d’água.
    </ParamField>

    <ParamField body="prompt_extend" type="boolean" default={true}>
      Define se a reescrita inteligente de prompt será ativada. Quando ativada, um modelo grande é usado para reescrever inteligentemente o prompt de entrada. Para prompts mais curtos, a melhoria no resultado de geração é evidente, mas o tempo de processamento aumenta. true: valor padrão, ativa a reescrita inteligente; false: não ativa a reescrita inteligente.
    </ParamField>
  </Expandable>
</ParamField>

## Informações da resposta

<ResponseField name="task_id" type="string" required={true}>
  Use o task\_id para solicitar a [API de consulta do resultado da tarefa](/pt/docs/models/reference-get-async-task-result) e recuperar a saída gerada.
</ResponseField>