Source: https://ailoot.ai/models/de/heygen-heygen-video-1/
Canonical: https://ailoot.ai/models/de/heygen-heygen-video-1/
Language: de

# HeyGen: HeyGen Video

[Markdown](https://ailoot.ai/models/de/heygen-heygen-video-1/index.md) · [JSON](https://ailoot.ai/models/de/heygen-heygen-video-1/facts.json)

## [HeyGen: HeyGen Video](https://ailoot.ai/models/de/heygen-heygen-video-1/)

HeyGen Video erzeugt 5–15 Sekunden lange Szenen mit Dialog, Atmosphäre und Effekten aus Text, einem Anfangsbild oder visuellen und Audioreferenzen. Sein universelles Modell heygen-video-1 unterstützt Produkt- und Figurenaufnahmen mit Referenzsteuerung und MP4-Ausgabe. Klare, abgegrenzte Handlungen machen das Produktionsbriefing nützlich.

- [**Ailoot Ultra · Video** `POST /v1/videos` `heygen/heygen-video-1`](https://ailoot.ai/models/de/heygen-heygen-video-1/#method-0)

Ü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.

HeyGen Video ist HeyGens universelles Modell zur Szenengenerierung, das der Hersteller als heygen-video-1 bezeichnet. Es erzeugt Motiv, Umgebung, Licht und Ton gemeinsam aus einem kreativen Briefing. Jeder Clip ist 5–15 Sekunden lang und enthält eine generierte Tonspur mit Dialog, Umgebungsgeräuschen und Effekten. Als hilfreiche Produktionsvorlagen dienen eine Szenenbeschreibung, ein Produktfoto oder Material, das eine Person, einen Ort oder eine Bewegung vorgibt. Das Ergebnis ist eine kurze Szene für eine Produktpräsentation, einen Einschub in ein Onboarding-Video, eine Immobilienansicht oder andere Videoschnittarbeiten.

Drei Modi weisen den Eingaben unterschiedliche Rollen zu. Text-to-Video erzeugt eine Szene anhand des Prompts. Image-to-Video beginnt exakt mit dem bereitgestellten Bild und folgt anschließend dem Briefing für die Handlung. Reference-to-Video verwendet bereitgestellte Bilder, Videos und optional Audiodateien, um eine neu komponierte Szene anzuleiten; dafür ist mindestens ein Referenzbild oder -video erforderlich. Wählen Sie ein Startbild, wenn die Eröffnungskomposition einer bestimmten Aufnahme entsprechen muss, oder Referenzen, wenn ein bekanntes Objekt in einer anderen Komposition erscheinen soll. Dieses Szenenmodell unterscheidet sich von HeyGens Avatar-Rendering-Engines und dem Kompositionsablauf von Video Agent.

Der Leitfaden des Herstellers empfiehlt detaillierte, konkrete Anweisungen für die Einstellung: ein Motiv, ein Ort und eine in sich abgeschlossene Handlung mit einer festen oder sanft bewegten Kamera. Beschreiben Sie Kameraposition, Objektiv oder beabsichtigte Schärfentiefe, Licht, Oberflächentextur und Farbgestaltung. Erläutern Sie bei Handlungen mit Körper- oder Objektkontakt, wo sich die Objekte berühren. Für ein eigenständiges Produktbeispiel können Sie das Referenzfoto einer Thermosflasche verwenden und verlangen, dass sie auf einer Holztheke steht, während eine präsentierende Person daneben spricht und sich die Kamera leicht auf die Flasche zubewegt. Prüfen Sie im Ergebnis Form, Platzierung und sichtbare Kennzeichnungen der Flasche.

Referenzlisten unterstützen bis zu neun Bilder, drei Videos und drei Audiodateien, insgesamt jedoch höchstens zwölf Referenzen. Bilder, Videos und Audio werden im Prompt-Format des Herstellers getrennt nummeriert: Das erste Bild heißt \<Picture 1\>, das erste Video \<Video 1\>. Weisen Sie jeder Referenz eine Rolle zu und benennen Sie diese im Briefing ausdrücklich. Das Modell liest die ersten fünf Sekunden jedes Referenzvideos. Platzieren Sie den relevanten Abschnitt daher am Anfang. Die API-Referenz nennt außerdem Seitenverhältnisse von 1:4 bis 4:1 für Referenzvideos. Ein langer Clip, der die gewünschte Bewegung erst am Ende zeigt, ist für dieses fünfsekündige Eingabefenster schlecht vorbereitet.

Die dokumentierte Referenzschnittstelle akzeptiert eine direkt erreichbare HTTPS-Ressource, die Kennung eines hochgeladenen Assets oder inline eingebettete Base64-Daten. Der Leitfaden nennt maximale Bildgrößen von 16 MB per URL und 5 MB inline; Video- oder Audiodateien dürfen per URL bis zu 32 MB und inline bis zu 16 MB groß sein. Bereiten Sie gut erkennbares Ausgangsmaterial vor, in dem das wichtige Motiv leicht zu unterscheiden ist und verschiedene Referenzen keine widersprüchlichen Anweisungen enthalten. Behalten Sie im Startbild die gewünschte Ausrichtung bei. Diese Eingabedetails betreffen den Referenzablauf des Herstellers und helfen, das kreative Material für den gewählten Modus zu organisieren.

Beschreiben Sie den Ton im selben Briefing wie das Bild. Geben Sie Dialog, Sprechweise, Raumklang und konkrete Effekte an, einschließlich der Frage, ob ein Geräusch nah oder entfernt klingen soll. Legen Sie die gewünschte musikalische Gestaltung fest, wenn die Szene ausschließlich Sprache und Umgebungsgeräusche enthalten soll. Der Leitfaden empfiehlt als Planungswert ungefähr 2,5 gesprochene Wörter pro Sekunde. Lassen Sie deshalb Platz für Pausen und die sichtbare Handlung. Eine kurze Einführung lässt sich als ein Satz mit einer anschließenden Pause planen, in der das Produkt sichtbar wird. Hören Sie auf den tatsächlichen Wortlaut und darauf, ob der erzeugte Ton zu Raum und Handlung passt.

Die Ausgabedauer wird in ganzen Sekunden zwischen fünf und fünfzehn gewählt; standardmäßig beträgt sie fünf Sekunden. Die Auflösung ist eine Größenklasse: 480p, 768p, 1080p oder 2k. Die dokumentierten Bildformate sind 21:9, 16:9, 4:3, 1:1, 3:4 und 9:16. Wählen Sie für Text-to-Video und Reference-to-Video bei 1080p oder 2k entweder 16:9 oder 9:16; eine adaptive Anpassung an das Referenzformat ist für 480p und 768p dokumentiert. Image-to-Video übernimmt das Seitenverhältnis des ersten Bilds. Schneiden Sie es daher vor der Generierung zu, wenn ein anderes Format erforderlich ist. Prüfen Sie die tatsächlichen Abmessungen des fertigen Ergebnisses, statt anzunehmen, dass die Bezeichnung einer Größenklasse einem bestimmten üblichen Pixelpaar entspricht.

Der Modellleitfaden nennt MP4-Video mit H.264-Bildkodierung und AAC-Audio mit 32 kHz in Stereo. Eine Generierung wird asynchron verarbeitet; der abgeschlossene Auftrag liefert die Adresse des abspielbaren Videos sowie dessen Dauer und Abmessungen. Seine signierte Video-Adresse kann durch erneutes Abrufen des Auftrags aktualisiert werden. Bewahren Sie den eigentlichen Clip, die Referenzmaterialien und das Briefing für die Schnittprüfung auf. Ein Datensatz mit dem Status „pending“ oder „processing“ verfolgt die Generierung; das fertige Video ist das Produktionsartefakt, dessen Bild, Sprache und Ton zu beurteilen sind.

Der Hersteller dokumentiert die Optionen turbo, quality und disabled für die Prompt-Optimierung; disabled belässt die vorbereitete Formulierung unverändert. Ein fester Seed ist hilfreich, um die Änderung einer einzelnen Formulierung bei ansonsten gleichen Eingaben zu vergleichen. Halten Sie den gewählten Seed und die Einstellungen zusammen mit dem Einstellungsbriefing fest. Für Schrift im Bild sollten Sie die gewünschte Formulierung kurz halten und exakt buchstabieren. Der Leitfaden empfiehlt, Absätze, Kleingedrucktes und beschriftete Diagramme nachträglich einzufügen. Prüfen Sie bei einem generierten Titel jedes sichtbare Zeichen, statt eine korrekte Wiedergabe des Wortlauts vorauszusetzen.

Der Leitfaden nennt lange Bildschirmtexte, weiche organische Bewegungen von etwa Blütenblättern, Papier oder Haaren sowie detaillierte Handgriffe in Nahaufnahme als weniger zuverlässige Bereiche. Lassen Sie bei einer Verfahrensbeschreibung eine klar formulierte Zeile die Schritte vermitteln, während das Bild eine ruhig stehende Person oder ein stabiles Objekt zeigt. Verwenden Sie separat geprüfte Aufnahmen, wenn der körperliche Vorgang selbst exakt sein muss. Prüfen Sie die gesamte Einstellung auf Objektkontinuität, Kontakt, Gesichts- und Handdetails, Dialog und Ton. Eine knappe Liste der Änderungen für den nächsten Take hält ein ausführliches Produktionsbriefing praktikabel.

**Ailoot Ultra · Video** `POST /v1/videos` `heygen/heygen-video-1`

[`heygen/heygen-video-1`](https://ailoot.ai/models/de/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

HeyGen /`heygen/heygen-video-1`

### Start

HeyGen Video erzeugt 5–15 Sekunden lange Szenen mit Dialog, Atmosphäre und Effekten aus Text, einem Anfangsbild oder visuellen und Audioreferenzen. Sein universelles Modell heygen-video-1 unterstützt Produkt- und Figurenaufnahmen mit Referenzsteuerung und MP4-Ausgabe. Klare, abgegrenzte Handlungen machen das Produktionsbriefing nützlich.

Zulässige Eingaben

Text · Bilder · Audio · Video

Ergebnisse

Video

### In Ailoot verfügbar · Eingaben und Methoden

**Ailoot Ultra · Video** `POST /v1/videos`

Eingabetypen

`text`, `image`, `audio`, `video`

Ausgabetypen

`video`

Ausgabeformat

Originale MP4-Bytes; keine Normalisierung/Transkodierung

| Feld | Typ | Anforderung | Werte und Limits | Standard |
| --- | --- | --- | --- | --- |
| Feld`model` | Typ`string` | AnforderungErforderlich | Werte und Limits heygen/heygen-video-1 | Standard— |
| Feld`prompt` | Typ`string` | AnforderungErforderlich | Werte und Limits | Standard— |
| Feld`duration` | Typ`integer` | AnforderungErforderlich | Werte und Limits 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600 | Standard— |
| Feld`resolution` | Typ`string` | AnforderungOptional | Werte und Limits 480p, 768p, 2K | Standard— |
| Feld`aspect_ratio` | Typ`string` | AnforderungOptional | Werte und Limits 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Standard— |
| Feld`generate_audio` | Typ`boolean` | AnforderungOptional | Werte und Limits false | Standard— |
| Feld`frame_images` | Typ`array` | AnforderungOptional | Werte und Limits Mindestanzahl Elemente: 1 Maximale Anzahl Elemente: 1 Eingabeinhalt: Array von Frame-Objekten. Jedes Objekt enthält type=image\_url, image\_url mit url und frame\_type. Verwenden Sie eine HTTPS-Bild-URL und setzen Sie frame\_type auf first\_frame. Jede Frame-Rolle darf höchstens einmal vorkommen. Exakte Schlüssel: type, image\_url, frame\_type Bedingungen: Diese Schlüssel beschreiben jedes Frame-Objekt; image\_url enthält ausschließlich url. Lassen Sie frame\_images bei einer reinen Textanfrage weg. | Standard— |
| Feld`input_references` | Typ`array` | AnforderungOptional | Werte und Limits | Standard— |
| Feld`seed` | Typ`integer` | AnforderungOptional | Werte und Limits Minimum: -9.223.372.036.854.775.808 Maximum: 9.223.372.036.854.775.807 | Standard— |
| Feld`callback_url` | Typ`string` | AnforderungOptional | Werte und Limits Muster: ^https:// | Standard— |
| Feld`session_id` | Typ`string` | AnforderungOptional | Werte und Limits | Standard— |
| Feld`trace` | Typ`object` | AnforderungOptional | Werte und Limits | Standard— |
| Feld`user` | Typ`string` | AnforderungOptional | Werte und Limits | Standard— |

Kombinationen von Eingabematerialien

**Text zu Video** · Ein schriftlicher Prompt. · Erforderlich: model, prompt, duration

`Geben Sie prompt als Text und duration in ganzen Sekunden an. Wählen Sie eine unterstützte Auflösung und bei Bedarf ein Seitenverhältnis.`

`model`: Typ: string · heygen/heygen-video-1

`prompt`: Typ: string · Maximale Anzahl UTF-8-Bytes: 10.000 · Mindestens ein Zeichen außer Leerraum erforderlich: Ja

**Bild zu Video** · Ein schriftlicher Prompt und ein Bild für den ersten Frame. · Erforderlich: model, prompt, duration, frame\_images

`frame_images ist ein Array. Jedes Frame-Objekt enthält type, image_url und frame_type; image_url enthält url. Setzen Sie type auf image_url. Verwenden Sie first_frame. Jede Frame-Rolle darf höchstens einmal vorkommen. Geben Sie für jeden Frame eine öffentliche HTTPS-Bild-URL an. Wählen Sie eine unterstützte Auflösung und bei Bedarf ein Seitenverhältnis.`

Exakte Schlüssel: type, image\_url, frame\_type

`model`: Typ: string · heygen/heygen-video-1

`prompt`: Typ: string · Maximale Anzahl UTF-8-Bytes: 10.000 · Mindestens ein Zeichen außer Leerraum erforderlich: Ja

**Reference to video** · Ein schriftlicher Prompt und unterstützte Bild-, Video- und Audioreferenzen. · Erforderlich: model, prompt, duration, input\_references

`input_references ist ein Array von Objekten. Setzen Sie type auf image_url, video_url oder audio_url und verwenden Sie das dazu passende Feld mit url. Verwenden Sie öffentliche HTTPS-URLs. Lassen Sie frame_images weg, um den Referenzmodus auszuwählen. Wählen Sie eine unterstützte Auflösung und bei Bedarf ein Seitenverhältnis.`

`model`: Typ: string · heygen/heygen-video-1

`prompt`: Typ: string · Maximale Anzahl UTF-8-Bytes: 10.000 · Mindestens ein Zeichen außer Leerraum erforderlich: Ja

Methodenparameter und Lebenszyklus

| Parameter | Vertrag |
| --- | --- |
| Parameter`content_type` | Vertragapplication/json |
| Parameter`required` | Vertragmodel, prompt, duration |
| Parameter`material_types` | Vertragtext, image, audio, video |
| Parameter`additional_properties` | Vertragfalse |
| Parameter`optional_controls` | Vertragresolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, seed, callback\_url, session\_id, trace, user |

Lebenszyklus: `submit_once_poll_original`

`GET /v1/videos/{public_id}`

`GET /v1/videos/{public_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 | Abrechnungsbedingungenresolution: 2k | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich **$0.2** pro Videosekunde |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Videosekunde | Abrechnungsbedingungenresolution: 480p | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich **$0.04** pro Videosekunde |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Videosekunde | Abrechnungsbedingungenresolution: 768p | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich **$0.072** pro Videosekunde |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Videosekunde | AbrechnungsbedingungenGenerierungsmodus: reference; Auflösung: 2k | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich **$0.36** pro Videosekunde |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Videosekunde | AbrechnungsbedingungenGenerierungsmodus: reference; Auflösung: 480p | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich **$0.14** pro Videosekunde |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Videosekunde | AbrechnungsbedingungenGenerierungsmodus: reference; Auflösung: 768p | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich **$0.2** pro Videosekunde |
| KonfigurationEingabebild als Referenz | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Referenz-Eingabebild | Abrechnungsbedingungen— | Gebühr Eingabe · Eingabebild als Referenz · Schätzung nur zum Vergleich **$0.08** pro Referenz-Eingabebild |
| 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.2** 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 →](https://ailoot.ai/docs/de/billing/reserve/)

#### Details zum Referenztarif

Referenztarifstaffeln auf Modellebene ändern weder Methodenauswahl noch Kostenvoranschläge oder Gebühren. Für die aktive Abrechnung gelten die Tarife der ausgewählten Ailoot-Methode.

Preisreferenzen für Videokonfigurationen

#### Preise nach Konfiguration

Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.

| Konfiguration | Abrechnungsbedingungen | Gebühr |
| --- | --- | --- |
| KonfigurationVideopreis | Abrechnungsbedingungenresolution: 2k | Gebühr Ausgabe · Videopreis **$0.18** pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationVideopreis | Abrechnungsbedingungenresolution: 480p | Gebühr Ausgabe · Videopreis **$0.04** pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationVideopreis | Abrechnungsbedingungenresolution: 768p | Gebühr Ausgabe · Videopreis **$0.06** pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationVideopreis | AbrechnungsbedingungenGenerierungsmodus: reference; Auflösung: 2k | Gebühr Ausgabe · Videopreis **$0.36** pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationVideopreis | AbrechnungsbedingungenGenerierungsmodus: reference; Auflösung: 480p | Gebühr Ausgabe · Videopreis **$0.08** pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |
| KonfigurationVideopreis | AbrechnungsbedingungenGenerierungsmodus: reference; Auflösung: 768p | Gebühr Ausgabe · Videopreis **$0.12** pro Videosekunde Veröffentlichte Preisreferenz für die angezeigte Konfiguration. Die endgültige Abrechnung folgt der tatsächlich abgerechneten Konfiguration. |

### Beispielanfragen

#### Ailoot Ultra · Video

curl · Video erstellen

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"heygen/heygen-video-1","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', 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 result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

### Ergebnisse abrufen und speichern

#### Ailoot Ultra · Video

Signierte Inhalts-URLs der Ihnen zugeordneten Assets

- `GET /v1/videos/{public_id}`
- `GET /v1/videos/{public_id}/content`

##### Auftragsstatus prüfen

GET · Status des ursprünglichen Vorgangs

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

Abrufe anderer Inhalte

Jede fertiggestellte eigene Ausgabe speichern

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
```

##### Alle fertiggestellten Ergebnisse aufbewahren

Speichern Sie jedes fertiggestellte Video oder jede zurückgegebene Datei; rufen Sie jede tatsächlich zurückgegebene Datei-URL ab.

Bewahren Sie jede tatsächlich erzeugte, Ihnen zugeordnete Ausgabe samt den zurückgegebenen gemessenen Metadaten auf.

##### Wenn die ursprüngliche Antwort geprüft werden muss

503 result\_pending\_check + ursprüngliche ID + X-Should-Retry:false; ursprüngliche Anfrage niemals wiederholen

Antwortfelder

| Feld | Typ | Bedeutung |
| --- | --- | --- |
| Feld`index` | Typinteger | BedeutungBei null beginnende Position dieses Videos in der Ausgabeliste. |
| Feld`content_url` | Typstring | BedeutungSignierte HTTPS-Download-URL für dieses fertiggestellte Video. |
| Feld`sha256` | Typstring \| null | BedeutungSHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar. |
| Feld`size_bytes` | Typinteger \| null | BedeutungGröße der ursprünglichen Videodatei in Bytes; null, falls nicht verfügbar. |
| Feld`duration_ms` | Typinteger \| null | BedeutungGemessene Videodauer in Millisekunden; null, falls nicht verfügbar. |
| Feld`width` | Typinteger \| null | BedeutungVideobreite in Pixeln; null, falls nicht verfügbar. |
| Feld`height` | Typinteger \| null | BedeutungVideohöhe in Pixeln; null, falls nicht verfügbar. |
| Feld`video_codec` | Typstring \| null | BedeutungVideocodec-Kennung; null, falls nicht aufgezeichnet. |
| Feld`has_audio` | Typboolean \| null | BedeutungGibt an, ob das Video eine Audiospur enthält; null, falls nicht gemessen. |
| Feld`audio_codec` | Typstring \| null | BedeutungAudiocodec-Kennung; null, wenn keine Kennung aufgezeichnet wurde. |

Fehler und nächste Schritte

| Antwort | Bedingung | Nächster Schritt |
| --- | --- | --- |
| Antwort404 · `not_found_error` | BedingungDer Videozugriff ist nicht verfügbar, oder diese Video-ID wurde nicht gefunden. | Nächster SchrittPrüfen Sie den Videozugriff. Verwenden Sie für ein vorhandenes Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel. |
| Antwort401 · `authentication_error` | BedingungDer API-Schlüssel passt nicht zum authentifizierten Konto. | Nächster SchrittPrüfen Sie vor der Übermittlung Ihren API-Schlüssel und den Kontozugriff. |
| Antwort400 · `invalid_request_error` | BedingungDie Anfrage konnte nicht gelesen werden, oder der Downloadindex ist ungültig. | Nächster SchrittKorrigieren Sie den Anfrageinhalt. Wählen Sie für einen Download einen Ausgabeindex, den die ursprüngliche Aufgabe zurückgegeben hat. |
| Antwort422 · `price_unavailable` | BedingungFür die ausgewählte Videokonfiguration lässt sich kein Preis bestimmen. | Nächster SchrittWählen Sie eine unterstützte Videokonfiguration und ergänzen Sie die erforderlichen Optionen, bevor Sie eine korrigierte Anfrage senden. |
| Antwort422 · `invalid_request_error` | BedingungEine Videoeingabe oder die ursprüngliche Fortsetzungsaufgabe ist ungültig. | Nächster SchrittVerwenden Sie gültige HTTPS-Eingaben. Verwenden Sie für eine Fortsetzung die öffentliche Video-ID Ihres fertiggestellten Originals mit demselben API-Schlüssel. |
| Antwort402 · `billing_error` | BedingungDas verfügbare Guthaben oder die geltenden Limits lassen keine Reservierung zu. | Nächster SchrittPrüfen Sie Ihr verfügbares Guthaben und Ihre Limits, bevor Sie eine neue Anfrage senden. |
| Antwort503 · `server_error` | BedingungVideoprüfung, Speicherung oder Dienstzugriff sind vorübergehend nicht verfügbar. | Nächster SchrittWarten Sie, bis der Dienst verfügbar ist. Wenn Sie bereits eine Video-ID haben, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Generierung zu erstellen. |
| Antwort503 · `result_pending_check` | BedingungDas ursprüngliche Videoergebnis und die Abrechnung müssen geprüft werden. | Nächster SchrittBewahren Sie die zurückgegebene Video-ID auf und prüfen Sie diese Aufgabe. Senden Sie während der Prüfung keine ersetzende Generierungsanfrage. |
| Antwort503 · `owned_result_unavailable` | BedingungDer Download des vorhandenen Videos ist vorübergehend nicht verfügbar. | Nächster SchrittPrüfen Sie dieselbe Videoaufgabe später erneut und laden Sie ihre vorhandene Ausgabe herunter. Eine neue Generierung erstellt einen separaten Vorgang. |
| Antwort409 · `video_not_ready` | BedingungDer Videoinhalt wurde nicht veröffentlicht. | Nächster SchrittPrüfen Sie den Status der ursprünglichen Aufgabe. Laden Sie das Ergebnis herunter, sobald completed gemeldet wird; bei failed folgen Sie dem Hinweis zur Abrechnungsprüfung. |

### Aliasnamen

#### Modellaliasnamen

**Ailoot Ultra** [`heygen/heygen-video-1`](https://ailoot.ai/models/de/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

#### Aliasnamen für Methodenpfade

Verwenden Sie die oben angezeigten Methodenpfade.

#### Zugehörige Aufrufer-IDs

[`heygen/heygen-video-1`](https://ailoot.ai/models/de/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

FAQ · HeyGen: HeyGen Video

Welche Eingaben und Ergebnisse sind verfügbar?

`POST /v1/videos` · `heygen/heygen-video-1`: `text`, `image`, `audio`, `video` → `video`

Welche Felder verwendet die Anfrage?

`POST /v1/videos` · `heygen/heygen-video-1`: `model`, `prompt`, `duration`, `resolution`, `aspect_ratio`, `generate_audio`, `frame_images`, `input_references`, `seed`, `callback_url`, `session_id`, `trace`, `user`

Welche Grenzen gelten?

`POST /v1/videos` · `heygen/heygen-video-1`: `duration.minimum`: `1`; `duration.maximum`: `600`; `frame_images.max_items`: `1`; `frame_images.min_items`: `1`; `seed.minimum`: `-9223372036854775808`; `seed.maximum`: `9223372036854775807`

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](https://ailoot.ai/docs/de/billing/subscriptions/) · [Modellpreise ansehen](https://ailoot.ai/models/de/)

## 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](mailto:support@ailoot.ai) · [Offizielles Angebot und Lizenzvertrag](https://ailoot.ai/legal/offer?lang=de)

## Ailoot · Das Unternehmen und sein Projektportfolio





Ailoot baut auf bewährte Betriebserfahrung, einen großen Kundenstamm, stabilen Service und kontinuierliche KPI-Kontrolle.





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





Ailoot nutzt diese Betriebserfahrung für den API-Zugang zu KI-Funktionen in Kundenprodukten, Agenten, Anwendungen und Automatisierungen.