VidCraft bereitet Scripts für HeyGen und Synthesia nur vor. Es gibt keine API-Anbindung: Du kopierst das formatierte Script selbst in die Plattform und generierst dort das Video.
Das Tool validate_platform_limits und der Skill pre-generation-check messen die Narration jeder Szene gegen diese Werte:
| Plattform | Zeichen je Szene | Szenen je Video |
|---|---|---|
| HeyGen | 5000 | 100 |
| Synthesia | 1000 | 150 |
Überschreitung meldet FAIL, ab 90 Prozent des Limits gibt es eine Warnung. Der Tool-Aufruf get_platform_capabilities liefert zusätzlich Auflösung, Sprachanzahl und Eigenschaften der Plattform.
Overlays mit Zeitangabe markierst du im Script so: [post-production overlay: "Text" at 00:12-00:15]. Der heygen-engineer entfernt diese Marker vor der Formatierung und listet sie als Nachbearbeitungs-Aufgaben.
[pause 0.5s] und [pause 1s] im Script werden von heygen_format_script in SSML <break time="0.5s"/> umgewandelt. Pausen wirken nur bei eigenen Stimmen (Voice Clone, ElevenLabs, OpenAI Voice); die öffentliche HeyGen-Stimmenbibliothek ignoriert sie. Das Tool hängt in diesem Fall einen Hinweis an die Szene an.
Für öffentliche Stimmen steuerst du das Tempo mit Satzzeichen und Absätzen.
Platzhalter im Format {{snake_case}} in Narration oder Bildschirmtext erkennt heygen_format_script automatisch und listet sie am Ende der Ausgabe. Alle Variablen müssen in der HeyGen Template API deklariert sein, sonst erscheinen sie als Klartext im Video. Typen: text, image, video, audio, avatar. URLs gehören nur auf den Bildschirm, nie in die Narration.
Tags wie <prosody rate="slow"> und <emphasis level="strong"> gelten als von der Community bestätigt, stehen aber nicht in der offiziellen HeyGen-Dokumentation. Sie wirken nur mit eigenen Stimmen, werden nie automatisch eingefügt und tragen im Ausgabetext einen entsprechenden Hinweis. Teste sie mit einer kurzen Szene, bevor du sie im ganzen Video einsetzt.
Der heygen-engineer empfiehlt je Szene ein Voice-Director-Preset (Casual, Calm, Excited, Serious, Cool) oder einen frei formulierten Prompt. Für Avatar-IV-Avatare ergänzt er Motion Prompts als kurze Sätze wie "Points forward with confidence." Beides setzt du manuell im HeyGen AI Studio.
heygen_format_script erzeugt je Szene einen Block mit Titel, Typ (avatar, screencast, split), Avatar-Position, Hintergrund, Text-Overlay, Narration und Zeichenzähler.
[pause Xs] wird von synthesia_format_script automatisch in <break time="Xs"/> umgewandelt.
[gesture:nod], [gesture:headyes], [gesture:headno], [gesture:eyebrowsup], [gesture:increase] im Text.!, ?, ... und Emoticons. Passagen über 60 Sekunden ganz ohne ! und ? wirken ausdruckslos, script-reviewer, voice-checker und synthesia-engineer weisen darauf hin.synthesia_format_script ordnet den Bildtyp einem Layout zu:
| Bildtyp | Layout |
|---|---|
avatar |
Avatar mittig, einfarbiger Hintergrund |
screencast |
Bildschirmaufnahme vollflächig, Avatar als Overlay in der Ecke |
slides |
Textlayout, Avatar links |
split |
Geteilter Bildschirm: Avatar links, Medien rechts |
b-roll |
Medien vollflächig, kein Avatar |
check_pronunciation: Jahreszahlen, Abkürzungen und lateinische Kürzel. Es ersetzt nichts automatisch, du entscheidest über jeden Vorschlag.