Markus Michalski FAQ

VidCraft Plattformen - HeyGen und Synthesia

HeyGen und Synthesia in VidCraft: geprüfte Limits, Pausen-Syntax und SSML, Variablen für personalisierte Videos, Voice Director, Avatar-Gesten, Express-Avatare und das Ausgabeformat der Formatierungs-Tools.

VidCraft Plattformen - HeyGen und Synthesia

English Version

Zurück zur Übersicht


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.

Limits, die VidCraft prüft

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.


HeyGen

Harte Regeln

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.

Pausen

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

Variablen für personalisierte Videos

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.

SSML Prosody (optional)

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.

Voice Director und Motion Prompts

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.

Ausgabeformat

heygen_format_script erzeugt je Szene einen Block mit Titel, Typ (avatar, screencast, split), Avatar-Position, Hintergrund, Text-Overlay, Narration und Zeichenzähler.


Synthesia

Harte Regeln

Pausen

[pause Xs] wird von synthesia_format_script automatisch in <break time="Xs"/> umgewandelt.

Gesten und Express-Avatare

Layouts

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

Beide Plattformen