Was macht HeyGen-Automation?
Automatisieren Sie KI-gestützte Videoproduktions-Workflows – durchsuchen Sie Avatare und Vorlagen, generieren Sie personalisierte Videos aus Vorlagen, verfolgen Sie den Verarbeitungsstatus und rufen Sie freigebbare URLs ab – alles orchestriert durch die Composio MCP-Integration.
Toolkit-Dokumentation: composio.dev/toolkits/heygen
Einrichtung
- Verbinden Sie Ihr HeyGen-Konto über den Composio MCP-Server unter
https://rube.app/mcp - Der Agent fordert Sie mit einem Authentifizierungslink auf, falls keine aktive Verbindung besteht
- Nach der Verbindung stehen alle
HEYGEN_*-Tools zur Ausführung bereit
Kern-Workflows
1. Verfügbare Vorlagen durchsuchen
Rufen Sie vorgefertigte Avatar-Vorlagen aus der HeyGen-Bibliothek für die Videoerstellung ab.
Tool: HEYGEN_V2_TEMPLATES
Keine Parameter erforderlich – gibt Vorlagen-IDs, Namen, Vorschaubilder und Anpassungsoptionen zurück.
Verwenden Sie dies, um Vorlagen zu entdecken, bevor Sie Videos generieren. Jede Vorlage hat eine eindeutige ID, die für die Generierung benötigt wird.
2. Vorlagendetails und Variablen überprüfen
Rufen Sie die vollständige Struktur einer Vorlage ab, einschließlich aller Variablen, Szenenzuordnungen und Anpassungsoptionen.
Tool: HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
template_id | string | Ja | Vorlagen-ID aus HEYGEN_V2_TEMPLATES oder dem HeyGen-Dashboard |
Dies ist eine erforderliche Voraussetzung vor der Videoerstellung – es gibt genau an, welche Variablen befüllt werden müssen.
3. Verfügbare Avatare durchsuchen
Listen Sie alle realistischen Avatare auf, die für die Videoerstellung verfügbar sind – nützlich, um Figuren Szenen zuzuordnen.
Tool: HEYGEN_V2_AVATARS
Keine Parameter erforderlich – gibt Avatar-IDs, Namen und Vorschaubilder zurück.
Die Liste kann paginiert sein; zusätzliche Aufrufe können für den vollständigen Satz erforderlich sein.
4. Video aus Vorlage generieren
Erstellen Sie ein personalisiertes Video, indem Sie eine Vorlage mit Ihren Variablen und Inhalten befüllen.
Tool: HEYGEN_V2_TEMPLATE_GENERATE
Geben Sie einen Videotitel und alle Vorlagenvariablen an, die über HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3 ermittelt wurden. Jede erforderliche Variable muss mit exakten Namen und Typen bereitgestellt werden.
5. Video-Verarbeitungsstatus prüfen
Fragen Sie den Verarbeitungsstatus ab und rufen Sie Metadaten für ein gerade generiertes Video ab.
Tool: HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
video_id | string | Ja | Video-ID, die von der Generierungs-API zurückgegeben wurde |
Die zurückgegebenen URLs laufen nach 7 Tagen ab, können aber durch erneuten Aufruf dieses Endpunkts regeneriert werden.
6. Teilbaren Video-URL abrufen
Erstellen Sie einen öffentlichen, teilbaren Link, mit dem jeder das Video ohne Authentifizierung ansehen kann.
Tool: HEYGEN_RETRIEVE_SHARABLE_VIDEO_URL
Geben Sie die video_id an, um eine öffentliche URL zur Verteilung zu erhalten.
Bekannte Fallstricke
| Fallstrick | Details |
|---|---|
| Alle Vorlagenvariablen erforderlich | HEYGEN_V2_TEMPLATE_GENERATE verlangt jede Variable aus HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3 mit exakten Namen und Typen – fehlende oder falsch benannte Felder führen zu defekten Szenen oder schlagen bei der Generierung fehl |
| Vorlagen zuerst überprüfen | Überspringen Sie HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3 niemals vor der Generierung – mehrszenige Vorlagen haben komplexe Variablenstrukturen |
| Video-URLs laufen ab | URLs von HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS laufen nach 7 Tagen ab; regenerieren Sie sie durch erneuten Aufruf des Endpunkts |
| Paginierte Avatar-Listen | HEYGEN_V2_AVATARS kann paginierte Ergebnisse zurückgeben – zusätzliche Aufrufe können für die vollständige Bibliothek erforderlich sein |
| Verarbeitungszeit variiert | Die Videogenerierung erfolgt asynchron; fragen Sie HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS ab, bis der Status abgeschlossen ist, bevor Sie Ausgabe-URLs verwenden |
Kurzreferenz
| Tool-Slug | Zweck |
|---|---|
HEYGEN_V2_TEMPLATES | Verfügbare Videovorlagen auflisten |
HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3 | Vorlagenvariablen und Szenenstruktur abrufen |
HEYGEN_V2_AVATARS | Verfügbare KI-Avatare durchsuchen |
HEYGEN_V2_TEMPLATE_GENERATE | Video aus einer Vorlage generieren |
HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS | Video-Verarbeitungsstatus prüfen und URLs abrufen |
HEYGEN_RETRIEVE_SHARABLE_VIDEO_URL | Öffentlichen, teilbaren Video-Link abrufen |
Bereitgestellt von Composio