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

# Wanxiang Wan 2.7 vídeo a partir de referência

Modelo Wanxiang Wan 2.7 para gerar vídeo a partir de referência, com suporte a entradas multimodais (texto/imagem/vídeo). Ele pode usar uma pessoa ou objeto como protagonista para gerar vídeos de atuação de um único personagem ou de interação entre múltiplos personagens. Oferece suporte a storyboard inteligente para gerar vídeos com múltiplas tomadas. Suporta resoluções 720P e 1080P, duração de 2 a 10 segundos e 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 solicitar 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 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="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="size" type="string" default="1920*1080">
  Resolução do vídeo de saída (largura*altura), afeta o custo. Faixa 720P: 1280*720 (16:9), 720*1280 (9:16), 960*960 (1:1), 1088*832 (4:3), 832*1088 (3:4). Faixa 1080P: 1920*1080 (16:9), 1080*1920 (9:16), 1440*1440 (1:1), 1632*1248 (4:3), 1248\*1632 (3:4).

  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}>
  Se deve gerar vídeo com som; afeta o custo. O padrão é true (vídeo com som).
</ParamField>

<ParamField body="media" type="object[]" required={true}>
  Array de mídias de referência, usado para extrair a aparência do personagem, ações e timbre de voz. Corresponde a character1, character2 etc. no prompt, de acordo com a ordem do array. Quantidade de imagens: 0 a 5; quantidade de vídeos: 0 a 3; total não deve exceder 5. Formatos de imagem: JPEG, JPG, PNG, BMP, WEBP; resolução de \[240,8000] pixels; até 10 MB. Formatos de vídeo: MP4, MOV; duração de 1 a 30 segundos; até 100 MB. Formatos de áudio: MP3, WAV, FLAC; duração de 3 a 30 segundos.

  Comprimento do array: 1 - 5

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="url" type="string" required={true}>
      URL do arquivo de mídia.
    </ParamField>

    <ParamField body="type" type="string" required={true}>
      Tipo de mídia. reference\_image: imagem de referência, usada para extrair a aparência do personagem; reference\_video: vídeo de referência, usado para extrair as ações e a aparência do personagem; first\_frame: imagem do primeiro quadro, controla a imagem inicial do vídeo.

      Valores opcionais: `reference_image`, `reference_video`, `first_frame`
    </ParamField>

    <ParamField body="reference_voice" type="string">
      URL do áudio de referência do personagem, usado para clonar o timbre de voz do personagem e gerar vídeo com som. Formatos: MP3, WAV, FLAC; duração de 3 a 30 segundos.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Prompt de texto, usado para descrever os elementos e características visuais esperados no vídeo gerado. Use identificadores como character1, character2 etc. para referenciar personagens de referência; cada referência (vídeo ou imagem) deve conter apenas um único personagem. Suporta chinês e inglês, com no máximo 1500 caracteres.

  Limite de comprimento: 0 - 1500
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  Duração do vídeo gerado, em segundos, com cobrança por segundo. Um número inteiro no intervalo \[2, 10].

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

<ParamField body="shot_type" type="string" default="single">
  Tipo de tomada. single é tomada única (padrão), multi é múltiplas tomadas. O parâmetro tem prioridade maior que o prompt.

  Valores opcionais: `single`, `multi`
</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.
</ParamField>

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

  Limite de comprimento: 0 - 500
</ParamField>

## Informações da resposta

<ResponseField name="task_id" type="string" required={false}>
  Use o 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>