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.
", "aboutText": "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.\n\nDer 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.\n\nDer 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.\n\nHeyGens 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.\n\nBeschreiben 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.\n\nDas 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.\n\nDie 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.\n\nEine 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.\n\nAvatar 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.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "b7f7da7381fabbd860b3771f3bb0d93065362d779ac538bb9f02c322343054c7", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "de", "methods": [ { "html": "heygen/avatar-ivAvatar 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.
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.
POST /v1/videostext, image, audio, videovideo| 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— |
| 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
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.
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 →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_INPUT_REFERENCES_JSON:?Set the actual documented input value}"\nexport AILOOT_INPUT_REFERENCES_JSON\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nrequest={'model': 'heygen/avatar-iv', 'input_references': '${ACTUAL_OWNED_INPUT_REFERENCES}'}\nrequest['input_references']=json.loads(os.environ['AILOOT_INPUT_REFERENCES_JSON'])\nPath('request.json').write_text(json.dumps(request,ensure_ascii=False),encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o response.bin\n# Retain the complete response and headers, every actual output, original returned identifiers and all usage fields. Recover the original operation without submitting creation again.\nGET /v1/videos/{request_id}GET /v1/videos/{request_id}/contentset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"\nexport AILOOT_STATUS_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\nfrom urllib.parse import urlsplit,urljoin\nf=Path(os.environ["AILOOT_STATUS_FILE"])\nif not f.is_file():raise SystemExit("Choose the actual completed status file")\nr=json.loads(f.read_text())\nif 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")\nurls=[]\nfor x in r["data"]:\n if not isinstance(x,str) or "\\n" in x or "\\r" in x:raise SystemExit("Invalid asset path")\n u=urljoin("https://api.ailoot.ai",x)\n z=urlsplit(u)\n 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")\n urls.append(u)\nPath("asset-urls.txt").write_text("\\n".join(urls)+"\\n")\nPY_REQUEST\nindex=0\nwhile IFS= read -r asset_url; do\n curl --fail-with-body --silent --show-error "$asset_url" \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"\n index=$((index + 1))\ndone < asset-urls.txt\nSpeichern 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.
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.
| Feld | Typ |
|---|---|
Feldid | Typ |
Feldstatus | Typ |
Felddata[] | Typ |
Feldoutputs[] | Typ |
Ailoot Ultra heygen/avatar-iv
Verwenden Sie die oben angezeigten Methodenpfade.