Avatar-Video
Erstellen Sie KI-Avatar-Videos mit voller Kontrolle über Avatare, Stimmen, Skripte, Szenen und Hintergründe. Erstellen Sie Einzel- oder Multi-Szenen-Videos mit genauer Konfiguration über die HeyGen /v2/video/generate API.
Authentifizierung
Alle Anfragen benötigen den X-Api-Key Header. Setzen Sie die Umgebungsvariable HEYGEN_API_KEY.
curl -X GET "https://api.heygen.com/v2/avatars" \
-H "X-Api-Key: $HEYGEN_API_KEY"
Tool-Auswahl
Wenn HeyGen MCP-Tools verfügbar sind (mcp__heygen__*), bevorzugen Sie diese gegenüber direkten HTTP-API-Aufrufen – sie übernehmen die Authentifizierung und Anforderungsformatierung automatisch.
| Aufgabe | MCP-Tool | Fallback (Direkte API) |
|---|---|---|
| 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} |
Die Video-Generierung (POST /v2/video/generate) sowie die Auflistung von Avataren und Stimmen werden über direkte API-Aufrufe durchgeführt – siehe Referenzdateien unten.
Standard-Workflow
- Avatare auflisten –
GET /v2/avatars→ Avatar auswählen, Vorschau anzeigen,avatar_idunddefault_voice_idnotieren. Siehe avatars.md - Stimmen auflisten (falls nötig) –
GET /v2/voices→ Eine Stimme auswählen, die zum Geschlecht/Sprache des Avatars passt. Siehe voices.md - Das Skript schreiben – Szenen mit jeweils einem Konzept strukturieren. Siehe scripts.md
- Das Video generieren –
POST /v2/video/generatemit Avatar, Stimme, Skript und Hintergrund pro Szene. Siehe video-generation.md - Auf Fertigstellung warten –
GET /v2/videos/{video_id}bis der Statuscompletedist. Siehe video-status.md
Kurzreferenz
| Aufgabe | Lesen Sie |
|---|---|
| Avatare auflisten und Vorschau anzeigen | avatars.md |
| Stimmen auflisten und auswählen | voices.md |
| Skripte schreiben und strukturieren | scripts.md |
| Video generieren (Einzel- oder Multi-Szene) | video-generation.md |
| Benutzerdefinierte Hintergründe hinzufügen | backgrounds.md |
| Untertitel hinzufügen | captions.md |
| Textüberlagerungen hinzufügen | text-overlays.md |
| Transparentes WebM-Video erstellen | video-generation.md (WebM-Abschnitt) |
| Vorlagen verwenden | templates.md |
| Avatar aus Foto erstellen | photo-avatars.md |
| Videostatus prüfen / herunterladen | video-status.md |
| Assets hochladen (Bilder, Audio) | assets.md |
| Mit Remotion verwenden | remotion-integration.md |
| Webhooks einrichten | webhooks.md |
Wann dieser Skill vs. Video erstellen verwendet wird
Dieser Skill ist für präzise Kontrolle – Sie wählen den Avatar, schreiben das exakte Skript, konfigurieren jede Szene.
Wenn der Benutzer einfach eine Videoidee beschreiben möchte und den Rest dem KI-Assistenten überlassen will (Skript, Avatar, Visuals), verwenden Sie stattdessen den Skill create-video.
| Benutzer sagt | Create Video Skill | Dieser Skill |
|---|---|---|
| "Erstelle ein Video über X" | ✓ | |
| "Erstelle eine Produktdemo" | ✓ | |
| "Ich möchte, dass Avatar Y genau Z sagt" | ✓ | |
| "Multi-Szenen-Video mit verschiedenen Hintergründen" | ✓ | |
| "Transparentes WebM für Compositing" | ✓ | |
| "Verwende diese spezifische Stimme für mein Skript" | ✓ | |
| "Generiere Videos im Batch mit genauen Spezifikationen" | ✓ |
Referenzdateien
Kern-Videoerstellung
- references/avatars.md – Avatare auflisten, Stile, avatar_id-Auswahl
- references/voices.md – Stimmen auflisten, Locales, Geschwindigkeit/Tonhöhe
- references/scripts.md – Skripte schreiben, Pausen, Tempo
- references/video-generation.md – POST /v2/video/generate und Multi-Szenen-Videos
Video-Anpassung
- references/backgrounds.md – Einfarbige, Bild- und Videohintergründe
- references/text-overlays.md – Text mit Schriftarten und Positionierung hinzufügen
- references/captions.md – Automatisch generierte Untertitel
Erweiterte Funktionen
- references/templates.md – Vorlagen auflisten und Variablen ersetzen
- references/photo-avatars.md – Avatare aus Fotos erstellen
- references/webhooks.md – Webhook-Endpunkte und Ereignisse
Integration
- references/remotion-integration.md – HeyGen in Remotion-Kompositionen verwenden
Grundlagen
- references/video-status.md – Polling-Muster und Download-URLs
- references/assets.md – Bilder, Videos, Audio hochladen
- references/dimensions.md – Auflösung und Seitenverhältnisse
- references/quota.md – Guthabensystem und Nutzungslimits
Best Practices
- Avatare vor der Generierung in der Vorschau anzeigen –
preview_image_urlherunterladen, damit der Benutzer den Avatar sehen kann, bevor er sich festlegt - Standardstimme des Avatars verwenden – Die meisten Avatare haben eine
default_voice_id, die für natürliche Ergebnisse vorab abgestimmt ist - Fallback: Geschlecht manuell abgleichen – Wenn keine Standardstimme vorhanden ist, sicherstellen, dass die Geschlechter von Avatar und Stimme übereinstimmen
- Testmodus für die Entwicklung verwenden –
test: truesetzen, um Guthaben zu sparen (Ausgabe wird mit Wasserzeichen versehen) - Großzügige Timeouts setzen – Die Videogenerierung dauert oft 5-15 Minuten, manchmal länger
- Eingaben validieren – Vor der Generierung prüfen, ob Avatar- und Stimmen-IDs existieren