HeyGenKapitel 6 von 6

Video Agent, API und Live-Avatare

HeyGen
Profi
etwa 35 Minuten
Stand: 20.10.2026

Unabhängiger Guide. DailyVYBZ ist weder mit HeyGen noch mit Higgsfield verbunden. Ich werde von diesen Unternehmen nicht beauftragt und nicht bezahlt. HeyGen und Higgsfield sind Namen beziehungsweise Marken ihrer jeweiligen Inhaber. Stand der Angaben: 20.10.2026. Preise und Bedingungen ändern sich oft. Prüfe sie vor der Nutzung beim Anbieter.

Ziel

Du erzeugst Videos aus einem Prompt und holst sie über die Programmierschnittstelle (API) automatisch ab, ohne Überraschungen bei Kosten und Grenzen.

Voraussetzungen

Ein HeyGen-Konto.
API-Guthaben ab 5,00 US-Dollar. Es ist getrennt von den Plan-Credits und läuft nach 12 Monaten ab.
Grundkenntnisse im Terminal oder in einem Automatisierungswerkzeug.
Für Webhooks eine eigene HTTPS-Adresse.

So gehst du vor

Video Agent im Browser testen
Öffne Video Agent auf der Startseite. Wähle einen Avatar, dann „Chat Mode“, in dem du den Plan prüfst, oder „Autopilot“. Lege Dauer und Format fest und gib Skript und Stil vor. Chat und Planung sind kostenlos. Credits fließen erst, wenn Inhalte erzeugt werden, also ab „Proceed“.
In der App: Video AgentChat Mode
Schlüssel holen und erster Aufruf
Den Schlüssel gibt es unter platform.heygen.com/api-keys. Speichere ihn als Umgebungsvariable HEYGEN_API_KEY. Schick einen Prompt an POST /v3/video-agents. Frag den Status ab, bis „completed“ und eine video_url da sind.
Webhook statt Dauerabfrage
Lege einen Endpunkt unter /v3/webhooks/endpoints an. Prüfe die Signatur: HMAC-SHA256 über den rohen Inhalt der Anfrage, Kopfzeile signature. Antworte innerhalb von 10 Sekunden mit einem 2xx-Status. Doppelte Zustellungen erkennst du an video_id und Ereignistyp.
Grenzen und Live-Avatare einordnen
Kenne die Grenzen, siehe „Gut zu wissen“. Bei Fehler 429 wartest du den Wert aus Retry-After ab. Rechne die Preise pro Minute vorher. LiveAvatar ist eine eigene Plattform mit eigenen Plänen und nur mit Programmierung nutzbar.

Zum Kopieren

Prompt für Video Agent

Erstelle ein Hochformat-Video von dreißig Sekunden zum Thema "Drei Fehler bei deinem ersten KI-Video". Mein Avatar spricht ruhig und direkt in die Kamera. Folge dem Skript unten Szene für Szene. Zeige die drei Fehler als Einblendungen. Nutze zwischen den Szenen ruhige Stock-Aufnahmen.

Stil: Name "Klartext-Studio". Farben: [Hauptfarbe mit Hex-Code], [Akzentfarbe mit Hex-Code], Weiß #FFFFFF. Klare Linien, große serifenlose Schrift, viel Leerraum. Einblendungen gleiten sanft von unten ein. Übergänge sind weiche Überblendungen. Ruhig, klar, selbstbewusst.

Skript:
Szene eins: Avatar auf Kamera. "Dein erstes KI-Video muss nicht perfekt sein. Aber diese drei Fehler kosten dich Zeit."
Szene zwei: Einblendung "Fehler eins: Zahlen nicht ausgeschrieben". "Schreibe Zahlen als Wörter. Sonst liest die Stimme sie falsch."
Szene drei: Einblendung "Fehler zwei: mehrfach neu rendern". "Höre erst die Vorschau an. Dann sende ab."
Szene vier: Einblendung "Fehler drei: Wasserzeichen ignorieren". "Wer Werbung macht, braucht einen bezahlten Tarif."
Szene fünf: Avatar auf Kamera. "Speichere dir das. Und starte dein erstes Video noch heute."

Ersetze die Farbfelder durch deine echten Markenfarben. Aufbau nach dem Prompt-Leitfaden der HeyGen-Doku: Dauer zuerst, dann ein Absatz zum Stil, dann das Skript Szene für Szene.

Kleinster Aufruf der Schnittstelle

curl -X POST "https://api.heygen.com/v3/video-agents" \
  -H "X-Api-Key: $HEYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Kurzes Erklärvideo: So nutzt unser Team KI im Büroalltag, etwa 30 Sekunden"}'

Aus der offiziellen Schnellstart-Anleitung. Der Schlüssel kommt aus der Umgebungsvariable, nie direkt in den Befehl.

Ergebnis

Ein Video, das über die Schnittstelle entsteht und sich per Webhook meldet. Dazu kennst du die Kosten pro Minute und die Grenzen.

Fehlerbehebung

Die Webhook-Signatur stimmt nie.

Du hast den Inhalt vor der Prüfung als JSON neu geschrieben. Prüfe die Signatur über den rohen Inhalt. Erst danach wandelst du ihn um.

Fehler 429 Too Many Requests.

Du hast eine Grenze erreicht. Warte den Wert aus Retry-After ab und sende dann erneut.

Der Download-Link funktioniert nicht mehr.

Download-Links sind signiert und laufen ab. Frag das Video neu ab, dann bekommst du einen frischen Link.

Zapier, Make oder n8n laufen nicht, obwohl du Credits hast.

Plan-Credits gelten nicht für Integrationen wie HubSpot, Clay, Zapier, Make oder n8n. Dafür brauchst du API-Guthaben, ab 5,00 US-Dollar.

Gut zu wissen

Video Agent nutzt Avatar V für echte Menschen und Avatar IV für virtuelle Figuren. Kosten: etwa 60 bis 80 Credits pro Minute, mit Seedance etwa 180 bis 240. Vor dem Start zeigt eine Karte die Schätzung.
Preise der Schnittstelle pro Minute (Stand 19.10.2026): Avatar V als Digital Twin 7,20 US-Dollar, Avatar IV 4,83 US-Dollar, Photo Avatar 2,31 US-Dollar, Video Agent 5,82 US-Dollar, Übersetzung mit Lippensync 0,81 bis 1,50 US-Dollar.
Grenzen pro Nutzer und Pfad: Lesen 300 pro Minute, Schreiben 10 pro Sekunde, schwere Aufrufe 30 pro Minute, Statusabfragen 500 pro Minute. Gleichzeitige Aufträge: 10.
Eingaben: Avatar-Skript bis 5.000 Zeichen, Prompt für Video Agent bis 10.000 Zeichen, bis zu 20 Dateien.
HeyGen hat einen Konnektor (MCP) für Claude und andere Assistenten: https://mcp.heygen.com/mcp/v1/. Er meldet sich per OAuth an und verbraucht Plan-Credits.
LiveAvatar: Gratis zum Testen mit Sitzungen bis 2 Minuten, Essential für 99,00 US-Dollar im Monat, Business für 475,00 US-Dollar im Monat.

Achtung

Der API-Schlüssel ist ein Geheimnis. Er gehört nie in einen Chat, ein Skript-Archiv oder ein öffentliches Repository.
Plan-Credits und API-Guthaben sind getrennt. Ein Skript, das viele Videos erzeugt, kostet echtes Geld. Teste mit kurzen Videos.
Wer HeyGen über einen KI-Assistenten bedient, verbraucht dabei Plan-Credits. Entscheide das bewusst.

Quellen

Stand: 20.10.2026. Alle Angaben stammen aus den offiziellen Seiten von HeyGen, abgerufen am 20.10.2026. Menünamen können in deiner App abweichen. Fehler gefunden? Schreib uns.

0 von 12 gelesen

Video Agent, API und Live-Avatare

Ziel

Voraussetzungen

So gehst du vor

Video Agent im Browser testen

Schlüssel holen und erster Aufruf

Webhook statt Dauerabfrage