> ## 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: video a partir de imagen de referencia

La herramienta Pixverse C1 de video a partir de imagen de referencia puede generar videos de calidad cinematográfica a partir de 1-7 imágenes de referencia. Permite citar imágenes de referencia en el prompt mediante la sintaxis @ref\_name, y admite coherencia de múltiples personajes/objetos, múltiples resoluciones (360p-1080p), duración variable (1-15 segundos) y generación de audio.

<Tip>
  Esta es una API **asíncrona** y solo devolverá el task\_id de la tarea asíncrona. Debe usar ese task\_id para solicitar la [API de consulta de resultado de tarea](/es/docs/models/reference-get-async-task-result) y recuperar el resultado generado.
</Tip>

## Encabezados de solicitud

<ParamField header="Content-Type" type="string" required={true}>
  Valores enumerados: `application/json`
</ParamField>

<ParamField header="Authorization" type="string" required={true}>
  Formato de autenticación Bearer: Bearer \{\{API Key}}.
</ParamField>

## Cuerpo de la solicitud

<ParamField body="images" type="object[]" required={true}>
  Lista de imágenes de referencia (1-7)

  Longitud del array: 1 - 7

  <Expandable title="propiedades" defaultOpen={true}>
    <ParamField body="type" type="string" required={true}>
      Tipo de imagen de referencia: subject indica que la generación de video se realiza tomando como sujeto a la persona/objeto de la imagen de referencia; background indica que la generación de video se realiza tomando como fondo la escena/entorno de la imagen de referencia

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

    <ParamField body="ref_name" type="string" required={true}>
      Nombre identificador corto de la imagen de referencia, usado para citar esta imagen de referencia en el prompt mediante la sintaxis @ref\_name; @ref\_name debe ir seguido de un espacio
    </ParamField>

    <ParamField body="image_url" type="string" required={true}>
      Dirección URL de la imagen de referencia
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Texto de descripción de la escena. Use la sintaxis @ref\_name para citar las imágenes de referencia cargadas (por ejemplo, «@hero corre en @city»); @ref\_name debe ir seguido de un espacio y el nombre citado debe coincidir con el ref\_name en images
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  Duración del video generado (segundos), en el rango 1-15

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

<ParamField body="resolution" type="string" default="720p">
  Resolución del video de salida

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

<ParamField body="aspect_ratio" type="string" default="16:9">
  Relación de aspecto del video de salida

  Valores opcionales: `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}>
  Indica si se debe generar también audio nativo del video
</ParamField>

## Información de respuesta

<ResponseField name="task_id" type="string" required={true}>
  Use task\_id para solicitar la [API de consulta de resultado de tarea](/es/docs/models/reference-get-async-task-result) y recuperar la salida generada.
</ResponseField>