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

# Pixverse C1 vídeo a partir de imagem de referência

A ferramenta Pixverse C1 vídeo a partir de imagem de referência pode gerar vídeos cinematográficos com base em 1 a 7 imagens de referência, referenciando imagens de referência no prompt por meio da sintaxe @ref\_name. Ela oferece suporte à consistência de múltiplos personagens/objetos, múltiplas resoluções (360p-1080p), duração variável (1-15 segundos) e geração de áudio.

<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 solicitação

<ParamField header="Content-Type" type="string" required={true}>
  Valor enumerado: `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="images" type="object[]" required={true}>
  Lista de imagens de referência (1 a 7)

  Comprimento do array: 1 - 7

  <Expandable title="properties" defaultOpen={true}>
    <ParamField body="type" type="string" required={true}>
      Tipo de imagem de referência: subject indica que a geração de vídeo será feita tendo a pessoa/objeto da imagem de referência como sujeito; background indica que a geração de vídeo será feita tendo a cena/ambiente da imagem de referência como plano de fundo

      Valores opcionais: `subject`, `background`
    </ParamField>

    <ParamField body="ref_name" type="string" required={true}>
      Nome identificador curto da imagem de referência, usado para referenciar essa imagem no prompt por meio da sintaxe @ref\_name; @ref\_name deve ser seguido por um espaço
    </ParamField>

    <ParamField body="image_url" type="string" required={true}>
      Endereço URL da imagem de referência
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Texto de descrição da cena, usando a sintaxe @ref\_name para referenciar as imagens de referência enviadas (por exemplo, “@hero correndo em @city”); @ref\_name deve ser seguido por um espaço, e o nome referenciado deve corresponder ao ref\_name em images
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  Duração do vídeo gerado (em segundos), intervalo de 1 a 15

  Faixa de valores: \[1, 15]
</ParamField>

<ParamField body="resolution" type="string" default="720p">
  Resolução do vídeo de saída

  Valores opcionais: `360p`, `540p`, `720p`, `1080p`
</ParamField>

<ParamField body="aspect_ratio" type="string" default="16:9">
  Proporção do vídeo de saída

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

<ParamField body="generate_audio_switch" type="boolean" default={false}>
  Se deve gerar simultaneamente o áudio nativo do vídeo
</ParamField>

## Informações de 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>