Modo de sincronización

sync_mode controla qué ocurre cuando tus entradas de video y audio tienen duraciones distintas. Se aplica a generaciones de video + audio. Para entradas de imagen, sync_mode se ignora porque las imágenes no tienen duración intrínseca.

Usa sync_mode en el objeto options al crear una generación:

{
  "input": [
    { "type": "video", "url": "https://example.com/video.mp4" },
    { "type": "audio", "url": "https://example.com/audio.wav" }
  ],
  "model": "lipsync-2",
  "options": {
    "sync_mode": "cut_off"
  }
}

Recomendación rápida

Objetivo	Modo recomendado	Por qué
Mantener la salida corta y evitar relleno	`cut_off`	Usa la duración de la entrada más corta.
Hacer que un video corto cubra audio más largo de forma natural	`bounce`	Reproduce hacia adelante y luego en reversa, repitiendo hasta que termine el audio.
Repetir un video corto sobre audio más largo	`loop`	Reinicia el video hasta que termine el audio.
Preservar el video completo cuando el audio es más corto	`silence`	Rellena con silencio lo que resta del video.
Preservar todo el contenido de video y audio	`remap`	Ajusta el tiempo del video para igualar la duración del audio.

Para obtener el resultado más predecible, procura que las duraciones de video y audio sean cercanas antes de enviar. Los desajustes grandes de duración pueden hacer que bounce, loop o remap se noten visualmente.

Matriz de comportamiento

Esta matriz muestra el comportamiento efectivo cuando las duraciones no coinciden.

Modo	Audio más largo que video	Video más largo que audio	Duración efectiva de salida
`bounce`	El video se reproduce hacia adelante y luego hacia atrás, repitiendo hasta que termine el audio.	El video se recorta a la duración del audio.	Duración del audio
`loop`	El video se reinicia y repite hasta que termine el audio.	El video se recorta a la duración del audio.	Duración del audio
`cut_off`	El audio se recorta a la duración del video.	El video se recorta a la duración del audio.	Duración de la entrada más corta
`silence`	La salida conserva la duración del audio.	El audio se rellena con silencio durante todo el video.	Duración de la entrada más larga
`remap`	El video se ralentiza para igualar la duración del audio.	El video se acelera para igualar la duración del audio.	Duración del audio

Ejemplos de duración de salida

Para un video de 4.00s con audio de 8.64s:

Modo	Duración de salida	Qué ocurre
`bounce`	8.64s	El video rebota para cubrir el audio completo.
`loop`	8.64s	El video se repite para cubrir el audio completo.
`cut_off`	4.00s	El audio se recorta al final del video.
`silence`	8.64s	La salida conserva la duración completa del audio.
`remap`	8.64s	El video se ralentiza para igualar el audio.

Para un video de 10.00s con audio de 1.74s:

Modo	Duración de salida	Qué ocurre
`bounce`	1.74s	El video se recorta a la duración del audio.
`loop`	1.74s	El video se recorta a la duración del audio.
`cut_off`	1.74s	El video se recorta a la duración del audio.
`silence`	10.00s	El audio se rellena con silencio durante todo el video.
`remap`	1.74s	El video se acelera para igualar el audio.

Detalles por modo

cut_off

cut_off usa la longitud de entrada más corta. Si el audio es más largo que el video, el audio extra se elimina. Si el video es más largo que el audio, el video se recorta.

Elige este modo cuando quieras una salida simple y predecible y no necesites conservar cada segundo de ambas entradas.

bounce

bounce es útil cuando el video es más corto que el audio. El video se reproduce hacia adelante, luego invierte dirección y repite hasta que el audio termina.

Elige este modo para clips cortos en bucle donde un movimiento hacia adelante y atrás se vea aceptable.

loop

loop reinicia el video desde el inicio hasta que el audio termina.

Elige este modo cuando tu video fuente esté diseñado para repetirse limpiamente.

silence

silence preserva el video completo cuando el audio es más corto, rellenando con silencio el tiempo restante. Durante la parte silenciosa, no hay audio hablado que impulse nuevos movimientos de labios.

Elige este modo cuando mantener el clip visual completo sea más importante que terminar exactamente cuando termina la voz.

remap

remap cambia la velocidad de reproducción del video para que su duración coincida con la del audio.

Elige este modo cuando necesites preservar todo el contenido de video y audio, pero evita desajustes extremos. Los cambios grandes de velocidad pueden verse poco naturales.

Valores por defecto en Studio

Cuando Studio detecta un desajuste de duración, solo muestra modos válidos para esa dirección:

Desajuste	Modos en Studio	Predeterminado
Audio más largo que video	`loop`, `bounce`, `remap`, `cut_off`	`bounce`
Video más largo que audio	`silence`, `remap`, `cut_off`	`cut_off`

Segments

El sync_mode a nivel de segmento funciona igual, pero el desajuste se evalúa por segmento. Si la ventana de un segmento y su audio tienen duraciones diferentes, el modo determina si ese segmento se recorta, se rellena, se repite, rebota o se remapea en el tiempo.

Consulta la guía de Segments para ejemplos de solicitudes por segmento.