HeyGen: Avatar IV
Avatar IV animiert ein Foto zu einem lippensynchronen Sprechvideo, bei dem die Stimme Mimik und Gesten-Timing steuert. HeyGen dokumentiert Abläufe mit Skript oder aufgezeichneter Audiospur sowie Bewegungssteuerungen für Photo Avatars mit lebensechten oder stilisierten Präsentierenden.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Avatar IV ist HeyGens Avatar-Engine, die ein Standbild in ein ausdrucksstarkes Sprechvideo verwandelt. Ihr von Diffusionsmodellen inspiriertes Audio-to-Expression-Design nutzt Stimmklang, Rhythmus und Emotion, um Gesichtsbewegungen, Kopfneigungen, Pausen und Mikroexpressionen zu steuern. Sie dient dazu, eine präsentierende Person oder Figur gesprochene Inhalte mit Lippensynchronität und Gesten vortragen zu lassen, und ist kein allgemeiner Szenengenerator, der aus einem filmischen Prompt eine vollständige Umgebung samt Tonspur erzeugt.
Der Hersteller beschreibt die Unterstützung lebensechter und stilisierter Figuren, darunter Bilder aus schrägem Winkel oder im Profil, Gesichter im Anime-Stil und Haustiere. Fotobasierte Figuren funktionieren am besten, wenn Augen, Mund und Gesichtsstruktur klar zu erkennen sind. HeyGen empfiehlt ein scharfes, gut ausgeleuchtetes Bild mit natürlicher Haltung und sichtbaren Händen, sofern Gesten wichtig sind. Ein sehr kleines Gesicht, verdeckte Lippen, schwere Masken, ein ausgeprägter Schnabel oder stark überzeichnete Proportionen können Gesichtsbewegungen und Lippensynchronität beeinträchtigen. Passen Sie den Ausgangsbildausschnitt an die gewünschte Darbietung an.
Der Anbieter stellt zwei Wege für die Spracheingabe bereit. Ein geschriebenes Skript wird mit einer ausgewählten Stimme kombiniert; eine vorab aufgenommene Audiospur liefert Stimme und Timing direkt. Nutzen Sie den Weg über eine Aufnahme, wenn die Sprechweise bereits feststeht, und den Skriptweg, wenn die Sprache synthetisiert werden soll. In der dokumentierten Schnittstelle sind diese Eingaben Alternativen. Bereiten Sie den endgültigen Wortlaut, Namen und Aussprache vor der Animation vor und bewahren Sie Audio oder Skript gemeinsam mit dem zurückgegebenen Video auf, damit sich das gesprochene Ergebnis prüfen lässt.
HeyGens Modellprofil für Avatar IV umfasst Studio-Avatare, Digital Twins, Photo Avatars, direkt bereitgestellte Bilder und per Prompt erzeugte Motive. Ein wiederverwendbarer Photo Avatar stellt ein gleichbleibendes Motiv für spätere Videos bereit, während ein Ablauf mit Direktbild vom bereitgestellten Bild ausgeht. Das Photo-Avatar-Profil des Anbieters bietet frei formulierte Bewegungsanweisungen und die Ausdrucksstärken high, medium oder low, wobei low die Standardeinstellung ist. Behalten Sie bei einer Serie den gewählten Avatar-Look und die Engine bei, damit ein anderes Ausgangsbild oder Rendering-Modell nicht unbemerkt auch die präsentierende Person verändert.
Beschreiben Sie zur Bewegungssteuerung eine sichtbare Körperaktion und deren emotionale Qualität. „Nickt sanft mit einem warmen Lächeln“ benennt eine Geste und einen Gesichtsausdruck; für einen kurzen Gruß eignet sich ein freundliches Winken. Der Hersteller empfiehlt eine Hauptgeste, die optional mit einer Mimik kombiniert wird, und höchstens zwei kurze Teilsätze für eine Abfolge. Avatar IV leitet das Tempo aus der Darbietung ab. Der Studio-Leitfaden verlangt daher keinen sekundengenauen Gestenplan. Eine konkrete, knappe Formulierung lässt sich leichter überprüfen als mehrere konkurrierende Aktionen in einem Prompt.
Das Audio-to-Video-Profil des Anbieters verarbeitet pro Anfrage bis zu dreißig Minuten bereitgestelltes Audio; für hochgeladene MP3- oder WAV-Assets gilt eine Grenze von 32 MB. Teilen Sie längere Lektionen oder Aufnahmen an inhaltlich sinnvollen Sprachgrenzen auf und bewahren Sie die ursprüngliche Reihenfolge. Das Sprechtiming des fertigen Videos sollte dem ausgewählten Audio folgen und nicht einer davon unabhängigen Schätzung der Cliplänge.
Die dokumentierten Ausgabeeinstellungen des Anbieters umfassen 720p oder 1080p und die Formate 16:9, 9:16, 4:5, 5:4 oder 1:1 sowie eine automatische Option, die dem Seitenverhältnis der Quelle folgt. Die Einpassung cover kann das Motiv beschneiden; contain zeigt das ganze Motiv und lässt gegebenenfalls den umgebenden Hintergrund sichtbar. Der Audio-to-Video-Ablauf gibt standardmäßig MP4 zurück. Bei Video-Avataren erfordert eine transparente WebM-Ausgabe Unterstützung für Matting. Dafür entfernt der Anbieter den Hintergrund, statt dies mit einem neuen Hintergrund zu kombinieren. Prüfen Sie den tatsächlichen Bildausschnitt und die Datei, bevor Sie die präsentierende Person in eine größere Komposition einsetzen.
Eine Schulungseinführung kann ein gut erkennbares Bild der präsentierenden Person, eine knappe Erklärung und eine zurückhaltende Geste an der entscheidenden Anweisung verwenden. Ein Produkt-Erklärvideo kann denselben Avatar-Look beibehalten und für verschiedene Funktionen nur das gesprochene Skript ändern. Der Anbieter dokumentiert außerdem optionale Untertiteldateien und eingebrannte Untertitel. Prüfen Sie deren Wortlaut und Timing zusammen mit der Sprache. In der Herstellerschnittstelle erfolgt das Rendering asynchron. Die Antwort auf die Erstellungsanfrage und das fertige Video sind daher unterschiedliche Artefakte. Bewahren Sie die fertige Aufnahme und ihren Abschlussstatus zusammen mit dem Aufgabenergebnis auf.
Avatar IV unterscheidet sich weiterhin von Avatar Vs referenzgesteuerter Bewegung und dessen gesonderten Studio-Voreinstellungen. Ebenso unterscheidet es sich von der allgemeinen Szenengenerierung mit HeyGen Video und von interaktiven Gesprächen mit einem Live-Avatar. Prüfen Sie gerenderte Mundbewegungen, sichtbare Hände, Mimik, Pausen und gesprochenen Wortlaut anhand des Ausgangsmaterials und des gewünschten Tons. Bild, Pose, Beleuchtung und Bewegungsanweisungen beeinflussen das Ergebnis. Eine fotobasierte Animation sollte als generierte Darbietung geprüft werden, wobei die gewählten Eingaben für spätere Überarbeitungen erhalten bleiben.
Ailoot Ultra · Videogenerierung POST /v1/videos heygen/avatar-iv
heygen/avatar-ivStart
Avatar IV animiert ein Foto zu einem lippensynchronen Sprechvideo, bei dem die Stimme Mimik und Gesten-Timing steuert. HeyGen dokumentiert Abläufe mit Skript oder aufgezeichneter Audiospur sowie Bewegungssteuerungen für Photo Avatars mit lebensechten oder stilisierten Präsentierenden.
- Zulässige Eingaben
- Text · Bilder · Audio · Video
- Ergebnisse
- Video
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Videogenerierung POST /v1/videos
- Eingabetypen
text,image,audio,video- Ausgabetypen
video
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits heygen/avatar-iv | Standard— |
Feldinput_references | Typarray | AnforderungErforderlich | Werte und Limits Mindestanzahl Elemente: 2 Maximale Anzahl Elemente: 2 | Standard— |
Feldprompt | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, input_references |
Parametermaterial_types | Vertragtext, image, audio, video |
Parametermaterial_conditions | VertragVerwenden Sie tatsächliche Inhalts-URLs fertiggestellter, Ihnen zugeordneter Medienassets mit den zurückgegebenen Signaturen: eine Videoquelle für BFL oder eine Bild- und eine Audioquelle für den Avatar. Der Quellennachweis für Eigentümer, Typ und gespeicherte Bytes ist erforderlich., Geben Sie genau ein PNG/JPEG-Bildasset und ein WAV/MP3-Audioasset an. Die Audiodaten umfassen höchstens 32000000 Bytes bei einer Dauer größer als 0 und höchstens 1800 Sekunden. |
Lebenszyklus: asynchronous_job_then_owned_outputs
GET /v1/videos/{request_id} · Tatsächlich zurückgegebene id oder polling_url
GET /v1/videos/{request_id}/content
Tarife
So wird die endgültige Gebühr berechnet
Die angezeigten Tarife dienen zur Kostenschätzung vor der Generierung. Der endgültige Betrag wird aus den für die ursprüngliche Generierung erfassten Kosten berechnet. Die gemessene Ausgabedauer und prognostizierte Mengen sind nicht die endgültige abrechenbare Menge.
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Geschätzte Tarife zum Vergleich
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Prognostizierte Menge | Abrechnungseinheit | Abrechnungsbedingungen | Gebühr |
|---|---|---|---|---|---|
| KonfigurationBasistarife für Token | TarifstaffelGrundtarif | Prognostizierte Menge— | Abrechnungseinheit— | Abrechnungsbedingungen— | Gebühr Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Token Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Lesen · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben · Schätzung nur zum Vergleich — / 1K Token Eingabe · Cache-Schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Token |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Videosekunde | AbrechnungsbedingungenIn diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben. | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.1 pro Videosekunde |
| KonfigurationGeschätzte Generierungskosten | Tarifstaffel— | Prognostizierte MengeSchätzung für eine Generierung | Abrechnungseinheit— | Abrechnungsbedingungen— | Gebühr Ausgabe · Geschätzte Generierungskosten · Schätzung nur zum Vergleich $0.1 Schätzung vor der Generierung Diese Schätzung ist weder eine zusätzliche Gebühr noch ein fester Tarif für die abgeschlossene Generierung. |
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot Ultra · Videogenerierung
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"
export AILOOT_INPUT_REFERENCES_JSON
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
request={'model': 'heygen/avatar-iv', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}'}
request['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])
Path('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o response.bin
# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.
Ergebnisse abrufen und speichern
Ailoot Ultra · Videogenerierung
GET /v1/videos/{request_id}GET /v1/videos/{request_id}/content
Alle fertiggestellten Dateien speichern
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
Alle fertiggestellten Ergebnisse aufbewahren
Speichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.
Die vollständige Antwort und ihre Header, jede tatsächliche Ausgabe, die ursprünglich zurückgegebenen Kennungen und alle Nutzungsfelder aufbewahren. Den ursprünglichen Vorgang wiederaufnehmen, ohne die Erstellung erneut anzufordern.
Wenn die ursprüngliche Antwort geprüft werden muss
Bewahren Sie X-Client-Request-ID, X-Ailoot-Task-Id sowie die tatsächlich zurückgegebenen id/polling_url auf. Setzen Sie den ursprünglichen Auftrag fort; senden Sie die Erstellung nicht erneut.
Antwortfelder
| Feld | Typ |
|---|---|
Feldid | Typ |
Feldstatus | Typ |
Felddata[] | Typ |
Feldoutputs[] | Typ |
Aliasnamen
Modellaliasnamen
Ailoot Ultra heygen/avatar-iv
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · HeyGen: Avatar IV
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/videos·heygen/avatar-iv:text,image,audio,video→video- Welche Felder verwendet die Anfrage?
POST /v1/videos·heygen/avatar-iv:model,input_references,prompt