Dokumentation

HeyGen (Video)

Avatar-Videos erzeugen, ein Video mit Lippensynchronität synchronisieren, einen Schnitt dem Video Agent überlassen, eine Stimme klonen oder einen Avatar erstellen — aus einer Pipeline, auf Ihrem HeyGen-Konto.

HeyGen (Video)

Die HeyGen-Integration bringt Video in Ihre Pipelines: Avatar-Videos aus einem Skript, Synchronisation in eine andere Sprache, synthetische Stimmen. Es ist Ihr HeyGen-Konto: HeyGen rechnet direkt mit Ihnen ab, betool fügt weder Metering noch Marge hinzu.

Was Sie damit tun können

KnotenWirkung
heygen_generate_videoAvatar-Video aus einem Skript: Avatar, Stimme, Format (16:9, 9:16, 1:1…), Auflösung bis 4K, Geschwindigkeit, Untertitel
heygen_translate_videoSynchronisation eines Videos in eine andere Sprache, mit Lippensynchronität; SRT-Untertitel optional
heygen_video_agentDer Video Agent von HeyGen schreibt und schneidet das Video anhand einer einzigen Anweisung
heygen_generate_speechNur synthetische Stimme, ohne Avatar
heygen_clone_voiceStimmklonen anhand einer Aufnahme
heygen_create_avatarAvatar-Erstellung — Foto, digitaler Zwilling (digital twin) oder per Anweisung beschriebener Avatar
heygen_video_statusVerfolgung eines Videos im Rendering und Abruf des Mediums, sobald es fertig ist

Ein Video-Rendering braucht Zeit: Ein Knoten wartet eine konfigurierbare Frist und gibt dann die Kontrolle zurück. Um am Ende des Renderings benachrichtigt zu werden, deklarieren Sie den Empfänger heygen_inbound am Start eines Modells: HeyGen ruft ihn auf, wenn ein Video fertig ist, die Signatur wird geprüft und Duplikate werden verworfen. Ohne Webhook kann eine geplante Pipeline heygen_video_status abfragen.

Die von HeyGen abgerechneten Knoten werden nur einmal ausgeführt, auch bei einer Wiederholung: Ein Video wird nie zweimal bezahlt.

Einwilligung. Die Stimme einer realen Person zu klonen oder ihren Avatar zu erstellen, begründet Ihre Verantwortung: Sie müssen über ihre Einwilligung verfügen. Deshalb gibt es diese beiden Operationen nur als Knoten, die von einem Designer gesetzt werden — kein Tool erlaubt es einem Agenten, sie eigenständig auszulösen.

Agenten-Tools

  • Lesen: heygen.list_avatars, heygen.list_voices, heygen.list_translation_languages, heygen.get_account, heygen.get_video, heygen.get_translation.
  • Schreiben: heygen.generate_video, heygen.generate_speech, heygen.translate_video.

Verbindung

  1. Einstellungen → Services → HeyGen, Reiter Konten.
  2. Zwei Modi:
    • „Mit HeyGen anmelden“ — OAuth 2.0 mit PKCE, ohne Umgang mit einem Schlüssel (verfügbar, wenn der Betreiber der Plattform es aktiviert hat);
    • API-Schlüssel Ihres HeyGen-Kontos (BYO), mit Standard-Avatar und -Stimme.

Anwendungsfälle

  • Personalisiertes Video — ein qualifizierter Lead erhält ein kurzes Avatar-Video, das seinen Vornamen und seinen Bedarf aufgreift.
  • Lokalisierung — ein Produktvideo, in mehrere Sprachen synchronisiert, eine Sprache pro Knoten.

Video läuft über diese Knoten, nicht über den Telefoniekanal, der reines Audio bleibt.