> 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.

# batch-lipsync-Skill

> Der batch-lipsync-Skill von sync. labs macht viele Videos auf einmal lippensynchron, aus einer CSV-Datei, einer Tabelle, einem Ordner oder einer Liste: Er schätzt die Kosten des gesamten Laufs, bietet einen Pilotlauf an, hält sich an die gleichzeitigen Aufträge deines Tarifs und setzt fort, ohne doppelt zu zahlen.

> **Tip**
>
> Installiere diesen Skill mit `npx skills add synchronicity-labs/skills --skill batch-lipsync` oder hol dir alle Skills mit dem Claude Code-Plugin. Siehe [Agent Skills](/docs/plugins-and-extensions/agent-skills/overview).

## Was er macht

`batch-lipsync` macht viele Videos auf einmal lippensynchron: ein Ergebnis pro Zeile einer CSV-Datei, einer Tabelle, eines Ordners oder einer Liste wie „dieser Moderator mit jeder dieser 40 Audiodateien“. Er erstellt ein Manifest, schätzt die Kosten des gesamten Laufs, bietet einen Pilotlauf an, verarbeitet dann jede Zeile innerhalb der Limits deines Tarifs und sammelt die Ergebnisse in einer Ergebnistabelle.

Mit einem API-Schlüssel nutzt er ein mitgeliefertes Skript, `sync_batch.py`, das jede Datei einmal hochlädt, die gleichzeitigen Aufträge deines Tarifs einhält, nach einer Unterbrechung fortsetzt und jedes Ergebnis herunterlädt. Ab dem Scale-Tarif können 20 oder mehr Zeilen stattdessen über die [Batch API](/docs/api-reference/guides/batch-processing) laufen, entweder mit dem Skript oder direkt über die Batch-Tools des MCP-Servers.

## Wann du ihn nutzt

| Was du hast                                                                      | Nimm                                                                                                     |
| -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Viele Zeilen mit Video plus Audio oder Skript                                    | `batch-lipsync`                                                                                          |
| Ein personalisiertes Video pro Lead oder Kunde                                   | `batch-lipsync`                                                                                          |
| Eine Aufnahme, personalisiert mit dem Namen jedes Empfängers in derselben Stimme | Vorschauen mit [edit-dialogue](/docs/plugins-and-extensions/agent-skills/edit-dialogue), dann `batch-lipsync` |
| Mehrere Videos in andere Sprachen                                                | [localize-campaign](/docs/plugins-and-extensions/agent-skills/localize-campaign)                              |
| Ein einzelnes Video                                                              | [lipsync](/docs/plugins-and-extensions/agent-skills/lipsync)                                                  |

## Probier es aus

* „Mach jede Zeile aus leads.csv auf presenter.mp4 lippensynchron“
* „Erstelle eine Version dieser Anzeige für jedes dieser 12 Voiceovers“
* „Lass manifest.csv durch sync laufen, die Summe ist freigegeben“

## Was du brauchst

* Den verbundenen sync. MCP-Server oder `SYNC_API_KEY` und Python 3.9 oder neuer für das Skript. Der [setup](/docs/plugins-and-extensions/agent-skills/setup)-Skill führt dich durch beides.
* Eine Liste, in der jede Zeile ein Video oder Bild und Audio oder ein Skript mit Stimme hat.

## Häufige Fragen

#### Warum will er einen Pilotlauf?

Wenn eine gemeinsame Eingabe falsch ist, etwa die Stimme oder der Bildausschnitt des Moderators, kostet ein Pilotlauf zwei Generierungen statt zweihundert.

#### Was verlässt meinen Rechner?

Die Medien, die Skripte, Dateinamen und die Zeilen-IDs (als Namen der Ergebnisse). Spalten, die der Lauf nicht nutzt, bleiben lokal, also halte Namen und E-Mail-Adressen aus den Zeilen-IDs heraus.

#### Er hat mittendrin aufgehört.

Führe denselben Befehl erneut aus. Fertige Zeilen werden übersprungen, übermittelte Zeilen werden abgefragt statt neu übermittelt, und nichts, was schon bezahlt ist, wird noch einmal bezahlt.

#### Ich habe eine Zeile geändert, nachdem sie gelaufen ist.

Das Skript weigert sich, das Ergebnis dieser Zeile wiederzuverwenden. Gib der geänderten Zeile eine neue ID, damit wird sie zu einer neuen Generierung.

#### Sollte ich die Batch API nutzen?

Ab Scale, für 20 bis 500 kurze Zeilen, wenn eine Bearbeitungszeit von bis zu 24 Stunden in Ordnung ist. In anderen kostenpflichtigen Tarifen kann ein Batch nur so viele Zeilen enthalten, wie der Tarif gleichzeitig verarbeitet, der normale Lauf ist also genauso schnell.

#### Einige Zeilen sind fehlgeschlagen.

Die Ergebnistabelle listet jeden Fehler mit Grund auf. Zeilen, die an fehlerhaften Eingaben gescheitert sind, brauchen eine korrigierte Eingabe. Wiederhole den Rest mit `--retry-failed`.

## Es funktioniert, wenn

* Die Kostenschätzung jede Zeile abdeckt oder dir sagt, für welche Zeilen kein Preis ermittelt werden konnte.
* Nie mehr Generierungen gleichzeitig laufen, als dein Tarif erlaubt.
* Ein erneuter Lauf über ein fertiges Manifest nichts Neues erstellt.