HeyGen: HeyGen Video
HeyGen Video erzeugt Szenen von 5–15 Sekunden mit Dialog, Atmosphäre und Effekten aus Text, einem ersten Bild oder visuellen und akustischen Referenzen. Sein universelles Modell heygen-video-1 unterstützt Produkt- und Figureneinstellungen mit Referenzsteuerungen und MP4-Ausgabe. Klare, begrenzte Handlungen ergeben 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 Szenengenerierungsmodell, das der Hersteller als heygen-video-1 bezeichnet. Es erstellt Motiv, Umgebung, Licht und Ton gemeinsam aus einem kreativen Briefing. Jeder Clip ist 5–15 Sekunden lang und enthält seine generierte Tonspur mit Dialog, Atmosphäre und Effekten. Nützliche Produktionseingaben sind eine Szenenbeschreibung, ein Produktfoto oder Material, das Person, Ort oder Bewegung festlegt. Das Ergebnis ist eine kurze Szene für eine Produktpräsentation, einen Onboarding-Einschub, eine Immobilienansicht oder andere geschnittene Videoarbeiten.
Drei Modi geben den Eingaben unterschiedliche Rollen. Text-to-Video erzeugt eine Szene aus dem Prompt. Image-to-Video beginnt wortwörtlich mit dem bereitgestellten Bild und folgt danach dem Handlungsbriefing. Reference-to-Video nutzt bereitgestellte Bilder, Videos und optional Ton, um eine neu komponierte Szene anzuleiten; mindestens ein Referenzbild oder -video ist erforderlich. Wählen Sie ein Erstbild, wenn die Eröffnungskomposition einem Standbild 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 Video Agent.
Der Herstellerleitfaden bevorzugt detaillierte, konkrete Einstellungsanweisungen: ein Motiv, ein Ort und eine begrenzte Handlung mit feststehender oder sanft bewegter Kamera. Beschreiben Sie Kameraposition, Objektiv oder Schärfentiefe, Licht, Oberflächentextur und Farbgestaltung. Erklären Sie Berührungspunkte von Objekten, wenn eine Handlung von Kontakt abhängt. Verwenden Sie als eigenes Produktbeispiel ein Referenzfoto einer Thermosflasche und bitten Sie darum, sie auf einer Holztheke zu platzieren, während daneben eine moderierende Person spricht und die Kamera leicht zur Flasche fährt. Prüfen Sie Form, Platzierung und sichtbare Kennzeichnungen der Flasche im Ergebnis.
Referenzlisten unterstützen bis zu neun Bilder, drei Videos und drei Audioelemente bei höchstens zwölf Referenzen insgesamt. Bilder, Videos und Ton werden im Prompt-Format des Herstellers getrennt nummeriert: Das erste Bild ist <Picture 1>, das erste Video <Video 1>. Geben Sie jeder Referenz eine Rolle und benennen Sie diese ausdrücklich im Briefing. Das Modell liest die ersten fünf Sekunden jedes Referenzvideos; legen Sie den relevanten Abschnitt deshalb an den Anfang. Die API-Referenz legt ausserdem Seitenverhältnisse von Referenzvideos zwischen 1:4 und 4:1 fest. Ein langer Clip, dessen gewünschte Bewegung erst am Ende erscheint, ist für dieses Fünfsekunden-Eingabefenster schlecht vorbereitet.
Die dokumentierte Referenzschnittstelle akzeptiert eine direkt zugängliche HTTPS-Ressource, eine Kennung eines hochgeladenen Assets oder Inline-Base64. Der Leitfaden nennt für Bilder maximal 16 MB per URL und 5 MB inline; Video oder Audio dürfen per URL bis 32 MB und inline bis 16 MB umfassen. Bereiten Sie gut lesbares Ausgangsmaterial vor, dessen wichtiges Motiv klar unterscheidbar ist, und vermeiden Sie konkurrierende Anweisungen in verschiedenen Referenzen. Behalten Sie die gewünschte Ausrichtung im Erstbild bei. Diese Eingabedetails betreffen den Referenzablauf des Herstellers und helfen, das kreative Material für den gewählten Modus zu ordnen.
Steuern Sie den Ton im selben Briefing wie das Bild. Nennen Sie Dialog, stimmliche Darbietung, Raumatmosphäre und konkrete Effekte sowie deren Nähe oder Entfernung. Legen Sie die gewünschte Musikgestaltung fest, wenn die Szene nur Sprache und Atmosphäre enthalten soll. Der Leitfaden empfiehlt als Planungswert ungefähr 2,5 gesprochene Wörter pro Sekunde; lassen Sie daher Raum für Pausen und sichtbare Handlung. Eine kurze Einführung lässt sich als ein Satz mit anschliessendem Moment zur Produktenthüllung planen. 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ässig fünf Sekunden. Die Auflösung ist eine Grössenklasse: 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 in 1080p oder 2k 16:9 oder 9:16; adaptive Referenzformate sind für 480p und 768p dokumentiert. Image-to-Video folgt den Proportionen des ersten Bildes; beschneiden Sie es daher vor der Generierung, wenn sich das benötigte Format ändert. Prüfen Sie die tatsächlichen Abmessungen des fertigen Ergebnisses, statt aus einer Grössenklasse ein bestimmtes konventionelles Pixelpaar abzuleiten.
Der Modellleitfaden spezifiziert MP4-Video mit H.264-Bildcodierung und AAC-Ton bei 32 kHz in Stereo. Eine Generierung wird asynchron verarbeitet; der abgeschlossene Auftrag liefert den abspielbaren Videospeicherort, Dauer und Abmessungen. Der signierte Videospeicherort lässt sich durch erneutes Abrufen des Auftrags aktualisieren. Bewahren Sie den tatsächlichen Clip, Referenzmaterial und Briefing für eine Schnittprüfung auf. Ein ausstehender oder laufender Status verfolgt die Generierung; das fertige Video ist das Produktionsergebnis, dessen Bild, Sprache und Ton geprüft werden.
Der Hersteller dokumentiert die Prompt-Verbesserungsoptionen turbo, quality und disabled; disabled erhält den vorbereiteten Wortlaut unverändert. Ein fester Seed hilft beim Vergleich einer Änderung an einem Satzteil unter Beibehaltung aller anderen Eingaben. Halten Sie Seed und Einstellungen mit dem Einstellungsbriefing fest. Halten Sie Bildschirmtext kurz und geben Sie die gewünschte Formulierung genau an; der Leitfaden empfiehlt, Absätze, Kleingedrucktes und beschriftete Diagramme nachträglich zu montieren. Prüfen Sie jedes sichtbare Zeichen eines generierten Titels, statt die korrekte Wiedergabe anzunehmen.
Der Leitfaden nennt langen Bildschirmtext, weiche organische Bewegung wie Blütenblätter, Papier oder Haare sowie Handmanipulationen in Nahaufnahme als weniger zuverlässige Bereiche. Lassen Sie bei einer Ablaufserklärung einen klar geschriebenen Satz die Schritte vermitteln, während das Bild eine stabile Person oder ein stabiles Objekt zeigt; verwenden Sie separat geprüfte Visualisierungen, wenn der physische 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 im nächsten Durchgang zu ändernden Punkte hält ein detailliertes Produktionsbriefing praktikabel.
Ailoot Ultra · Video POST /v1/videos heygen/heygen-video-1
heygen/heygen-video-1Einstieg
HeyGen Video erzeugt Szenen von 5–15 Sekunden mit Dialog, Atmosphäre und Effekten aus Text, einem ersten Bild oder visuellen und akustischen Referenzen. Sein universelles Modell heygen-video-1 unterstützt Produkt- und Figureneinstellungen mit Referenzsteuerungen und MP4-Ausgabe. Klare, begrenzte Handlungen ergeben 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
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits heygen/heygen-video-1 | Standard— |
Feldprompt | Typstring | AnforderungErforderlich | Werte und Limits | Standard— |
Feldduration | Typinteger | AnforderungErforderlich | Werte und Limits 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600 | Standard— |
Feldresolution | Typstring | AnforderungOptional | Werte und Limits 480p, 768p, 2K | Standard— |
Feldaspect_ratio | Typstring | AnforderungOptional | Werte und Limits 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Standard— |
Feldgenerate_audio | Typboolean | AnforderungOptional | Werte und Limits false | Standard— |
Feldframe_images | Typarray | AnforderungOptional | Werte und Limits Mindestanzahl Elemente: 1 Maximale Anzahl Elemente: 1 Eingabeinhalt: Array von Bildobjekten. 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 Bildrolle darf höchstens einmal vorkommen. Exakte Schlüssel: type, image_url, frame_type Bedingungen: Diese Schlüssel beschreiben jedes Bildobjekt; image_url enthält ausschliesslich url. Lassen Sie frame_images bei einer reinen Textanfrage weg. | Standard— |
Feldinput_references | Typarray | AnforderungOptional | Werte und Limits | Standard— |
Feldseed | Typinteger | AnforderungOptional | Werte und Limits Minimum: -9'223'372'036'854'775'808 Maximum: 9'223'372'036'854'775'807 | Standard— |
Feldcallback_url | Typstring | AnforderungOptional | Werte und Limits Muster: ^https:// | Standard— |
Feldsession_id | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Feldtrace | Typobject | AnforderungOptional | Werte und Limits | Standard— |
Felduser | Typstring | AnforderungOptional | Werte und Limits | Standard— |
Kombinationen von Eingabematerialien
Text zu Video · Eine schriftliche Beschreibung. · 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 ausser Leerraum erforderlich: Ja
Bild zu Video · Eine schriftliche Beschreibung und ein Bild für das erste Einzelbild. · Erforderlich: model, prompt, duration, frame_images
frame_images ist ein Array. Jedes Bildobjekt enthält type, image_url und frame_type; image_url enthält url. Setzen Sie type auf image_url. Verwenden Sie first_frame. Jede Bildrolle darf höchstens einmal vorkommen. Geben Sie für jedes Bild 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 ausser Leerraum erforderlich: Ja
Reference to video · Eine schriftliche Beschreibung 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 entsprechende Feld mit url. Verwenden Sie öffentliche HTTPS-URLs. Lassen Sie frame_images weg, um den Referenzmodus zu wä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 ausser Leerraum erforderlich: Ja
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, prompt, duration |
Parametermaterial_types | Vertragtext, image, audio, video |
Parameteradditional_properties | Vertragfalse |
Parameteroptional_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 |
|---|---|---|---|---|---|
| KonfigurationToken-Basistarife | TarifstaffelGrundtarif | Prognostizierte 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 |
| 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 | AbrechnungsbedingungenErzeugungsmodus: reference; Auflösung: 2k | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.36 pro Videosekunde |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Videosekunde | AbrechnungsbedingungenErzeugungsmodus: reference; Auflösung: 480p | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.14 pro Videosekunde |
| KonfigurationVideopreis | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Videosekunde | AbrechnungsbedingungenErzeugungsmodus: reference; Auflösung: 768p | Gebühr Ausgabe · Videopreis · Schätzung nur zum Vergleich $0.2 pro Videosekunde |
| KonfigurationReferenz-Eingabebild | Tarifstaffel— | Prognostizierte Menge— | Abrechnungseinheitpro Referenz-Eingabebild | Abrechnungsbedingungen— | Gebühr Eingabe · Referenz-Eingabebild · Schätzung nur zum Vergleich $0.08 pro Referenz-Eingabebild |
| KonfigurationGeschätzte Erzeugungskosten | 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 abschliessenden 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.
| 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 | AbrechnungsbedingungenErzeugungsmodus: 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 | AbrechnungsbedingungenErzeugungsmodus: 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 | AbrechnungsbedingungenErzeugungsmodus: 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
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
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
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 die 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 |
|---|---|---|
Feldindex | Typinteger | BedeutungBei null beginnende Position dieses Videos in der Ausgabeliste. |
Feldcontent_url | Typstring | BedeutungSignierte HTTPS-URL zum Herunterladen dieses fertiggestellten Videos. |
Feldsha256 | Typstring | null | BedeutungSHA-256-Prüfsumme der ursprünglichen Videobytes; null, falls nicht verfügbar. |
Feldsize_bytes | Typinteger | null | BedeutungGrösse der ursprünglichen Videodatei in Bytes; null, falls nicht verfügbar. |
Feldduration_ms | Typinteger | null | BedeutungGemessene Videodauer in Millisekunden; null, falls nicht verfügbar. |
Feldwidth | Typinteger | null | BedeutungVideobreite in Pixeln; null, falls nicht verfügbar. |
Feldheight | Typinteger | null | BedeutungVideohöhe in Pixeln; null, falls nicht verfügbar. |
Feldvideo_codec | Typstring | null | BedeutungKennung des Videocodecs; null, falls nicht aufgezeichnet. |
Feldhas_audio | Typboolean | null | BedeutungGibt an, ob das Video eine Audiospur enthält; null, falls nicht gemessen. |
Feldaudio_codec | Typstring | null | BedeutungKennung des Audiocodecs; 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 bei einem bestehenden Video dessen ursprüngliche öffentliche ID und denselben API-Schlüssel. |
Antwort401 · authentication_error | BedingungDer API-Schlüssel stimmt nicht mit dem authentifizierten Konto überein. | Nächster SchrittPrüfen Sie vor dem Einreichen 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 Anfragetext. 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 ermitteln. | Nächster SchrittWählen Sie eine unterstützte Videokonfiguration und ergänzen Sie die erforderlichen Optionen, bevor Sie eine korrigierte Anfrage einreichen. |
Antwort422 · invalid_request_error | BedingungEine Videoeingabe oder eine ursprüngliche Fortsetzungsaufgabe ist ungültig. | Nächster SchrittVerwenden Sie gültige HTTPS-Eingaben. Verwenden Sie für eine Fortsetzung die ursprüngliche öffentliche Video-ID Ihres fertiggestellten Videos mit demselben API-Schlüssel. |
Antwort402 · billing_error | BedingungDas verfügbare Guthaben oder die geltenden Limiten erlauben keine Reservierung. | Nächster SchrittPrüfen Sie Ihr verfügbares Guthaben und Ihre Limiten, bevor Sie eine neue Anfrage senden. |
Antwort503 · server_error | BedingungVideoprüfung, Speicher oder Dienstzugriff ist vorübergehend nicht verfügbar. | Nächster SchrittWarten Sie, bis der Dienst verfügbar ist. Falls Sie bereits eine Video-ID besitzen, prüfen Sie diese ursprüngliche Aufgabe, statt eine weitere Erzeugung zu erstellen. |
Antwort503 · result_pending_check | BedingungDas ursprüngliche Videoergebnis und die Abbuchung 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 Erzeugungsanfrage. |
Antwort503 · owned_result_unavailable | BedingungDer Download des bestehenden Videos ist vorübergehend nicht verfügbar. | Nächster SchrittPrüfen Sie später dieselbe Videoaufgabe und laden Sie deren bestehende Ausgabe herunter. Eine neue Erzeugung erstellt einen separaten Vorgang. |
Antwort409 · video_not_ready | BedingungDer Videoinhalt wurde nicht veröffentlicht. | Nächster SchrittPrüfen Sie den ursprünglichen Aufgabenstatus. Laden Sie die Ausgabe herunter, nachdem completed gemeldet wird; bei failed befolgen Sie den Hinweis zur Prüfung der Abbuchung. |
Aliasnamen
Modellaliasnamen
Ailoot Ultra heygen/heygen-video-1
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
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