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

Modelo Wanxiang Wan 2.7 para crear video a partir de referencias, compatible con entradas multimodales (texto/imagen/video). Permite usar personas u objetos como protagonistas para generar videos de actuación de un solo personaje o de interacción entre varios personajes. Admite storyboard inteligente para generar videos con múltiples planos. Compatible con resoluciones 720P y 1080P, duración de 2 a 10 segundos y facturación por segundo. La salida incluye audio de forma predeterminada.

<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 resultados 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="seed" type="integer">
  Semilla de número aleatorio, utilizada para mejorar la reproducibilidad de los resultados generados. Rango de valores \[0, 2147483647].

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

<ParamField body="size" type="string" default="1920*1080">
  Resolución del video de salida (ancho*alto), afecta el coste. Nivel 720P: 1280*720 (16:9), 720*1280 (9:16), 960*960 (1:1), 1088*832 (4:3), 832*1088 (3:4). Nivel 1080P: 1920*1080 (16:9), 1080*1920 (9:16), 1440*1440 (1:1), 1632*1248 (4:3), 1248\*1632 (3:4).

  Valores opcionales: `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}>
  Indica si se debe generar un video con sonido; afecta el coste. El valor predeterminado es true (video con sonido).
</ParamField>

<ParamField body="media" type="object[]" required={true}>
  Array de medios de referencia, utilizado para extraer la apariencia del personaje, los movimientos y el timbre de voz. Según el orden del array, corresponde a character1, character2, etc. en el prompt. Número de imágenes: 0~~5; número de videos: 0~~3; el total no debe superar 5. Formatos de imagen: JPEG, JPG, PNG, BMP, WEBP; resolución \[240,8000] píxeles; no más de 10 MB. Formatos de video: MP4, MOV; duración de 1~~30 segundos; no más de 100 MB. Formatos de audio: MP3, WAV, FLAC; duración de 3~~30 segundos.

  Longitud del array: 1 - 5

  <Expandable title="propiedades" defaultOpen={true}>
    <ParamField body="url" type="string" required={true}>
      URL del archivo multimedia.
    </ParamField>

    <ParamField body="type" type="string" required={true}>
      Tipo de medio. reference\_image: imagen de referencia, utilizada para extraer la apariencia del personaje; reference\_video: video de referencia, utilizado para extraer los movimientos y la apariencia del personaje; first\_frame: imagen del primer fotograma, controla la imagen inicial del video.

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

    <ParamField body="reference_voice" type="string">
      URL del audio de referencia del personaje, utilizada para clonar el timbre de voz del personaje y generar un video con sonido. Formatos: MP3, WAV, FLAC; duración de 3\~30 segundos.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="prompt" type="string" required={true}>
  Prompt de texto, utilizado para describir los elementos y características visuales que se espera incluir en el video generado. Use identificadores como character1, character2, etc. para hacer referencia a los personajes de referencia; cada referencia (video o imagen) contiene un único personaje. Admite chino e inglés, hasta 1500 caracteres.

  Límite de longitud: 0 - 1500
</ParamField>

<ParamField body="duration" type="integer" default={5}>
  Duración del video generado, en segundos; se factura por segundo. Entero en el rango \[2, 10].

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

<ParamField body="shot_type" type="string" default="single">
  Tipo de plano. single es un solo plano (predeterminado), multi es múltiples planos. Este parámetro tiene mayor prioridad que el prompt.

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

<ParamField body="watermark" type="boolean" default={false}>
  Indica si se debe añadir una marca de agua; la marca de agua se ubica en la esquina inferior derecha del video.
</ParamField>

<ParamField body="negative_prompt" type="string">
  Prompt negativo, utilizado para describir el contenido que no se desea que aparezca en las imágenes del video. Admite chino e inglés, hasta 500 caracteres.

  Límite de longitud: 0 - 500
</ParamField>

## Información de respuesta

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