> For the documentation index, fetch https://sync.so/docs/llms.txt. Append .md to a page URL for Markdown. Documentation-search MCP: https://sync.so/docs/_mcp/server.

# Skill batch-lipsync

> A skill de agente batch-lipsync da sync. labs sincroniza os lábios de muitos vídeos de uma vez a partir de um CSV, planilha, pasta ou lista: ela estima o custo da execução inteira, oferece um piloto, respeita a concorrência do seu plano e retoma sem pagar duas vezes.

> **Tip**
>
> Instale esta skill com `npx skills add synchronicity-labs/skills --skill batch-lipsync`, ou obtenha todas as skills com o plugin do Claude Code. Veja [Skills de agente](/docs/plugins-and-extensions/agent-skills/overview).

## O que faz

A `batch-lipsync` sincroniza os lábios de muitos vídeos de uma vez: um resultado por linha de um CSV, uma planilha, uma pasta ou uma lista como “este apresentador com cada um destes 40 arquivos de áudio”. Ela cria um manifesto, estima o custo da execução inteira, oferece um piloto, depois processa cada linha dentro dos limites do seu plano e reúne os resultados em uma tabela.

Com uma chave de API, ela usa um script incluído, `sync_batch.py`, que envia cada arquivo uma única vez, respeita a concorrência do seu plano, retoma após uma interrupção e baixa todos os resultados. Nos planos Scale e superiores, 20 linhas ou mais podem ir pela [Batch API](/docs/api-reference/guides/batch-processing), seja com o script ou direto pelas ferramentas de batch do servidor MCP.

## Quando usar

| O que você tem                                                          | Use                                                                                                     |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| Muitas linhas de vídeo com áudio ou roteiro                             | `batch-lipsync`                                                                                         |
| Um vídeo personalizado por lead ou cliente                              | `batch-lipsync`                                                                                         |
| Uma gravação personalizada com o nome de cada destinatário na mesma voz | Prévias da [edit-dialogue](/docs/plugins-and-extensions/agent-skills/edit-dialogue) e depois `batch-lipsync` |
| Vários vídeos em outros idiomas                                         | [localize-campaign](/docs/plugins-and-extensions/agent-skills/localize-campaign)                             |
| Um único vídeo                                                          | [lipsync](/docs/plugins-and-extensions/agent-skills/lipsync)                                                 |

## Experimente

* “Sincronize cada linha de leads.csv em presenter.mp4”
* “Faça uma versão deste anúncio para cada uma destas 12 narrações”
* “Rode manifest.csv na sync, o total está aprovado”

## O que você precisa

* O servidor MCP da sync. conectado, ou `SYNC_API_KEY` e Python 3.9 ou posterior para o script. A skill [setup](/docs/plugins-and-extensions/agent-skills/setup) orienta você em qualquer uma das opções.
* Uma lista em que cada linha tenha um vídeo ou uma imagem, e um áudio ou um roteiro com uma voz.

## Perguntas frequentes

#### Por que ela quer um piloto?

Se uma entrada compartilhada estiver errada, como a voz ou o enquadramento do apresentador, um piloto custa duas gerações em vez de duzentas.

#### O que sai da minha máquina?

As mídias, os roteiros, os nomes de arquivo e os IDs das linhas (usados como nomes dos resultados). As colunas que a execução não usa ficam no seu computador, então não coloque nomes nem e-mails nos IDs das linhas.

#### Ela parou no meio.

Execute o mesmo comando de novo. As linhas concluídas são puladas, as enviadas são consultadas em vez de reenviadas, e nada que já foi pago é pago de novo.

#### Mudei uma linha depois que ela rodou.

O script se recusa a reutilizar o resultado dessa linha. Dê um novo ID à linha alterada, o que a transforma em uma nova geração.

#### Devo usar a Batch API?

No Scale e superiores, para 20 a 500 linhas curtas quando um prazo de entrega de até 24 horas está ok. Nos outros planos pagos, um batch só comporta tantas linhas quanto o plano processa ao mesmo tempo, então a execução normal é igualmente rápida.

#### Algumas linhas falharam.

A tabela de resultados lista cada falha com o motivo. Linhas que falharam por entrada inválida precisam de uma entrada corrigida. Tente as demais de novo com `--retry-failed`.

## Está funcionando se

* A estimativa cobre todas as linhas ou informa quais linhas não conseguiu precificar.
* Nunca rodam ao mesmo tempo mais gerações do que o seu plano permite.
* Rodar de novo um manifesto concluído não cria nada novo.