Video erstellen
Generieren Sie vollständige Videos aus einer Textbeschreibung. Beschreiben Sie, was Sie möchten, und die KI übernimmt Skripterstellung, Avatarauswahl, visuelle Gestaltung, Sprachausgabe, Tempo und Untertitel automatisch.
Authentifizierung
Alle Anfragen benötigen den Header X-Api-Key. Setzen Sie 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": "Erstellen Sie ein 60-sekundiges Produktdemovideo."}'
Tool-Auswahl
Wenn HeyGen MCP-Tools verfügbar sind (mcp__heygen__*), bevorzugen Sie diese gegenüber direkten HTTP-API-Aufrufen – sie verwalten Authentifizierung und Anforderungsformatierung 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} |
| Account-Videos auflisten | mcp__heygen__list_videos | GET /v2/videos |
| Ein Video löschen | mcp__heygen__delete_video | DELETE /v2/videos/{video_id} |
Wenn keine HeyGen MCP-Tools verfügbar sind, verwenden Sie direkte HTTP-API-Aufrufe wie in den Referenzdateien dokumentiert.
Standard-Arbeitsablauf
Verwenden Sie stets die Richtlinien aus prompt-optimizer.md, um Prompts mit Szenen, Timing und visuellen Stilen zu strukturieren.
Mit MCP-Tools:
- Schreiben Sie einen optimierten Prompt unter Verwendung von prompt-optimizer.md → visual-styles.md
- Rufen Sie
mcp__heygen__generate_video_agentmit Prompt und Konfiguration auf (duration_sec, orientation, avatar_id) - Rufen Sie
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):
- Schreiben Sie einen optimierten Prompt unter Verwendung 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 | Lesen Sie |
|---|---|---|
| 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 im Vergleich zu Avatar-Videos verwenden
Diese Fähigkeit dient der Prompt-basierten Videoerstellung – beschreiben Sie, was Sie möchten, und die KI erledigt den Rest.
Wenn der Benutzer präzise Kontrolle über bestimmte Avatare, exakte Skripte, szenenspezifische Sprach-/Hintergrundkonfiguration oder mehrteilige Szenenkomposition benötigt, verwenden Sie stattdessen die Avatar-Video-Fähigkeit.
| Benutzer sagt | Diese Fähigkeit | Avatar-Video-Fähigkeit |
|---|---|---|
| „Mach mir ein Video über X“ | ✓ | |
| „Erstelle eine Produktdemo“ | ✓ | |
| „Ich möchte, dass Avatar Y genau Z sagt“ | ✓ | |
| „Mehrteiliges Video mit verschiedenen Hintergründen“ | ✓ | |
| „Transparentes WebM für 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 – Abfragemuster und Download-URLs
- references/webhooks.md – Webhook-Endpunkte und Ereignisse
- references/assets.md – Hochladen von Bildern, Videos, Audio als Referenzen
- references/dimensions.md – Auflösungen und Seitenverhältnisse
- references/quota.md – Guthabensystem und Nutzungslimits
Best Practices
- Optimieren Sie Ihren Prompt – Der Unterschied zwischen mittelmäßigen und professionellen Ergebnissen hängt vollständig von der Prompt-Qualität ab. Verwenden Sie immer den Prompt-Optimierer.
- Dauer angeben – Verwenden Sie
config.duration_secfür eine vorhersagbare Länge. - Avatar bei Bedarf festlegen – Verwenden Sie
config.avatar_idfür Konsistenz über mehrere Videos hinweg. - Referenzdateien hochladen – Helfen Sie dem Agenten, Ihre Marke/Ihr Produkt zu verstehen.
- Mit Prompts iterieren – Verfeinern Sie sie basierend auf Ergebnissen; der Video Agent eignet sich hervorragend für schnelle Iterationen.