Modelle

HeyGen: HeyGen Video

Markdown · JSON

HeyGen: HeyGen Video

HeyGen Video erzeugt Szenen von 5–15 Sekunden mit Dialog, Atmosphäre und Effekten aus Text, einem Anfangsbild oder visuellen und akustischen Referenzen. Sein universelles Modell heygen-video-1 unterstützt Produkt- und Figureneinstellungen mit Referenzsteuerungen und MP4-Ausgabe. Klare, begrenzte Handlungen liefern ein brauchbares Produktionsbriefing.

Ü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, vom Hersteller als heygen-video-1 bezeichnet. Es erzeugt Motiv, Umgebung, Licht und Ton gemeinsam aus einem kreativen Briefing. Jeder Clip dauert 5–15 Sekunden und enthält seine generierte Tonspur mit Dialog, Atmosphäre und Effekten. Geeignete Eingaben sind eine Szenenbeschreibung, ein Produktfoto oder Material, das eine Person, einen Ort oder eine Bewegung festlegt. Das Ergebnis ist eine kurze Szene für eine Produktpräsentation, einen Onboarding-Einspieler, eine Immobilienansicht oder andere Videoschnittarbeit.

Drei Modi weisen den Eingaben unterschiedliche Rollen zu. Text-zu-Video erzeugt eine Szene aus dem Prompt. Bild-zu-Video beginnt genau mit dem bereitgestellten Bild und folgt danach dem Handlungsbriefing. Referenz-zu-Video nutzt Bilder, Videos und optional Ton für eine neu komponierte Szene; mindestens ein Referenzbild oder -video ist erforderlich. Wählen Sie ein Anfangsbild, wenn die Eröffnung einem Standbild entsprechen muss, oder Referenzen, wenn ein bekannter Gegenstand in einer anderen Komposition erscheinen soll. Dieses Szenenmodell unterscheidet sich von HeyGens Avatar-Rendering-Engines und dem Kompositionsablauf Video Agent.

Der Herstellerleitfaden bevorzugt detaillierte, konkrete Einstellungsanweisungen: ein Motiv, ein Ort und eine begrenzte Handlung mit fester oder sanft bewegter Kamera. Beschreiben Sie Kameraposition, Objektiv oder gewünschte Schärfentiefe, Licht, Oberflächentextur und Farbgestaltung. Erklären Sie Berührungspunkte, wenn eine Handlung von Kontakt abhängt. Verwenden Sie für ein eigenes Produktbeispiel ein Referenzfoto einer Thermosflasche und verlangen Sie, 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 Form, Platzierung und sichtbare Kennzeichnungen der Flasche im Ergebnis.

Referenzlisten unterstützen bis zu neun Bilder, drei Videos und drei Tondateien bei insgesamt höchstens zwölf Referenzen. Bilder, Videos und Ton werden im Prompt-Format des Herstellers getrennt nummeriert: Das erste Bild ist <Picture 1>, das erste Video <Video 1>. Weisen Sie jeder Referenz eine Rolle zu und benennen Sie diese ausdrücklich im Briefing. Das Modell liest die ersten fünf Sekunden jedes Referenzvideos; platzieren Sie den relevanten Abschnitt daher an den Anfang. Die API-Referenz nennt zudem Referenzvideo-Seitenverhältnisse zwischen 1:4 und 4:1. Ein langer Clip, dessen gewünschte Bewegung erst am Ende vorkommt, ist für dieses fünfsekündige Eingabefenster schlecht vorbereitet.

Die dokumentierte Referenzschnittstelle akzeptiert eine direkt erreichbare HTTPS-Ressource, eine hochgeladene Dateikennung oder eingebettetes Base64. Der Leitfaden nennt maximale Bildgrößen von 16 MB per URL und 5 MB eingebettet; Video oder Ton dürfen per URL bis 32 MB und eingebettet bis 16 MB groß sein. Bereiten Sie gut lesbares Ausgangsmaterial vor, in dem das wichtige Motiv klar erkennbar ist und unterschiedliche Referenzen keine konkurrierenden Anweisungen geben. Behalten Sie die gewünschte Ausrichtung im Anfangsbild bei. Diese Eingabedetails betreffen den Referenzablauf des Herstellers und helfen, kreative Materialien für den gewählten Modus zu ordnen.

Steuern Sie den Ton im selben Briefing wie das Bild. Nennen Sie Dialog, stimmlichen Vortrag, Raumton und konkrete Effekte, einschließlich naher oder entfernter Geräusche. Legen Sie die gewünschte Musikgestaltung fest, wenn die Szene nur Sprache und Atmosphäre enthalten soll. Der Leitfaden schlägt als Planungsschätzung ungefähr 2,5 gesprochene Wörter pro Sekunde vor; lassen Sie daher Zeit für Pausen und sichtbare Handlung. Eine kurze Einführung kann als ein Satz mit anschließendem Moment zur Produktenthüllung geplant werden. Hören Sie auf die tatsächlichen Wörter und darauf, ob der generierte Ton zu Raum und Handlung passt.

Die Ausgabedauer wird in ganzen Sekunden von fünf bis fünfzehn gewählt; standardmäßig sind es fünf Sekunden. Die Auflösung ist eine Größenklasse: 480p, 768p, 1080p oder 2k. Dokumentierte Seitenverhältnisse sind 21:9, 16:9, 4:3, 1:1, 3:4 und 9:16. Wählen Sie bei Text- und Referenz-zu-Video in 1080p oder 2k entweder 16:9 oder 9:16; adaptive Referenzformate sind für 480p und 768p dokumentiert. Bild-zu-Video folgt den Proportionen des ersten Bildes; schneiden Sie es vor der Generierung zu, wenn sich das benötigte Format ändert. Prüfen Sie die tatsächlichen Ergebnisabmessungen, statt aus einer Größenklassenbezeichnung ein übliches Pixelpaar abzuleiten.

Der Modellleitfaden nennt MP4-Video mit H.264-Bildkodierung und AAC-Ton in 32 kHz Stereo. Eine Generierung wird asynchron verarbeitet; der fertige Auftrag liefert die Adresse des abspielbaren Videos, Dauer und Abmessungen. Seine signierte Videoadresse kann durch erneuten Abruf des Auftrags aktualisiert werden. Bewahren Sie den tatsächlichen Clip, die Referenzen und das Briefing für die Schnittprüfung auf. Ein ausstehender oder laufender Datensatz verfolgt die Generierung; das fertige Video ist das Produktionsergebnis, dessen Bild, Sprache und Ton beurteilt werden.

Der Hersteller dokumentiert die Prompt-Verbesserungsoptionen turbo, quality und disabled; disabled behält die vorbereitete Formulierung unverändert bei. Ein fester Seed hilft beim Vergleich einer einzelnen geänderten Formulierung unter sonst gleichen Eingaben. Halten Sie Seed und Einstellungen mit dem Einstellungsbriefing fest. Halten Sie sichtbare Texte kurz und schreiben Sie sie genau; Absätze, Kleingedrucktes und beschriftete Diagramme sollen laut Leitfaden nachträglich eingesetzt werden. Prüfen Sie jedes sichtbare Zeichen eines generierten Titels, statt eine korrekte Wiedergabe anzunehmen.

Der Leitfaden nennt lange Bildschirmtexte, weiche organische Bewegungen wie Blütenblätter, Papier oder Haare sowie nahe Handmanipulationen als weniger zuverlässige Bereiche. Lassen Sie bei einer Ablaufserklärung einen klar formulierten Satz die Schritte vermitteln, während das Bild eine stabile Person oder einen Gegenstand zeigt; nutzen Sie separat geprüfte Bilder, wenn die physische Handlung selbst exakt sein muss. Prüfen Sie die ganze Einstellung auf Objektkontinuität, Kontakt, Gesichts- und Handdetails, Dialog und Ton. Eine knappe Liste der gewünschten Änderungen für die nächste Aufnahme hält ein detailliertes Produktionsbriefing praktikabel.

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

heygen/heygen-video-1

HeyGen /heygen/heygen-video-1

Einstieg

HeyGen Video erzeugt Szenen von 5–15 Sekunden mit Dialog, Atmosphäre und Effekten aus Text, einem Anfangsbild oder visuellen und akustischen Referenzen. Sein universelles Modell heygen-video-1 unterstützt Produkt- und Figureneinstellungen mit Referenzsteuerungen und MP4-Ausgabe. Klare, begrenzte Handlungen liefern ein brauchbares Produktionsbriefing.

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

In Ailoot verfügbar · Eingaben und Methoden

Ailoot Ultra · Video POST /v1/videos
Eingabe
text, image, audio, video
Ausgabe
video
Ausgabeformat
Originale MP4-Bytes; keine Normalisierung/Transkodierung
FeldTypAnforderungWerte und LimitsStandard
FeldmodelTypstringAnforderungErforderlichWerte und Limits
heygen/heygen-video-1
Standard—
FeldpromptTypstringAnforderungErforderlichWerte und LimitsStandard—
FelddurationTypintegerAnforderungErforderlichWerte und Limits
5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Minimum: 1
Maximum: 600
Standard—
FeldresolutionTypstringAnforderungOptionalWerte und Limits
480p, 768p, 2K
Standard—
Feldaspect_ratioTypstringAnforderungOptionalWerte und Limits
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Standard—
Feldgenerate_audioTypbooleanAnforderungOptionalWerte und Limits
false
Standard—
Feldframe_imagesTyparrayAnforderungOptionalWerte 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 kommt höchstens einmal vor.
Exakte Schlüssel: type, image_url, frame_type
Bedingungen: Diese Schlüssel beschreiben jedes Frame-Objekt; image_url enthält nur url. Lassen Sie frame_images bei einer reinen Textanfrage weg.
Standard—
Feldinput_referencesTyparrayAnforderungOptionalWerte und LimitsStandard—
FeldseedTypintegerAnforderungOptionalWerte und Limits
Minimum: -9 223 372 036 854 775 808
Maximum: 9 223 372 036 854 775 807
Standard—
Feldcallback_urlTypstringAnforderungOptionalWerte und Limits
Muster: ^https://
Standard—
Feldsession_idTypstringAnforderungOptionalWerte und LimitsStandard—
FeldtraceTypobjectAnforderungOptionalWerte und LimitsStandard—
FelduserTypstringAnforderungOptionalWerte und LimitsStandard—
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 des ersten Frames. · 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 kommt höchstens einmal vor. 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, audio_url und verwenden Sie das passende Feld, das url enthält. 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
ParameterVertrag
Parametercontent_typeVertragapplication/json
ParameterrequiredVertragmodel, prompt, duration
Parametermaterial_typesVertragtext, image, audio, video
Parameteradditional_propertiesVertragfalse
Parameteroptional_controlsVertragresolution, 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.

KonfigurationTarifstaffelPrognostizierte MengeAbrechnungseinheitAbrechnungsbedingungenGebühr
KonfigurationBasistarife für TokensTarifstaffelGrundtarifPrognostizierte 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 · In Cache schreiben · Schätzung nur zum Vergleich — / 1K Tokens
Eingabe · In Cache schreiben, 1 Stunde · Schätzung nur zum Vergleich — / 1K Tokens
KonfigurationVideopreisTarifstaffel—Prognostizierte Menge—Abrechnungseinheitpro VideosekundeAbrechnungsbedingungenresolution: 2kGebühr
Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.2 pro Videosekunde
KonfigurationVideopreisTarifstaffel—Prognostizierte Menge—Abrechnungseinheitpro VideosekundeAbrechnungsbedingungenresolution: 480pGebühr
Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.04 pro Videosekunde
KonfigurationVideopreisTarifstaffel—Prognostizierte Menge—Abrechnungseinheitpro VideosekundeAbrechnungsbedingungenresolution: 768pGebühr
Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.072 pro Videosekunde
KonfigurationVideopreisTarifstaffel—Prognostizierte Menge—Abrechnungseinheitpro VideosekundeAbrechnungsbedingungenGenerierungsmodus: reference; Auflösung: 2kGebühr
Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.36 pro Videosekunde
KonfigurationVideopreisTarifstaffel—Prognostizierte Menge—Abrechnungseinheitpro VideosekundeAbrechnungsbedingungenGenerierungsmodus: reference; Auflösung: 480pGebühr
Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.14 pro Videosekunde
KonfigurationVideopreisTarifstaffel—Prognostizierte Menge—Abrechnungseinheitpro VideosekundeAbrechnungsbedingungenGenerierungsmodus: reference; Auflösung: 768pGebühr
Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.2 pro Videosekunde
KonfigurationEingabebild als ReferenzTarifstaffel—Prognostizierte Menge—Abrechnungseinheitpro Referenz-EingabebildAbrechnungsbedingungen—Gebühr
Eingabe · Eingabebild als Referenz · Schätzung nur zum Vergleich $0.08 pro Referenz-Eingabebild
KonfigurationGeschätzte GenerierungskostenTarifstaffel—Prognostizierte MengeSchätzung für eine GenerierungAbrechnungseinheit—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 →

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.

KonfigurationAbrechnungsbedingungenGebühr
KonfigurationVideopreisAbrechnungsbedingungenresolution: 2kGebü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.

KonfigurationVideopreisAbrechnungsbedingungenresolution: 480pGebü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.

KonfigurationVideopreisAbrechnungsbedingungenresolution: 768pGebü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.

KonfigurationVideopreisAbrechnungsbedingungenGenerierungsmodus: reference; Auflösung: 2kGebü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.

KonfigurationVideopreisAbrechnungsbedingungenGenerierungsmodus: reference; Auflösung: 480pGebü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.

KonfigurationVideopreisAbrechnungsbedingungenGenerierungsmodus: reference; Auflösung: 768pGebü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
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 Ausgaben

  • GET /v1/videos/{public_id}
  • GET /v1/videos/{public_id}/content
Auftragsstatus prüfen
GET · Status des ursprünglichen Vorgangs
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
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ächliche, Ihnen zugeordnete Ausgabe und deren zurückgegebene gemessene 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
FeldTypBedeutung
FeldindexTypintegerBedeutungNullbasierte Position dieses Videos in der Ausgabeliste.
Feldcontent_urlTypstringBedeutungSignierte HTTPS-Download-URL für dieses fertiggestellte Video.
Feldsha256Typstring | nullBedeutungSHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar.
Feldsize_bytesTypinteger | nullBedeutungGröße der ursprünglichen Videodatei in Bytes; null, falls nicht verfügbar.
Feldduration_msTypinteger | nullBedeutungGemessene Videodauer in Millisekunden; null, falls nicht verfügbar.
FeldwidthTypinteger | nullBedeutungVideobreite in Pixeln; null, falls nicht verfügbar.
FeldheightTypinteger | nullBedeutungVideohöhe in Pixeln; null, falls nicht verfügbar.
Feldvideo_codecTypstring | nullBedeutungVideocodec-Kennung; null, falls nicht erfasst.
Feldhas_audioTypboolean | nullBedeutungOb das Video eine Audiospur enthält; null, falls nicht gemessen.
Feldaudio_codecTypstring | nullBedeutungAudiocodec-Kennung; null, wenn keine Kennung erfasst wurde.
Fehler und nächste Schritte
AntwortBedingungNächster Schritt
Antwort404 · not_found_errorBedingungDer Videozugriff ist nicht verfügbar oder diese Video-ID wurde nicht gefunden.Nächster SchrittPrüfen Sie den Videozugriff. Verwenden Sie bei einem vorhandenen Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel.
Antwort401 · authentication_errorBedingungDer API-Schlüssel stimmt nicht mit dem authentifizierten Konto überein.Nächster SchrittPrüfen Sie Ihren API-Schlüssel und Ihren Kontozugriff vor der Übermittlung.
Antwort400 · invalid_request_errorBedingungDie 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_unavailableBedingungDie ausgewählte Videokonfiguration kann nicht bepreist werden.Nächster SchrittWählen Sie eine unterstützte Videokonfiguration und vervollständigen Sie deren Pflichtoptionen, bevor Sie eine korrigierte Anfrage übermitteln.
Antwort422 · invalid_request_errorBedingungEine Videoeingabe oder die ursprüngliche Fortsetzungsaufgabe ist ungültig.Nächster SchrittVerwenden Sie gültige HTTPS-Eingaben. Verwenden Sie für eine Fortsetzung Ihre fertiggestellte ursprüngliche öffentliche Video-ID mit demselben API-Schlüssel.
Antwort402 · billing_errorBedingungDas verfügbare Guthaben oder die Limits erlauben keine Reservierung.Nächster SchrittPrüfen Sie Ihr verfügbares Guthaben und Ihre Limits, bevor Sie eine neue Anfrage senden.
Antwort503 · server_errorBedingungVideoprüfung, Speicher oder Dienstzugriff ist vorübergehend nicht verfügbar.Nächster SchrittWarten Sie auf die Verfügbarkeit des Dienstes. Falls Sie bereits eine Video-ID haben, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Generierung anzulegen.
Antwort503 · result_pending_checkBedingungDas 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 Ersatzanfrage zur Generierung.
Antwort503 · owned_result_unavailableBedingungDer Download des vorhandenen Videos ist vorübergehend nicht verfügbar.Nächster SchrittPrüfen Sie dieselbe Videoaufgabe später erneut und laden Sie deren vorhandene Ausgabe herunter. Eine neue Generierung erstellt einen separaten Vorgang.
Antwort409 · video_not_readyBedingungDer Videoinhalt wurde nicht veröffentlicht.Nächster SchrittPrüfen Sie den ursprünglichen Aufgabenstatus. Laden Sie die Ausgabe nach der Meldung completed herunter; folgen Sie bei failed dem Hinweis zur Abrechnungsprüfung.

Aliasnamen

Modellaliasnamen

Ailoot Ultra heygen/heygen-video-1

Aliasnamen für Methodenpfade

Verwenden Sie die oben angezeigten Methodenpfade.

Zugehörige Aufrufer-IDs

heygen/heygen-video-1

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

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