models

HeyGen: Avatar IV

Markdown · JSON

HeyGen: Avatar IV

Avatar IV animiert ein Foto zu einem lippensynchron sprechenden Video, dessen Mimik und Gestentiming von der Stimme geführt werden. HeyGen dokumentiert Abläufe mit Skript oder aufgenommenem Ton sowie Bewegungssteuerungen für Photo Avatars mit lebensechten oder stilisierten Moderationsfiguren.

Ü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 aus einem Standbild ein ausdrucksstarkes sprechendes Video erzeugt. Ihr von Diffusion inspiriertes Audio-to-Expression-Konzept nutzt Stimmlage, Rhythmus und Emotion, um Gesichtsbewegung, Kopfneigung, Pausen und Mikroausdrücke zu steuern. Ziel ist eine moderierende Person oder Figur, die gesprochene Inhalte mit Lippensynchronisation und Gestik vorträgt, statt eines allgemeinen Szenengenerators, der aus einem filmischen Prompt eine ganze Umgebung samt Tonspur erstellt.

Der Hersteller beschreibt Unterstützung für lebensechte und stilisierte Figuren, darunter schräge oder Profilansichten, Anime-Gesichter und Haustiere. Fotobasierte Figuren funktionieren am besten, wenn Augen, Mund und Gesichtsstruktur gut erkennbar sind. HeyGen empfiehlt ein klares, gut beleuchtetes Bild mit natürlicher Haltung und sichtbaren Händen, wenn Gesten wichtig sind. Ein sehr kleines Gesicht, verdeckte Lippen, starke Maskierung, ein ausgeprägter Schnabel oder stark übertriebene Proportionen können Gesichtsbewegung und Lippensynchronisation schwächen. Passen Sie den Quellbildausschnitt an die gewünschte Darbietung an.

Der Hersteller bietet zwei Spracheingabewege. Ein geschriebenes Skript wird mit einer gewählten Stimme kombiniert; eine vorab aufgenommene Tonspur liefert Stimme und Timing direkt. Nutzen Sie den aufgenommenen Ton, wenn die Darbietung bereits feststeht, und das Skript, wenn die Sprache synthetisiert werden soll. In der dokumentierten Schnittstelle sind diese Eingaben Alternativen. Bereiten Sie endgültigen Wortlaut, Namen und Aussprache vor der Animation vor und bewahren Sie Ton oder Skript zusammen mit dem zurückgegebenen Video auf, damit sich das gesprochene Ergebnis prüfen lässt.

HeyGens Avatar-IV-Modellprofil umfasst Studio-Avatare, Digital Twins, Photo Avatars, direkte Bilder und per Prompt erzeugte Motive. Ein wiederverwendbarer Photo Avatar liefert ein stabiles Motiv für spätere Videos; ein Ablauf mit direktem Bild beginnt mit der bereitgestellten Abbildung. Das Photo-Avatar-Profil des Herstellers bietet Freitext-Bewegungsanweisungen und Ausdrucksstärken high, medium oder low, standardmässig low. Behalten Sie bei einer Serie das gewählte Avatar-Aussehen und die Engine bei, damit ein geändertes Quellbild oder Rendering-Modell nicht zu einer unbemerkten Veränderung der moderierenden Person führt.

Beschreiben Sie für die Bewegungsregie eine sichtbare Körperhandlung und ihre emotionale Qualität. «Nickt sanft mit einem warmen Lächeln» gibt eine Geste und einen Gesichtsausdruck vor; eine kurze Begrüssung kann ein freundliches Winken verwenden. Der Hersteller empfiehlt eine Hauptgeste, optional mit Gesichtsausdruck, und für eine Abfolge höchstens zwei kurze Teilsätze. Avatar IV leitet das Tempo aus der Darbietung ab; der Studio-Leitfaden verlangt daher keinen sekundengenauen Gestenplan. Konkreter, knapper Wortlaut lässt sich leichter prüfen als mehrere konkurrierende Handlungen in einem Prompt.

Das Audio-to-Video-Profil des Herstellers rendert pro Anfrage bis zu dreissig Minuten bereitgestellten Ton; hochgeladene MP3- oder WAV-Dateien haben eine Grenze von 32 MB. Teilen Sie längere Lektionen oder Aufnahmen an zusammenhängenden Sprachgrenzen und erhalten Sie die ursprüngliche Reihenfolge. Das Sprachtiming des fertigen Videos sollte dem gewählten Ton folgen und nicht einer unabhängigen Schätzung der Cliplänge.

Die dokumentierten Ausgabeeinstellungen des Herstellers umfassen 720p oder 1080p und die Formate 16:9, 9:16, 4:5, 5:4 oder 1:1 sowie eine automatische Option, die den Quellproportionen folgt. Die Anpassung cover kann das Motiv beschneiden; contain zeigt das gesamte Motiv und kann umgebenden Hintergrund sichtbar lassen. Der Audio-to-Video-Ablauf gibt standardmässig MP4 zurück. Bei Video-Avataren erfordert transparentes WebM die Unterstützung für Freistellung; der Hersteller entfernt dafür den Hintergrund, statt dies mit einem neuen Hintergrund zu kombinieren. Prüfen Sie tatsächlichen Bildausschnitt und Datei, bevor Sie die moderierende Person in eine grössere Komposition einsetzen.

Eine Schulungseinführung kann ein gut erkennbares Moderationsbild, eine knappe Erklärung und eine zurückhaltende Geste bei der wichtigen Anweisung verwenden. Ein Produkterklärvideo kann dasselbe Avatar-Aussehen beibehalten und das gesprochene Skript für verschiedene Funktionen ändern. Der Hersteller dokumentiert ausserdem optionale Untertiteldateien und eingebrannte Untertitel; prüfen Sie deren Wortlaut und Timing zusammen mit der Sprache. Das Rendering läuft in der Herstellerschnittstelle asynchron, weshalb Erstellungsantwort und fertiges Video unterschiedliche Ergebnisse sind. Bewahren Sie die fertige Aufnahme und ihren Abschlussstatus mit dem Aufgabenergebnis auf.

Avatar IV unterscheidet sich weiterhin von Avatar Vs referenzgesteuerter Bewegung und seinen separaten Studio-Voreinstellungen. Es unterscheidet sich auch von HeyGen Videos universeller Szenengenerierung und von einem interaktiven Live-Avatar-Gespräch. Prüfen Sie gerenderte Mundbewegung, sichtbare Hände, Mimik, Pausen und gesprochenen Wortlaut anhand des Ausgangsmaterials und gewünschten Tons. Bild, Haltung, Licht und Bewegungsanweisungen beeinflussen das Ergebnis; prüfen Sie die fotobasierte Animation als generierte Darbietung und bewahren Sie die gewählten Eingaben für spätere Überarbeitungen auf.

Ailoot Ultra · Videoerzeugung POST /v1/videos heygen/avatar-iv

heygen/avatar-iv

HeyGen /heygen/avatar-iv

Einstieg

Avatar IV animiert ein Foto zu einem lippensynchron sprechenden Video, dessen Mimik und Gestentiming von der Stimme geführt werden. HeyGen dokumentiert Abläufe mit Skript oder aufgenommenem Ton sowie Bewegungssteuerungen für Photo Avatars mit lebensechten oder stilisierten Moderationsfiguren.

Zulässige Eingaben
Text · Bilder · Audio · Video
Ergebnisse
Video

In Ailoot verfügbar · Eingaben und Methoden

Ailoot Ultra · Videoerzeugung POST /v1/videos
Eingabe
text, image, audio, video
Ausgabe
video
FeldTypAnforderungWerte und LimitsStandard
FeldmodelTypstringAnforderungErforderlichWerte und Limits
heygen/avatar-iv
Standard—
Feldinput_referencesTyparrayAnforderungErforderlichWerte und Limits
Mindestanzahl Elemente: 2
Maximale Anzahl Elemente: 2
Standard—
FeldpromptTypstringAnforderungOptionalWerte und LimitsStandard—
Methodenparameter und Lebenszyklus
ParameterVertrag
Parametercontent_typeVertragapplication/json
ParameterrequiredVertragmodel, input_references
Parametermaterial_typesVertragtext, image, audio, video
Parametermaterial_conditionsVertragVerwenden Sie tatsächliche Inhalts-URLs fertiggestellter, Ihnen zugeordneter Medienassets mit den zurückgegebenen Signaturen: eine Videoquelle für BFL oder je eine Bild- und Audioquelle für einen Avatar. Der Nachweis aus dem Quellbestand zu Eigentümer, Typ und Bytes ist erforderlich., Liefern Sie genau ein PNG/JPEG-Bildasset und ein WAV/MP3-Audioasset. Die Audiodaten umfassen höchstens 32000000 Bytes, die Dauer beträgt mehr 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.

KonfigurationTarifstaffelPrognostizierte MengeAbrechnungseinheitAbrechnungsbedingungenGebühr
KonfigurationToken-BasistarifeTarifstaffelGrundtarifPrognostizierte Menge—Abrechnungseinheit—Abrechnungsbedingungen—Gebühr
Eingabe · Eingabetoken · Schätzung nur zum Vergleich — / 1K Tokens
Ausgabe · Ausgabetoken · Schätzung nur zum Vergleich — / 1K Tokens
Eingabe · Cache lesen · Schätzung nur zum Vergleich — / 1K Tokens
Eingabe · Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens
Eingabe · Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens
KonfigurationVideopreisTarifstaffel—Prognostizierte Menge—Abrechnungseinheitpro VideosekundeAbrechnungsbedingungenIn diesem Preisschlüssel ist keine zusätzliche Bedingung angegeben.Gebühr
Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.1 pro Videosekunde
KonfigurationGeschätzte ErzeugungskostenTarifstaffel—Prognostizierte MengeSchätzung für eine GenerierungAbrechnungseinheit—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 abschliessenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →

Beispielanfragen

Ailoot Ultra · Videoerzeugung

Echte Eingabedaten verwenden und das vollständige Ergebnis speichern
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 · Videoerzeugung

  • GET /v1/videos/{request_id}
  • GET /v1/videos/{request_id}/content
Alle fertiggestellten Dateien speichern
GET · Alle fertiggestellten Dateien
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 und die tatsächlich zurückgegebene id/polling_url auf. Setzen Sie den ursprünglichen Auftrag fort; reichen Sie die Erstellung nicht erneut ein.

Antwortfelder
FeldTyp
FeldidTyp
FeldstatusTyp
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

heygen/avatar-iv

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

Weitere Details

Verbinden Sie Ailoot mit Claude Code, OpenCode, Hermes oder Ihrer eigenen Anwendung.

Das Unternehmen und sein Projektportfolio

Das Unternehmen und sein Projektportfolio: Millionen von Kunden; monatliche Umsätze in Milliardenhöhe.

Tokens mit Rabatt kaufen.

Aborabatt für regelmäßige Arbeit. Aktionscodes bieten bis 50% beim Tokenkauf.

Abo
Wählen Sie einen Tarif mit Rabatt für Ihre regelmäßigen Anfragen.
Aktionscode bis 50%
Geben Sie den Code beim Kauf ein. Der Preis wird nach den gültigen Aktionsbedingungen berechnet.
Ausgaben in der Historie
Modell, Tokens und Betrag werden für jede Anfrage gespeichert.

Abo wählen · Modellpreise ansehen

Verbinden Sie die API mit dem Produkt, das Sie verkaufen.

SaaS, Anwendungen und Bots nach dem offiziellen Angebot und Lizenzvertrag von Ailoot. Fordern Sie für den Weiterverkauf eine Reseller-Lizenz an.

Kommerzielle Anwendung
Integrieren Sie Text-, Bild-, Video- und Audioerzeugung in kostenpflichtige Funktionen Ihres Dienstes.
Reseller-Lizenz
Senden Sie Projektbeschreibung und Zugangsmodell. Fordern Sie schriftliche Nutzungs- und Weiterverkaufsbedingungen an.
Dokumente auf der Website
Offizielles Angebot, Lizenzvertrag und Datenschutzerklärung sind vor der Verbindung zugänglich.

Reseller-Lizenz anfordern · Offizielles Angebot und Lizenzvertrag