> ## 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 Imagem para Vídeo

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** que retorna apenas o task\_id da tarefa assíncrona. Você deve usar esse task\_id para solicitar a [API de consulta de resultado da tarefa](/pt/docs/models/reference-get-async-task-result) para recuperar o resultado gerado.
</Tip>

## Cabeçalhos da solicitaçã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 solicitação

<ParamField body="input" type="object" required={true}>
  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="prompt" type="string">
      Prompt de texto usado para descrever os elementos e características visuais esperados 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="img_url" type="string" required={true}>
      URL da imagem de entrada ou dados codificados em Base64. Suporta os protocolos HTTP ou HTTPS; arquivos locais podem obter uma URL temporária por meio do upload de arquivo. Restrições da imagem: formatos de imagem: JPEG, JPG, PNG (canal transparente não suportado), BMP, WEBP; resolução da imagem: a largura e a altura da imagem devem estar no intervalo \[360, 2000], em pixels; tamanho do arquivo: não deve exceder 10MB. Instruções para a imagem de entrada: 1. Usar uma URL acessível publicamente - suporta os protocolos HTTP ou HTTPS; arquivos locais podem obter uma URL temporária por meio do upload de arquivo; exemplo: [https://cdn.translate.alibaba.com/r/wanx-demo-1.png](https://cdn.translate.alibaba.com/r/wanx-demo-1.png). 2. Enviar a string após a codificação Base64 da imagem - formato dos dados: data:{MIME_type};base64,{base64_data}; exemplo: data:image/png;base64,GDU7MtCZEbTbmRZ...... (a string codificada é muito longa; apenas um trecho é exibido). Para mais informações, consulte a imagem de entrada.
    </ParamField>

    <ParamField body="template" type="string">
      Nome do modelo de efeitos especiais de vídeo. Se não for preenchido, nenhum efeito especial de vídeo será usado. Diferentes modelos oferecem suporte a diferentes modelos de efeitos especiais; consulte a lista de efeitos especiais de vídeo antes de chamar para evitar falhas na chamada.
    </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 30s; tamanho do arquivo não deve exceder 15MB. Tratamento de excesso de limite: se o comprimento do áudio exceder o valor de duration (5 segundos ou 10 segundos), os primeiros 5 segundos ou 10 segundos serão extraídos automaticamente, e o restante será descartado. Se o comprimento do áudio for menor que a duração do vídeo, a parte que exceder o comprimento do áudio será um vídeo sem som. Por exemplo, se o áudio tiver 3 segundos e a duração do vídeo for 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="negative_prompt" type="string">
      Prompt negativo usado para descrever o conteúdo que você não deseja ver nas imagens do vídeo, permitindo impor restrições às imagens 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 especificado, o sistema gera automaticamente uma semente aleatória. Para aumentar a reprodutibilidade dos resultados gerados, recomenda-se fixar o valor de seed. Observe que, como a geração do modelo é probabilística, mesmo usando a mesma seed, não é possível garantir que o resultado gerado seja exatamente o mesmo em todas as vezes.

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

    <ParamField body="audio" type="boolean" default={true}>
      Usado para controlar se o áudio será adicionado. Prioridade dos parâmetros: audio\_url > audio; só entra em vigor quando audio\_url estiver vazio. Consulte as configurações de áudio para saber como usar. true: valor padrão, adiciona áudio automaticamente ao vídeo; false: não adiciona áudio, gerando um vídeo sem som.
    </ParamField>

    <ParamField body="duration" type="integer" default={5}>
      Duração do vídeo gerado, em segundos. duration afeta diretamente o custo; confirme o preço do modelo antes de chamar. Duração do vídeo gerado, em segundos.

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

    <ParamField body="shot_type" type="string" default="multi">
      Modo de geração de vídeo. single: geração em plano único; multi: geração em múltiplos planos.

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

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

    <ParamField body="resolution" type="string" default="1080P">
      Especifica o nível de resolução do vídeo gerado. Suporta os níveis 720P e 1080P.

      Valores opcionais: `720P`, `1080P`
    </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 da geração é significativa, mas aumenta o tempo de processamento. 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 task\_id para solicitar a [API de consulta de resultado da tarefa](/pt/docs/models/reference-get-async-task-result) e recuperar a saída gerada.
</ResponseField>
