/dubbing

English ｜ 한국어 ｜ Español ｜ Português ｜ Русский ｜ Bahasa Indonesia ｜ Deutsch ｜ ไทย ｜ 日本語 ｜ 繁體中文 ｜ 简体中文 ｜ Tiếng Việt ｜ Français

Häufig gestellte Fragen zu den /dubbing- und /srt-Skills. Informationen zu Einrichtung und Nutzung findest du im README.

Was brauche ich, um sie zu nutzen?

Node.js 18+ ist alles, was du brauchst. Gestylte Untertitel, das Übersetzen eines von dir bereitgestellten SRT und Kurzclips funktionieren ohne Anmeldung. Nur die serverseitigen KI-Schritte (Synchronisation, Lippensynchronisation, Trennung, Speech-to-Text) benötigen einen Perso Dubbing API-Schlüssel. → API-Schlüssel holen

Wie registriere ich meinen API-Schlüssel?

Beim ersten Durchlauf öffnet sich eine Browser-Seite — melde dich an und klicke einmal, dann wird dein Schlüssel ausgestellt und verschlüsselt auf diesem Rechner gespeichert. Nichts zu kopieren. Falls sich kein Browser öffnen lässt, öffnet sich stattdessen eine Schlüsseldatei: Füge nur deinen API-Schlüssel in sie ein und speichere (sie wird verschlüsselt und die Datei gelöscht). Füge den Schlüssel niemals in den Chat ein. Manuelle Prüfung: npm run key:check.

Kostet es etwas?

Die Skill ist kostenlos und quelloffen (MIT). Gestylte Untertitel, das Übersetzen eines von dir bereitgestellten SRT und Kurzclips sind kostenlos. Nur die serverseitigen KI-Schritte (Synchronisation, Lippensynchronisation, Trennung, Speech-to-Text) berechnen Credits — du zahlst nur für das, was du verarbeitest.

Was kann ich ihr als Eingabe geben?

Eine lokale Datei, einen lokalen Ordner oder eine URL (YouTube, TikTok, Google Drive). Übergroße oder sehr lange Videos werden automatisch aufgeteilt, verarbeitet und wieder zusammengeführt.

Kann sie in mehrere Sprachen synchronisieren oder viele Dateien auf einmal verarbeiten?

Ja. Gib mehrere Sprachen in einem Befehl an (--target en,ja,zh) — die Quelle wird einmal hochgeladen und aufgeteilt und anschließend für jede Sprache wiederverwendet. Du kannst außerdem mehrere Dateien, Ordner und URLs in einem einzigen Lauf mischen.

Wo werden meine Ergebnisse gespeichert?

Standardmäßig neben dem Ausgangsvideo, oder in dem Ordner, den du mit --out angibst. Jeder Lauf ist außerdem ein Projekt in deinem Perso-Portal (https://perso.ai/en/workspace/vt), wo du es erneut herunterladen oder andere Formate erhalten kannst.

Was ist Lippensynchronisation?

Sie passt die Mundbewegungen an das synchronisierte Audio an. Sie läuft nach der Synchronisation, funktioniert nur mit Video, dauert deutlich länger und kostet zusätzliche Credits. Füge --lipsync hinzu.

Was ist die Audiotrennung?

Sie teilt die Quelle in Stimme / Hintergrund / Sub-Hintergrund-Spuren auf — ohne Synchronisation. Füge --separate hinzu.

Kann sie auch Untertitel (SRT) statt Synchronisation erstellen?

Die /srt-Skill extrahiert die Untertitel in der Originalsprache aus einem Video, einer Audiodatei oder einer URL per Perso-Speech-to-Text. Wenn du sie auch übersetzt haben möchtest, frage nach dem SRT und den gewünschten Sprachen. Sie kann außerdem gestylte Untertitel ins Video einbrennen — fertige Voreinstellungen oder deine eigene Schriftart, Farbe und Position — was lokal läuft und kostenlos ist (bring dein eigenes SRT mit und es werden weder Schlüssel noch Credits benötigt).

Sie hat mittendrin gestoppt (Credits aufgebraucht, ein Absturz oder eine abgebrochene Shell). Was jetzt?

Der Fortschritt wird während des gesamten Laufs in einer Zustandsdatei gespeichert (*.dubresume.json für /dubbing, *.srtresume.json für /srt). Führe den ausgegebenen Befehl --resume "<state-file>" erneut aus, um nur die verbleibenden Teile fertigzustellen — abgeschlossene Teile werden übersprungen und nie erneut berechnet.

Mir sind die Credits ausgegangen. Wie lade ich auf?

Die Skill kann einen Stripe-Zahlungslink generieren (Abonnieren, Plan wechseln oder Credits kaufen, je nach deinem Plan). Du öffnest den Link und bezahlst selbst — der Agent bezahlt niemals in deinem Namen. Setze nach dem Aufladen mit dem ausgegebenen --resume-Befehl fort.

Kann ich synchronisieren, ohne eine lokale Datei zu speichern?

Ja, bei einem einzelnen (nicht aufgeteilten) Video: Füge --no-save hinzu. Das Ergebnis bleibt in deinem Perso-Workspace und wird nicht heruntergeladen. Aufgeteilte Videos werden weiterhin normal gespeichert, da die zusammengeführte Datei einen lokalen Download benötigt.

node wurde nicht gefunden — was mache ich?

Die Skill benötigt Node.js 18+. Prüfe das mit node -v; installiere die LTS-Version von https://nodejs.org, oder bitte einfach den Agenten, sie für dich zu installieren, und versuche es dann erneut.

Wie aktualisiere ich die Skill?

npx perso-dubbing@latest, oder im Claude Code Plugin: /plugin update perso-dubbing.

Welche Daten sammelt die Skill?

Nur Nutzungsereignisse — welche Aktion ausgeführt wurde, ob sie erfolgreich war, grobe Zählwerte, App-Version und Betriebssystem — versehen mit einer zufälligen, installationsspezifischen ID und deiner Workspace-Nummer. Dein API-Schlüssel und deine Medien sind niemals enthalten.