Was macht Video erstellen?
Generiere komplette Videos aus einer Textbeschreibung. Beschreibe, was du möchtest, und die KI übernimmt automatisch Drehbuch, Avatar-Auswahl, Visuals, Voiceover, Timing und Untertitel.
Authentifizierung
Alle Anfragen benötigen den X-Api-Key-Header. Setze die Umgebungsvariable HEYGEN_API_KEY.
curl -X POST "https://api.heygen.com/v1/video_agent/generate" \
-H "X-Api-Key: $HEYGEN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "Erstelle ein 60-sekündiges Produkt-Demo-Video."}'
Tool-Auswahl
Wenn HeyGen-MCP-Tools verfügbar sind (mcp__heygen__*), bevorzuge sie gegenüber direkten HTTP-API-Aufrufen – sie verwalten Authentifizierung und Anfrageformatierung automatisch.
| Aufgabe | MCP-Tool | Fallback (Direkte API) |
|---|---|---|
| Video aus Prompt generieren | mcp__heygen__generate_video_agent | POST /v1/video_agent/generate |
| Videostatus prüfen / URL abrufen | mcp__heygen__get_video | GET /v2/videos/{video_id} |
| Konto-Videos auflisten | mcp__heygen__list_videos | GET /v2/videos |
| Video löschen | mcp__heygen__delete_video | DELETE /v2/videos/{video_id} |
Falls keine HeyGen-MCP-Tools verfügbar sind, verwende direkte HTTP-API-Aufrufe, wie in den Referenzdateien dokumentiert.
Standard-Workflow
Verwende immer die Richtlinien aus prompt-optimizer.md, um Prompts mit Szenen, Zeitangaben und visuellen Stilen zu strukturieren.
Mit MCP-Tools:
- Schreibe einen optimierten Prompt mithilfe von prompt-optimizer.md → visual-styles.md
- Rufe
mcp__heygen__generate_video_agentmit Prompt und Konfiguration auf (duration_sec, orientation, avatar_id) - Rufe
mcp__heygen__get_videomit der zurückgegebenen video_id auf, um den Status abzufragen und die Download-URL zu erhalten
Ohne MCP-Tools (direkte API):
- Schreibe einen optimierten Prompt mithilfe von prompt-optimizer.md → visual-styles.md
POST /v1/video_agent/generate– siehe video-agent.mdGET /v2/videos/<id>– siehe video-status.md
Kurzreferenz
| Aufgabe | MCP-Tool | Lese |
|---|---|---|
| Video aus Prompt generieren | mcp__heygen__generate_video_agent | prompt-optimizer.md → visual-styles.md → video-agent.md |
| Videostatus prüfen / Download-URL abrufen | mcp__heygen__get_video | video-status.md |
| Referenzdateien für Prompt hochladen | — | assets.md |
Wann diese Fähigkeit vs. Avatar-Video verwenden
Diese Fähigkeit ist für Prompt-basierte Videoerstellung gedacht – beschreibe, was du möchtest, und die KI erledigt den Rest.
Wenn der Benutzer präzise Kontrolle über bestimmte Avatare, exakte Drehbücher, szenenspezifische Sprach-/Hintergrundkonfiguration oder Multi-Szenen-Komposition benötigt, verwende stattdessen die Avatar-Video-Fähigkeit.
| Benutzer sagt | Diese Fähigkeit | Avatar-Video-Fähigkeit |
|---|---|---|
| „Mach mir ein Video über X“ | ✓ | |
| „Erstelle eine Produkt-Demo“ | ✓ | |
| „Ich möchte, dass Avatar Y genau Z sagt“ | ✓ | |
| „Multi-Szenen-Video mit verschiedenen Hintergründen“ | ✓ | |
| „Transparentes WebM zum Compositing“ | ✓ |
Referenzdateien
Kern-Workflow
- references/prompt-optimizer.md – Effektive Prompts schreiben (Kern-Workflow + Regeln)
- references/visual-styles.md – 20 benannte visuelle Stile mit vollständigen Spezifikationen
- references/prompt-examples.md – Vollständiges Produktions-Prompt-Beispiel + gebrauchsfertige Vorlagen
- references/video-agent.md – Details zum Video-Agent-API-Endpunkt
Grundlagen
- references/video-status.md – Polling-Muster und Download-URLs
- references/webhooks.md – Webhook-Endpunkte und Ereignisse
- references/assets.md – Hochladen von Bildern, Videos, Audio als Referenzen
- references/dimensions.md – Auflösung und Seitenverhältnisse
- references/quota.md – Creditsystem und Nutzungslimits
Best Practices
- Optimiere deinen Prompt – Der Unterschied zwischen mittelmäßigen und professionellen Ergebnissen hängt vollständig von der Prompt-Qualität ab. Verwende immer den Prompt-Optimizer
- Gib die Dauer an – Verwende
config.duration_secfür eine vorhersagbare Länge - Avatar bei Bedarf festlegen – Verwende
config.avatar_idfür Konsistenz über Videos hinweg - Referenzdateien hochladen – Hilf dem Agenten, deine Marke/dein Produkt zu verstehen
- Auf Prompts iterieren – Verfeinere basierend auf Ergebnissen; der Video-Agent eignet sich hervorragend für schnelle Iterationen