Mode de synchronisation

sync_mode contrôle ce qui se passe lorsque vos entrées vidéo et audio ont des durées différentes. Il s’applique aux générations vidéo + audio. Pour les entrées image, sync_mode est ignoré, car les images n’ont pas de durée intrinsèque.

Utilisez sync_mode dans l’objet options lors de la création d’une génération:

{
  "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"
  }
}

Recommandation rapide

Objectif	Mode recommandé	Pourquoi
Garder une sortie courte et éviter le remplissage	`cut_off`	Utilise la durée de l’entrée la plus courte.
Faire couvrir naturellement un audio long par une vidéo courte	`bounce`	Lit en avant, puis en arrière, et répète jusqu’à la fin de l’audio.
Répéter une vidéo courte sur un audio plus long	`loop`	Redémarre la vidéo jusqu’à la fin de l’audio.
Préserver toute la vidéo quand l’audio est plus court	`silence`	Complète le reste de la vidéo avec du silence.
Préserver tout le contenu vidéo et audio	`remap`	Étire le temps de la vidéo pour correspondre à la durée audio.

Pour un résultat plus prévisible, rapprochez les durées de la vidéo et de l’audio avant l’envoi. Les grands écarts de durée peuvent rendre bounce, loop ou remap visuellement évidents.

Matrice de comportement

Cette matrice montre le comportement effectif lorsque les durées ne correspondent pas.

Mode	Audio plus long que la vidéo	Vidéo plus longue que l’audio	Durée de sortie effective
`bounce`	La vidéo est lue en avant, puis en arrière, en répétant jusqu’à la fin de l’audio.	La vidéo est coupée à la longueur de l’audio.	Longueur de l’audio
`loop`	La vidéo redémarre et boucle jusqu’à la fin de l’audio.	La vidéo est coupée à la longueur de l’audio.	Longueur de l’audio
`cut_off`	L’audio est tronqué à la longueur de la vidéo.	La vidéo est coupée à la longueur de l’audio.	Longueur de l’entrée la plus courte
`silence`	La sortie conserve la longueur de l’audio.	L’audio est complété avec du silence sur toute la vidéo.	Longueur de l’entrée la plus longue
`remap`	La vidéo est ralentie pour correspondre à la longueur de l’audio.	La vidéo est accélérée pour correspondre à la longueur de l’audio.	Longueur de l’audio

Exemples de durées de sortie

Pour une vidéo de 4.00s avec un audio de 8.64s:

Mode	Durée de sortie	Ce qui se passe
`bounce`	8.64s	La vidéo rebondit pour couvrir tout l’audio.
`loop`	8.64s	La vidéo boucle pour couvrir tout l’audio.
`cut_off`	4.00s	L’audio est coupé à la fin de la vidéo.
`silence`	8.64s	La sortie conserve la durée audio complète.
`remap`	8.64s	La vidéo est ralentie pour correspondre à l’audio.

Pour une vidéo de 10.00s avec un audio de 1.74s:

Mode	Durée de sortie	Ce qui se passe
`bounce`	1.74s	La vidéo est coupée à la longueur de l’audio.
`loop`	1.74s	La vidéo est coupée à la longueur de l’audio.
`cut_off`	1.74s	La vidéo est coupée à la longueur de l’audio.
`silence`	10.00s	L’audio est complété avec du silence sur toute la vidéo.
`remap`	1.74s	La vidéo est accélérée pour correspondre à l’audio.

Détails des modes

cut_off

cut_off utilise la longueur d’entrée la plus courte. Si l’audio est plus long que la vidéo, l’audio excédentaire est supprimé. Si la vidéo est plus longue que l’audio, la vidéo est coupée.

Choisissez ce mode si vous voulez une sortie simple et prévisible, sans devoir préserver chaque seconde des deux entrées.

bounce

bounce est utile quand la vidéo est plus courte que l’audio. La vidéo est lue en avant, puis inverse son sens, et répète jusqu’à la fin de l’audio.

Choisissez ce mode pour des clips courts en boucle quand un mouvement avant/arrière est acceptable.

loop

loop redémarre la vidéo depuis le début jusqu’à la fin de l’audio.

Choisissez ce mode lorsque votre vidéo source est conçue pour boucler proprement.

silence

silence préserve la vidéo complète quand l’audio est plus court en complétant la durée restante avec du silence. Pendant la partie silencieuse, il n’y a pas d’audio parlé pour déclencher de nouveaux mouvements de lèvres.

Choisissez ce mode lorsque le clip visuel complet est plus important qu’une fin exactement alignée sur la parole.

remap

remap modifie la vitesse de lecture vidéo afin que la durée vidéo corresponde à la durée audio.

Choisissez ce mode lorsque vous devez préserver tout le contenu vidéo et audio, tout en évitant les écarts extrêmes. De grands changements de vitesse peuvent sembler peu naturels.

Valeurs par défaut dans Studio

Quand Studio détecte une différence de durée, il n’affiche que les modes valides pour ce sens d’écart:

Différence	Modes Studio	Par défaut
Audio plus long que la vidéo	`loop`, `bounce`, `remap`, `cut_off`	`bounce`
Vidéo plus longue que l’audio	`silence`, `remap`, `cut_off`	`cut_off`

Segments

sync_mode au niveau des segments fonctionne de la même manière, mais l’écart est évalué segment par segment. Si une fenêtre de segment et son audio ont des durées différentes, le mode détermine si ce segment est coupé, complété, bouclé, rebondi ou remappé dans le temps.

Voir le guide Segments pour des exemples de requêtes segmentées.