> ## 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.

# Edição de vídeo Wan 2.7 da Wanxiang

Modelo de edição de vídeo Wan 2.7 da Wanxiang, com suporte a entradas multimodais (texto/imagem/vídeo), capaz de realizar tarefas de edição por instruções e migração de vídeo. Compatível com resoluções 720P e 1080P, duração de 2 a 10 segundos, com cobrança por segundo. A saída inclui áudio por padrão.

<Tip>
  Esta é uma API **assíncrona** e retornará 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) 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="seed" type="integer">
  Semente de número aleatório, usada para melhorar a reprodutibilidade dos resultados gerados. Intervalo de valores \[0, 2147483647].

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

<ParamField body="ratio" type="string">
  Proporção de aspecto do vídeo gerado. Se não for informado, será gerado um vídeo com proporção aproximada à do vídeo de entrada. 720P é compatível com: 16:9(1280*720), 9:16(720*1280), 1:1(960*960), 4:3(1104*832), 3:4(832*1104). 1080P é compatível com: 16:9(1920*1080), 9:16(1080*1920), 1:1(1440*1440), 4:3(1648*1248), 3:4(1248*1648).

  Valores opcionais: `16:9`, `9:16`, `1:1`, `4:3`, `3:4`
</ParamField>

<ParamField body="prompt" type="string">
  Prompt de texto usado para descrever a operação de edição no vídeo. Suporta chinês e inglês, com no máximo 5000 caracteres. Por exemplo: "converter toda a cena para um estilo de argila", "substituir a roupa da garota no vídeo pela roupa da imagem".

  Limite de tamanho: 0 - 5000
</ParamField>

<ParamField body="duration" type="integer" default={0}>
  Duração do vídeo gerado, em segundos. O valor padrão é 0, o que significa usar diretamente a duração do vídeo de entrada. Quando um número inteiro entre \[2,10] é informado, o sistema recorta o vídeo original a partir do segundo 0 até a duração especificada. Só é necessário configurar este parâmetro quando for preciso truncar o vídeo.

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

<ParamField body="video_url" type="string" required={true}>
  URL do vídeo a ser editado. Formatos compatíveis: mp4, mov. Duração de 2 a 10 segundos, largura e altura da resolução no intervalo \[240,4096] pixels, proporção de aspecto de 1:8 a 8:1, tamanho do arquivo não superior a 100 MB.
</ParamField>

<ParamField body="watermark" type="boolean" default={false}>
  Se deve adicionar uma marca d'água; a marca d'água fica no canto inferior direito do vídeo, com o texto fixo "Gerado por IA".
</ParamField>

<ParamField body="resolution" type="string" default="1080P">
  Nível de resolução do vídeo de saída, que afeta o custo (1080P > 720P). A proporção de aspecto do vídeo permanece consistente com o material de entrada (a menos que o parâmetro ratio seja especificado).

  Valores opcionais: `720P`, `1080P`
</ParamField>

<ParamField body="audio_setting" type="string" default="auto">
  Configuração de som do vídeo. auto: o modelo decide de forma inteligente com base no conteúdo do prompt; se o prompt envolver descrições de som, o áudio poderá ser gerado novamente, caso contrário, o áudio original poderá ser preservado. origin: força a preservação do áudio original do vídeo de entrada.

  Valores opcionais: `auto`, `origin`
</ParamField>

<ParamField body="prompt_extend" type="boolean" default={true}>
  Se deve ativar a reescrita inteligente do prompt. Quando ativado, um modelo grande é usado para reescrever inteligentemente o prompt de entrada, melhorando significativamente os resultados para prompts mais curtos, mas aumentando o tempo de processamento.
</ParamField>

<ParamField body="negative_prompt" type="string">
  Prompt negativo, usado para descrever conteúdos que você não deseja que apareçam nas cenas do vídeo. Suporta chinês e inglês, com no máximo 500 caracteres.

  Limite de tamanho: 0 - 500
</ParamField>

<ParamField body="reference_image_url" type="string">
  URL da imagem de referência. Pode ser usada para fornecer referências visuais necessárias para a edição (como substituição de roupas, transferência de estilo etc.). Formatos compatíveis: JPEG, JPG, PNG (sem suporte a canal transparente), BMP, WEBP. Largura e altura da resolução no intervalo \[240,8000] pixels, proporção de aspecto de 1:8 a 8:1, tamanho do arquivo não superior a 20 MB. É possível enviar no máximo 3 imagens de referência.
</ParamField>

<ParamField body="reference_image_url_2" type="string">
  URL da segunda imagem de referência, com as mesmas restrições de formato de reference\_image\_url.
</ParamField>

<ParamField body="reference_image_url_3" type="string">
  URL da terceira imagem de referência, com as mesmas restrições de formato de reference\_image\_url.
</ParamField>

## Informações da resposta

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