yyert123/shorts-voiceover

Was macht shorts-voiceover?

Skript rein, upload-fertiges Short raus. Im Gegensatz zu Tools, die die Untertitel-Positionierung aus der Textlänge schätzen, transkribiert dieses Skill die fertige Sprachspur, sodass jeder Untertitel genau dann erscheint, wenn das Wort gesprochen wird.

Wann verwenden

• „Mach aus diesem Skript / diesen Tipps / diesem Beitrag ein Short (oder Reel, oder TikTok).“
• „Erstelle ein faceless Short mit Voiceover und Untertiteln.“ „Verwende meine Stimme.“
• „Mach 5 Shorts aus diesen Skripten“ -> Einmal pro Skriptdatei ausführen.

Schritte

1. Überprüfe, ob MIRAGEA_API_KEY gesetzt ist (niemals ausgeben). Stimme: die Miragea-Stimmen-ID des Benutzers oder eine öffentliche URL eines Clips seiner Stimme sowie der genaue Text. Schlage export MIRAGEA_VOICE_ID=... vor. Klone nur eine Stimme, die dem Benutzer gehört oder die er verwenden darf.

2. Schreibe das Skript: ein kurzer Absatz pro Szene, Leerzeile zwischen den Szenen, insgesamt 120–170 Wörter für ein 45–60 s Short. Beginne mit einem Haken in Szene 1. Optional @datei am Anfang einer Szene wählt deren Hintergrund aus:

   Drei schnelle Tipps, um jedes Voiceover professionell klingen zu lassen.
   
   @broll/desk.mp4
   Erstens: Nimm in einem kleinen Raum mit weichen Möbeln auf. Hall ist schwerer zu beheben als Rauschen.
   

3. Rendern:

   python3 scripts/short.py tipps.txt --voice STIMMEN_ID                       # Farbverlaufs-Hintergründe
   python3 scripts/short.py tipps.txt --media ./broll --music bett.mp3        # eigene Bilder/Clips + Musik
   

4. Gib dem Benutzer video und srt aus dem gedruckten JSON. Biete Bearbeitungen an: Text einer Szene ändern und erneut ausführen; nur diese Szene wird neu vertont, der Rest kommt aus dem Cache.

Was automatisch passiert

Schritt	Wie
Stimme	Jede Szene mit Miragea vertont; 0,18 s Atemzug zwischen den Szenen
Untertitel-Timing	Fertige Sprachspur wird von Miragea transkribiert; 1–3 Wörter GROSSGESCHRIEBENE Hinweise, unteres Drittel
Bilder	Auf 9:16 zugeschnitten, langsamer Zoom rein/raus, pro Szene abwechselnd
Clips	Auf 9:16 zugeschnitten, geloopt oder auf die Szenenlänge getrimmt, Originalton entfernt
Kein Medium	Animierter Farbverlauf (4 Paletten, rotierend)
Musik	Gelooppt, bei 30 %, per Sidechain unter der Stimme geduckt
Lautstärke	-14 LUFS integriert, -1 dBTP (Shorts/TikTok/Reels Zielwert)
Wiederholungen	Stimme pro Szene und Transkript zwischengespeichert; unveränderte Szenen sind kostenlos

Optionen

Flag	Standard	Funktion
--voice ID / --ref-url URL --ref-text TEXT	env	Gespeicherte Miragea-Stimme oder Klon aus einem öffentlichen Clip
--media VERZ	keine	Bilder/Clips für Szenen ohne @datei, in Namensreihenfolge
--music DATEI	keine	Hintergrundmusik, automatisch geduckt
--lowercase	aus	Satzfall-Untertitel
--no-captions	aus	Untertitel überspringen (keine Transkriptionskosten)
--model	expressive	oder standard
-o DATEI	SKRIPT.short.mp4	Ausgabepfad

Kosten und Grenzen

Stimme: pro Zeichen (ein Short mit 150 Wörtern hat ca. 850 Zeichen). Untertitel-Timing: 3 Punkte pro Sekunde der fertigen Stimme (~75 Punkte für 25 s); danach gecached. Aktuelle Preise: GET https://miragea.ai/v1/capabilities. Szenen müssen unter 2.000 Zeichen sein. Eine Warnung wird ab 3 Minuten ausgegeben (YouTubes Shorts-Limit).

Fehlerbehebung

• media file not found -> Pfade nach @ sind relativ zum Skript oder zum --media Ordner.
• No such filter: gradients -> ffmpeg ist älter als 6.1; aktualisieren oder --media mit Bildern übergeben.
• 401 Schlüssel falsch, 402 Guthaben aufladen auf miragea.ai, 429 warten und erneut ausführen (nichts Gecachtes wird erneut berechnet).

Verwende nur Musik und Material, für das du die Rechte hast. Siehe examples/ für ein echtes Skript und dessen Ausgabe.