Ir para a navegação
Guias para desenvolvedores

Modo de sincronização

sync_mode controla o que acontece quando as entradas de video e áudio têm comprimentos diferentes. Aplica-se às gerações de video + áudio. Para entradas de imagem, sync_mode é ignorado porque as imagens não têm duração intrínseca. Use sync_mode no objeto options ao criar uma geração:

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

Recomendação rápida

| Meta | Modo recomendado | Por que || :--- | :--- | :--- | | Mantenha a saída curta e evite preenchimento | cut_off | Usa a duração de entrada mais curta. | | Faça um video curto com áudio mais longo naturalmente | bounce | Reproduz para frente e depois para trás, repetindo até o áudio terminar. | | Repita um video curto em um áudio mais longo | loop | Reinicia o video até o áudio terminar. | | Preservar o video completo quando o áudio for mais curto | silence | Preenche o video restante com silêncio. | | Preservar todo o conteúdo de video e áudio | remap | Amplia o tempo do video para corresponder à duração do áudio. |

Para obter o resultado mais previsível, feche a duração do video e do áudio antes de enviar. Incompatibilidades de grande duração podem tornar bounce, loop ou remap visualmente óbvios.

Matriz de comportamento

Esta matriz mostra o comportamento efetivo quando as durações não coincidem. | Modo | Áudio mais longo que video | Video mais longo que áudio | Duração efectiva da produção || :--- | :--- | :--- | :--- | | bounce | O video é reproduzido para frente e para trás, repetindo até o áudio terminar. | O video é cortado de acordo com a duração do áudio. | Duração do áudio | | loop | O video é reiniciado e repetido até o áudio terminar. | O video é cortado de acordo com a duração do áudio. | Duração do áudio | | cut_off | O áudio é cortado de acordo com a duração do video. | O video é cortado de acordo com a duração do áudio. | Comprimento de entrada mais curto | | silence | A saída mantém a duração do áudio. | O áudio é preenchido com silêncio durante todo o video. | Maior comprimento de entrada | | remap | O video é desacelerado para corresponder à duração do áudio. | O video é acelerado para corresponder à duração do áudio. | Duração do áudio |

Exemplo de durações de saída

Para um video de 4,00s com áudio de 8,64s: | Modo | Duração da saída | O que acontece || :--- | :--- | :--- | | bounce | 8,64s | O video salta para cobrir todo o áudio. | | loop | 8,64s | Loops de video para cobrir todo o áudio. | | cut_off | 4h00 | O áudio é cortado no final do video. | | silence | 8,64s | A saída mantém a duração total do áudio. | | remap | 8,64s | O video é desacelerado para corresponder ao áudio. | Para um video de 10,00s com áudio de 1,74s: | Modo | Duração da saída | O que acontece || :--- | :--- | :--- | | bounce | 1,74s | O video é cortado de acordo com a duração do áudio. | | loop | 1,74s | O video é cortado de acordo com a duração do áudio. | | cut_off | 1,74s | O video é cortado de acordo com a duração do áudio. | | silence | 10h00 | O áudio é preenchido com silêncio durante todo o video. | | remap | 1,74s | O video é acelerado para corresponder ao áudio. |

Detalhes do modo

cut_off usa o comprimento de entrada mais curto. Se o áudio for maior que o video, o áudio extra será removido. Se o video for maior que o áudio, o video será cortado. Escolha esta opção quando desejar uma saída simples e previsível e não precisar preservar cada segundo de ambas as entradas.

bounce é útil quando o video é mais curto que o áudio. O video avança, inverte a direção e repete até o áudio terminar. Escolha esta opção para clipes curtos em loop onde um movimento para frente/trás parece aceitável.

loop reinicia o video desde o início até o áudio terminar. Escolha esta opção quando o video de origem for projetado para fazer um loop limpo.

silence preserva o video completo quando o áudio é mais curto, preenchendo a duração restante com silêncio. Durante a parte silenciosa, não há áudio falado para gerar novos movimentos labiais. Escolha esta opção quando o clipe visual completo for mais importante do que terminar exatamente quando a fala termina.

remap altera a velocidade de reprodução do video para que a duração do video corresponda à duração do áudio. Escolha esta opção quando precisar preservar todo o conteúdo de video e áudio, mas evite incompatibilidades extremas. Grandes mudanças de velocidade podem parecer pouco naturais.

Padrões Studio

Quando Studio detecta uma incompatibilidade de duração, ele mostra apenas os modos válidos para aquela direção: | Incompatibilidade | Modos Studio | Padrão || :--- | :--- | :--- | | Áudio mais longo que video | loop, bounce, remap, cut_off | bounce | | Video mais longo que áudio | silence, remap, cut_off | cut_off |

Segmentos

sync_mode em nível de segmento funciona da mesma maneira, mas a incompatibilidade é avaliada por segmento. Se uma janela de segmento e seu áudio tiverem durações diferentes, o modo determinará se esse segmento será cortado, preenchido, em loop, devolvido ou remapeado no tempo. Consulte o Guia de segmentos para obter exemplos de solicitação de segmento.