Mit der App HeyGen im App-Katalog (Kategorie KI und Medien) verbindest du dein HeyGen-Konto mit deinem eigenen API-Schlüssel. KI-Assistenten wie Claude oder ChatGPT lesen dann über MCP deine Avatare, Stimmen und Vorlagen, prüfen dein Guthaben und erstellen auf deinen Wunsch Avatarvideos, füllen Vorlagen, übersetzen Videos oder starten den Video Agent von HeyGen.
Beta: HeyGen ist neu im App-Katalog und trägt die Markierung Beta. Du kannst die App ganz normal verbinden und nutzen, in dieser Phase kann sich aber noch etwas ändern.
Kosten: Abgerechnet wird über die API-Abrechnung von HeyGen
Videos, Übersetzungen und der Video Agent kosten Geld. Abgerechnet wird über die API-Abrechnung deines HeyGen-Kontos, also über ein Prepaid-Guthaben oder nutzungsbasiert. Die Credits eines HeyGen-Web-Abos gelten für die API nicht. FlowConnect selbst berechnet für HeyGen nichts und bucht nie etwas von einem FlowConnect- oder FlowModels-Guthaben ab.
Wie teuer ein Video wird, hängt von Länge, Auflösung und Engine ab und steht vorher nicht fest. FlowConnect kann die Kosten deshalb nicht vorab schätzen. Begrenze sie direkt bei HeyGen: mit einem Ausgabenlimit auf platform.heygen.com und mit einem eingeschränkten API-Schlüssel (siehe unten). Beides zeigt dir FlowConnect auf der App-Seite an.
API-Schlüssel bei HeyGen anlegen
- Melde dich bei HeyGen an und öffne platform.heygen.com/api-keys.
- Lege einen neuen Schlüssel an und gib ihm einen Namen, zum Beispiel „FlowConnect“. Der Name erscheint später in FlowConnect beim Konto.
- Wähle eingeschränkte Rechte statt Vollzugriff (
*:*) und gib nur diese Rechte frei:account:read: Abrechnung, Guthaben und Ausgabenlimitavatars:read,voices:readundtemplates:read: Avatare, Stimmen und Vorlagen lesenvideos:write: Avatarvideos und Videos aus Vorlagen erstellentranslations:write: Videos übersetzenvideo_agent:write: den Video Agent starten
- Optional: Lege ein Ablaufdatum fest. FlowConnect zeigt es an und schickt dir 30 Tage vorher eine E-Mail mit einer Erinnerung.
- Kopiere den Schlüssel und bewahre ihn sicher auf.
Ein :write-Recht schließt das Lesen derselben Sache ein, mit videos:write kann der KI-Assistent also auch den Stand deiner Videos abfragen. Lässt du die :write-Rechte weg, kann der Schlüssel nur lesen und nichts kosten. Ohne account:read lässt sich der Schlüssel trotzdem verbinden, FlowConnect zeigt dann aber weder Guthaben noch Ausgabenlimit an.
HeyGen verbinden
- Öffne im App-Katalog die Seite HeyGen und klicke auf Neu verbinden.
- Trage deinen API-Schlüssel ein. Der Haken Für das Team freigeben ist nicht gesetzt. Lass ihn so, wenn nur du das Konto nutzen sollst.
- Klicke auf Verbinden.
FlowConnect prüft den Schlüssel direkt bei HeyGen. Lehnt HeyGen ihn ab, siehst du eine Meldung und es wird nichts gespeichert. Der Schlüssel wird verschlüsselt gespeichert und nie wieder angezeigt. Danach steht das Konto unter Deine, mit deinem Vornamen und dem Namen des Schlüssels, zum Beispiel „HeyGen Alex · FlowConnect“.
Du kannst mehrere Schlüssel verbinden, zum Beispiel für verschiedene HeyGen-Workspaces. Für FlowConnect ist jeder Schlüssel ein eigenes Konto. Einen neuen Schlüssel trägst du im Kontomenü über Zugangsdaten erneuern ein.
Die Kontokarte
Unter Konto bei HeyGen zeigt die App-Seite für jedes deiner HeyGen-Konten eine Karte:
- Abrechnung: Bei Prepaid-Guthaben siehst du dein Guthaben und ob Automatisch aufladen an ist. Bei Nutzungsbasiert siehst du unter Bisher ausgegeben deine bisherigen Ausgaben, dazu dein Ausgabenlimit und, falls HeyGen sie meldet, deine übrigen Credits. Steht dort Kein Limit, rechnet HeyGen jede Nutzung ab. Ein Limit legst du bei HeyGen fest.
- API-Schlüssel: Name, Rechte (Vollzugriff, Nur Lesen oder Eingeschränkt mit der Liste der freigegebenen Rechte) und das Ablaufdatum unter Läuft ab.
- Hinweise: Hat der Schlüssel Vollzugriff, empfiehlt dir die Karte einen eingeschränkten Schlüssel mit genau den Rechten von oben. Fehlen Rechte, die einzelne Werkzeuge brauchen, nennt die Karte sie.
Die Angaben sind höchstens zehn Minuten alt, unter der Karte steht der Stand. Mit Aktualisieren fragst du HeyGen sofort neu. Ist HeyGen gerade nicht erreichbar, zeigt die Karte die Angaben zum Schlüssel, die beim Verbinden gespeichert wurden.
Stufe „Kostenpflichtig“
Unter Tools siehst du auf der App-Seite alle Werkzeuge. Neben jedem steht seine Stufe: Lesen oder Kostenpflichtig. Die Stufe Kostenpflichtig gibt es nur bei HeyGen, und zwar für diese vier Werkzeuge:
- HeyGen-Avatarvideo erstellen: ein Video mit einem deiner Avatare, einer Stimme und einem Skript.
- HeyGen-Video aus Vorlage erzeugen: eine deiner HeyGen-Vorlagen mit Texten füllen.
- HeyGen-Video übersetzen: ein Video in eine oder mehrere Sprachen übersetzen.
- HeyGen-Video-Agent starten: HeyGen erstellt aus einer Beschreibung selbst ein Video.
Jedes kostenpflichtige Werkzeug braucht deine ausdrückliche Bestätigung. Der KI-Assistent fragt dich vorher, nennt Avatar, Stimme und ungefähre Länge und startet den Auftrag erst, wenn du zugestimmt hast. Ohne Bestätigung passiert nichts.
Videos entstehen bei HeyGen im Hintergrund, das Rendern dauert etwa fünf- bis zehnmal so lange wie das Video. Der KI-Assistent fragt den Stand ab und gibt dir zum Schluss den Download-Link von HeyGen. Dieser Link läuft nach einiger Zeit ab. Die fertigen Videos liegen in deinem HeyGen-Konto.
Löschen, Dateien hochladen und Avatare oder Stimmen anlegen kann der KI-Assistent über FlowConnect nicht. Audio- oder Videodateien als Quelle müssen über eine öffentliche https-Adresse erreichbar sein. HeyGen lädt sie selbst herunter.
Mit dem Team teilen
Du kannst dein HeyGen-Konto wie jede andere App mit deinem Team teilen, siehe App-Katalog: Apps verbinden und mit dem Team teilen. Standardmäßig ist es nicht geteilt. Teilst du es, zeigt FlowConnect vorher einen Warnhinweis, den du bestätigen musst: Teammitglieder mit MCP-Zugang nutzen dann deinen HeyGen-API-Schlüssel.
Kostenpflichtige Werkzeuge bleiben für dein Team gesperrt, auch wenn das Konto geteilt ist. Lesen ist sofort möglich. Erst wenn du in der Kontokarte Teammitglieder dürfen kostenpflichtige Werkzeuge nutzen anhakst, können Teammitglieder über dein Konto Videos erstellen, übersetzen und den Video Agent starten. Sie verbrauchen dann dein HeyGen-Guthaben. Den Haken kannst nur du setzen und jederzeit wieder entfernen.
- Ein geteiltes Konto nutzt der KI-Assistent für kostenpflichtige Werkzeuge nur, wenn er es ausdrücklich auswählt.
- Hebst du die Freigabe auf, verfällt auch die Erlaubnis für kostenpflichtige Werkzeuge. Teilst du das Konto später erneut, sind sie wieder gesperrt.
- Erneuerst du die Zugangsdaten mit einem neuen Schlüssel, endet die Teamfreigabe, weil jeder Schlüssel als eigenes Konto zählt. Teile das Konto danach bei Bedarf neu.
- Jede Nutzung durch ein Teammitglied wird protokolliert.
Zugriff für MCP-Schlüssel einschränken
Ein MCP-Schlüssel mit Vollzugriff erreicht HeyGen automatisch, sobald du HeyGen verbunden hast, auch wenn du den Schlüssel schon vorher angelegt hast. Soll ein Schlüssel HeyGen nicht nutzen, öffne unter MCP › MCP-Schlüssel beim Schlüssel Zugriff einschränken und entferne den Haken bei HeyGen. Ein eingeschränkter Schlüssel erreicht HeyGen umgekehrt erst, wenn du HeyGen dort nach dem Verbinden anhakst. Mehr zu Schlüsseln findest du unter API- und MCP-Schlüssel.
Datenschutz
Skripte, Texte für Vorlagen und die Adressen von Quellvideos gehen an HeyGen und werden dort nach den Bedingungen deines HeyGen-Kontos verarbeitet. FlowConnect speichert deinen API-Schlüssel verschlüsselt und speichert keine Videos.
Wenn etwas nicht klappt
- Schlüssel abgelehnt: Der Schlüssel ist falsch, abgelaufen oder wurde gelöscht. Prüfe ihn unter platform.heygen.com/api-keys.
- Zugangsdaten erneuern nötig: HeyGen lehnt den gespeicherten Schlüssel ab, zum Beispiel weil er gelöscht wurde, abgelaufen ist oder der Inhaber des Schlüssels keinen Zugriff mehr auf den Workspace hat. Lege einen neuen Schlüssel an und wähle im Kontomenü Zugangsdaten erneuern.
- Fehlende Berechtigung: Dem eingeschränkten Schlüssel fehlt ein Recht, zum Beispiel
videos:write. Lege bei HeyGen einen Schlüssel mit den Rechten von oben an und erneuere damit die Zugangsdaten. - Guthaben oder Limit reicht nicht: HeyGen hat den Auftrag abgelehnt, es wurde nichts erzeugt. Lade Guthaben auf oder erhöhe dein Ausgabenlimit. Meldet HeyGen ein erreichtes Nutzungslimit, hilft mehr Guthaben nicht, dann musst du das Limit bei HeyGen anheben.
- Zu viele Anfragen: HeyGen begrenzt, wie viele Anfragen und gleichzeitig laufende Aufträge möglich sind (bei Pay-as-you-go zum Beispiel zehn Aufträge gleichzeitig). Der KI-Assistent wartet dann die genannte Zeit ab.
- Ergebnis unklar: HeyGen hat beim Erstellen nicht rechtzeitig geantwortet. Der KI-Assistent kann denselben Auftrag mit derselben Kennung wiederholen. HeyGen liefert dann 24 Stunden lang die erste Antwort, statt ein zweites Video zu berechnen. Beim Video Agent gibt es diesen Schutz nicht, dort wiederholt der Assistent nichts.
Verbindung trennen
Öffne das Kontomenü auf der Seite HeyGen und wähle Trennen. FlowConnect löscht den gespeicherten Schlüssel, eine Teamfreigabe und die Erlaubnis für kostenpflichtige Werkzeuge enden. In HeyGen bleibt alles unverändert, auch deine Videos. Möchtest du den Schlüssel auch dort ungültig machen, lösche ihn unter platform.heygen.com/api-keys.