HeyGen: HeyGen Video

HeyGen Video genereert scènes van 5–15 seconden met dialoog, omgevingsgeluid en effecten op basis van tekst, een eerste beeld of visuele en audioreferenties. Het algemene model heygen-video-1 ondersteunt product- en personageshots, met referentieregelaars en MP4-uitvoer. Duidelijke, afgebakende acties geven het een bruikbare productiebriefing.

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

Over het model

Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.

HeyGen Video is het algemene model van HeyGen voor scènegeneratie, door de fabrikant aangeduid als heygen-video-1. Het creëert onderwerp, omgeving, licht en geluid samen op basis van een creatieve briefing. Elke clip is 5–15 seconden lang en bevat een gegenereerde audiotrack met dialoog, omgevingsgeluid en effecten. Bruikbare productie-invoer omvat een scènebeschrijving, een productfoto of materiaal dat een persoon, plaats of beweging vastlegt. Het resulterende bestand is een korte scène voor een productpresentatie, een onboardingfragment, een vastgoedbeeld of ander gemonteerd videowerk.

Drie modi geven de invoer verschillende rollen. Tekst-naar-video creëert een scène uit de prompt. Beeld-naar-video begint letterlijk op het aangeleverde beeld en volgt daarna de briefing voor de actie. Referentie-naar-video gebruikt aangeleverde beelden, video en optionele audio om een nieuw gecomponeerde scène te sturen; dit vereist minimaal één referentiebeeld of -video. Kies een beeld voor het eerste frame wanneer de openingscompositie met een stilstaand beeld moet overeenkomen, of referenties wanneer een bekend object in een andere compositie moet verschijnen. Dit scènemodel staat los van de avatarrenderengines en de Video Agent-compositieworkflow van HeyGen.

De gids van de maker geeft de voorkeur aan gedetailleerde, concrete shotaanwijzingen: één onderwerp, één locatie en één afgebakende actie, met een vaste of zacht bewegende camera. Beschrijf camerapositie, gewenste lenswerking of scherptediepte, licht, oppervlaktetextuur en kleurbehandeling. Leg uit waar objecten elkaar raken wanneer een actie van contact afhangt. Gebruik voor een oorspronkelijk productvoorbeeld een referentiefoto van een thermosfles en vraag deze op een houten aanrecht te laten staan terwijl een presentator ernaast spreekt, met een kleine camerabeweging naar de fles. Controleer vorm, plaatsing en zichtbare markeringen van de fles in het resultaat.

Referentielijsten ondersteunen maximaal negen beelden, drie video's en drie audio-items, met maximaal twaalf referenties in totaal. Beelden, video's en audio worden in het promptformaat van de fabrikant afzonderlijk genummerd: het eerste beeld is <Picture 1> en de eerste video is <Video 1>. Geef elke referentie een rol en identificeer die rol expliciet in de briefing. Het model leest de eerste vijf seconden van elke referentievideo, dus bereid het relevante gedeelte aan het begin voor. De API-referentie specificeert ook referentievideoverhoudingen tussen 1:4 en 4:1. Een lange clip met de gewenste beweging pas aan het einde is een slechte voorbereiding op dat invoervenster van vijf seconden.

De gedocumenteerde referentie-interface accepteert een rechtstreeks toegankelijke HTTPS-bron, een ID van een geüpload bestand of inline base64. De gids vermeldt maximale beeldgroottes van 16 MB via URL en 5 MB inline; video of audio mag tot 32 MB via URL en 16 MB inline zijn. Bereid goed leesbaar bronmateriaal voor waarin het belangrijke onderwerp gemakkelijk te onderscheiden is en zonder tegenstrijdige instructies in verschillende referenties. Behoud de bedoelde oriëntatie in het beeld voor het eerste frame. Deze invoerdetails betreffen de referentieworkflow van de maker en helpen het creatieve materiaal voor de geselecteerde modus te ordenen.

Stuur geluid in dezelfde briefing als het beeld. Benoem dialoog, stemvoordracht, ruimtegeluid en specifieke effecten, inclusief of een geluid dichtbij of ver weg moet zijn. Specificeer de bedoelde muziekbehandeling wanneer de scène alleen spraak en omgevingsgeluid moet bevatten. De gids stelt voor om bij de planning ongeveer 2,5 gesproken woorden per seconde aan te houden, dus laat ruimte voor pauzes en zichtbare actie. Een korte inleiding kan worden gepland als één regel gevolgd door een moment dat het product onthult. Luister naar de daadwerkelijke woorden en of het gegenereerde geluid bij de ruimte en actie past.

De uitvoerduur wordt in hele seconden van vijf tot vijftien gekozen, met vijf seconden als standaard. Resolutie is een grootteklasse: 480p, 768p, 1080p of 2k. De gedocumenteerde kadreringskeuzes zijn 21:9, 16:9, 4:3, 1:1, 3:4 en 9:16. Selecteer voor tekst-naar-video en referentie-naar-video op 1080p of 2k 16:9 of 9:16; adaptieve referentiekadrering is gedocumenteerd op 480p en 768p. Beeld-naar-video volgt de verhoudingen van het eerste beeld, dus snijd vóór generatie bij wanneer de vereiste vorm verandert. Controleer de concrete afmetingen van het voltooide resultaat in plaats van aan te nemen dat een grootteklasselabel één conventioneel pixelpaar impliceert.

De modelgids specificeert MP4-video met H.264-beeldcodering en AAC-audio op 32 kHz stereo. Een generatie wordt asynchroon verwerkt en de voltooide taak levert de afspeelbare videolocatie, duur en afmetingen. De ondertekende videolocatie kan worden vernieuwd door de taak opnieuw op te vragen. Bewaar de daadwerkelijke clip, het referentiemateriaal en de briefing voor een montagebeoordeling. Een record met status in afwachting of in verwerking volgt de generatie; de voltooide video is het productieresultaat dat op beeld, spraak en geluid moet worden beoordeeld.

De fabrikant beschrijft keuzes voor promptverbetering van turbo, quality en disabled; disabled behoudt de voorbereide formulering zoals geschreven. Een vaste seed is nuttig om een wijziging van één zinsdeel te vergelijken terwijl de overige invoer gelijk blijft. Leg de gekozen seed en instellingen bij de shotbriefing vast. Houd voor opschriften in beeld een bedoelde formulering kort en spel die precies; de gids beveelt aan alinea's, kleine tekst en gelabelde diagrammen achteraf te compositen. Controleer elk zichtbaar teken in een gegenereerde titel in plaats van aan te nemen dat de formulering correct is gereproduceerd.

De gids noemt lange tekst in beeld, zachte organische beweging zoals bloemblaadjes, papier of haar, en handelingen waarbij handen van dichtbij in beeld zijn als minder betrouwbare gebieden. Laat voor een procedurele uitleg een duidelijk geschreven regel de stappen overbrengen terwijl het beeld een stabiele persoon of een stabiel object toont; gebruik afzonderlijk geverifieerde beelden wanneer de fysieke handeling zelf exact moet zijn. Controleer het hele shot op objectcontinuïteit, contact, gezichts- en handdetails, dialoog en geluid. Een beknopte lijst van wat in de volgende take moet veranderen houdt een gedetailleerde productiebriefing praktisch.

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

heygen/heygen-video-1

HeyGen /heygen/heygen-video-1

Aan de slag

Toegestane invoer: Tekst · Afbeeldingen · Audio · Video
Resultaten: Video

Beschikbaar in Ailoot · invoer en methoden

Ailoot Ultra · Video POST /v1/videos

Invoertypen: text, image, audio, video
Uitvoertypen: video
Uitvoerformaat: oorspronkelijke MP4-bytes; geen normalisatie of transcodering

Veld	Type	Vereiste	Waarden en limieten	Standaard
Veld`model`	Type`string`	VereisteVereist	Waarden en limieten heygen/heygen-video-1	Standaard—
Veld`prompt`	Type`string`	VereisteVereist	Waarden en limieten	Standaard—
Veld`duration`	Type`integer`	VereisteVereist	Waarden en limieten 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600	Standaard—
Veld`resolution`	Type`string`	VereisteOptioneel	Waarden en limieten 480p, 768p, 2K	Standaard—
Veld`aspect_ratio`	Type`string`	VereisteOptioneel	Waarden en limieten 21:9, 16:9, 4:3, 1:1, 3:4, 9:16	Standaard—
Veld`generate_audio`	Type`boolean`	VereisteOptioneel	Waarden en limieten false	Standaard—
Veld`frame_images`	Type`array`	VereisteOptioneel	Waarden en limieten Minimumaantal items: 1 Maximumaantal items: 1 Invoerinhoud: Array met frameobjecten. Elk object bevat type=image_url, image_url met daarin url, en frame_type. Gebruik een HTTPS-afbeeldings-URL en stel frame_type in op first_frame. Elke framerol komt maximaal eenmaal voor. Exacte sleutels: type, image_url, frame_type Voorwaarden: Deze sleutels beschrijven elk frameobject; image_url bevat uitsluitend url. Laat frame_images weg voor een verzoek met uitsluitend tekst.	Standaard—
Veld`input_references`	Type`array`	VereisteOptioneel	Waarden en limieten	Standaard—
Veld`seed`	Type`integer`	VereisteOptioneel	Waarden en limieten Minimum: -9.223.372.036.854.775.808 Maximum: 9.223.372.036.854.775.807	Standaard—
Veld`callback_url`	Type`string`	VereisteOptioneel	Waarden en limieten Patroon: ^https://	Standaard—
Veld`session_id`	Type`string`	VereisteOptioneel	Waarden en limieten	Standaard—
Veld`trace`	Type`object`	VereisteOptioneel	Waarden en limieten	Standaard—
Veld`user`	Type`string`	VereisteOptioneel	Waarden en limieten	Standaard—

Combinaties van invoermaterialen

Tekst naar video · Een geschreven prompt. · Vereist: model, prompt, duration

Geef prompt als tekst en duration in hele seconden op. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.

model: Type: string · heygen/heygen-video-1

prompt: Type: string · Maximumaantal UTF-8-bytes: 10.000 · Ten minste één teken anders dan witruimte vereist: Ja

Afbeelding naar video · Een geschreven prompt en een afbeelding voor het eerste frame. · Vereist: model, prompt, duration, frame_images

frame_images is een array. Elk frameobject bevat type, image_url en frame_type; image_url bevat url. Stel type in op image_url. Gebruik first_frame. Elke framerol komt maximaal eenmaal voor. Geef voor elk frame een openbare HTTPS-afbeeldings-URL op. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.

Exacte sleutels: type, image_url, frame_type

model: Type: string · heygen/heygen-video-1

prompt: Type: string · Maximumaantal UTF-8-bytes: 10.000 · Ten minste één teken anders dan witruimte vereist: Ja

Reference to video · Een geschreven prompt en ondersteunde afbeeldings-, video- en audioreferenties. · Vereist: model, prompt, duration, input_references

input_references is een array met objecten. Stel type in op image_url, video_url, audio_url en gebruik het bijbehorende veld dat url bevat. Gebruik openbare HTTPS-URLs. Laat frame_images weg om de referentiemodus te selecteren. Kies een ondersteunde resolutie en, indien nodig, een beeldverhouding.

model: Type: string · heygen/heygen-video-1

prompt: Type: string · Maximumaantal UTF-8-bytes: 10.000 · Ten minste één teken anders dan witruimte vereist: Ja

Methodeparameters en levenscyclus

Parameter	Contract
Parameter`content_type`	Contractapplication/json
Parameter`required`	Contractmodel, prompt, duration
Parameter`material_types`	Contracttext, image, audio, video
Parameter`additional_properties`	Contractfalse
Parameter`optional_controls`	Contractresolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user

Levenscyclus: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

Tarieven

Zo worden de uiteindelijke kosten berekend

De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.

Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.

Snelle modus: Niet opgegeven Wanneer de snelle modus is geselecteerd
Flexmodus: Niet opgegeven Wanneer de modus flex is geselecteerd
Maximale redeneerinspanning: Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt

Geschatte tarieven ter vergelijking

Prijzen per configuratie

Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.

Configuratie	Tariefstaffel	Verwachte hoeveelheid	Rekeneenheid	Factureringsvoorwaarden	Kosten
ConfiguratieBasistarieven voor tokens	TariefstaffelBasistarief	Verwachte hoeveelheid—	Rekeneenheid—	Factureringsvoorwaarden—	Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens
ConfiguratieVideoprijs	Tariefstaffel—	Verwachte hoeveelheid—	Rekeneenheidper videoseconde	Factureringsvoorwaardenresolution: 2k	Kosten Uitvoer · Videoprijs · Schatting uitsluitend ter vergelijking $0.2 per videoseconde
ConfiguratieVideoprijs	Tariefstaffel—	Verwachte hoeveelheid—	Rekeneenheidper videoseconde	Factureringsvoorwaardenresolution: 480p	Kosten Uitvoer · Videoprijs · Schatting uitsluitend ter vergelijking $0.04 per videoseconde
ConfiguratieVideoprijs	Tariefstaffel—	Verwachte hoeveelheid—	Rekeneenheidper videoseconde	Factureringsvoorwaardenresolution: 768p	Kosten Uitvoer · Videoprijs · Schatting uitsluitend ter vergelijking $0.072 per videoseconde
ConfiguratieVideoprijs	Tariefstaffel—	Verwachte hoeveelheid—	Rekeneenheidper videoseconde	Factureringsvoorwaardengeneratiemodus: reference; resolutie: 2k	Kosten Uitvoer · Videoprijs · Schatting uitsluitend ter vergelijking $0.36 per videoseconde
ConfiguratieVideoprijs	Tariefstaffel—	Verwachte hoeveelheid—	Rekeneenheidper videoseconde	Factureringsvoorwaardengeneratiemodus: reference; resolutie: 480p	Kosten Uitvoer · Videoprijs · Schatting uitsluitend ter vergelijking $0.14 per videoseconde
ConfiguratieVideoprijs	Tariefstaffel—	Verwachte hoeveelheid—	Rekeneenheidper videoseconde	Factureringsvoorwaardengeneratiemodus: reference; resolutie: 768p	Kosten Uitvoer · Videoprijs · Schatting uitsluitend ter vergelijking $0.2 per videoseconde
Configuratiereferentie-invoerafbeelding	Tariefstaffel—	Verwachte hoeveelheid—	Rekeneenheidper referentie-invoerafbeelding	Factureringsvoorwaarden—	Kosten Invoer · referentie-invoerafbeelding · Schatting uitsluitend ter vergelijking $0.08 per referentie-invoerafbeelding
ConfiguratieGeschatte generatiekosten	Tariefstaffel—	Verwachte hoeveelheidschatting voor één generatie	Rekeneenheid—	Factureringsvoorwaarden—	Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.2 schatting vóór generatie Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie.

Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →

Details van het referentietarief

Referentiestaffels op modelniveau veranderen de methodeselectie, kostenramingen of afschrijvingen niet. Voor de actieve kostenberekening gelden de tarieven van de geselecteerde Ailoot-methode.

Prijsreferenties voor videoconfiguraties

Prijzen per configuratie

Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.

Configuratie	Factureringsvoorwaarden	Kosten
ConfiguratieVideoprijs	Factureringsvoorwaardenresolution: 2k	Kosten Uitvoer · Videoprijs $0.18 per videoseconde Gepubliceerde prijsreferentie voor de weergegeven configuratie. De definitieve kosten volgen de daadwerkelijk gefactureerde configuratie.
ConfiguratieVideoprijs	Factureringsvoorwaardenresolution: 480p	Kosten Uitvoer · Videoprijs $0.04 per videoseconde Gepubliceerde prijsreferentie voor de weergegeven configuratie. De definitieve kosten volgen de daadwerkelijk gefactureerde configuratie.
ConfiguratieVideoprijs	Factureringsvoorwaardenresolution: 768p	Kosten Uitvoer · Videoprijs $0.06 per videoseconde Gepubliceerde prijsreferentie voor de weergegeven configuratie. De definitieve kosten volgen de daadwerkelijk gefactureerde configuratie.
ConfiguratieVideoprijs	Factureringsvoorwaardengeneratiemodus: reference; resolutie: 2k	Kosten Uitvoer · Videoprijs $0.36 per videoseconde Gepubliceerde prijsreferentie voor de weergegeven configuratie. De definitieve kosten volgen de daadwerkelijk gefactureerde configuratie.
ConfiguratieVideoprijs	Factureringsvoorwaardengeneratiemodus: reference; resolutie: 480p	Kosten Uitvoer · Videoprijs $0.08 per videoseconde Gepubliceerde prijsreferentie voor de weergegeven configuratie. De definitieve kosten volgen de daadwerkelijk gefactureerde configuratie.
ConfiguratieVideoprijs	Factureringsvoorwaardengeneratiemodus: reference; resolutie: 768p	Kosten Uitvoer · Videoprijs $0.12 per videoseconde Gepubliceerde prijsreferentie voor de weergegeven configuratie. De definitieve kosten volgen de daadwerkelijk gefactureerde configuratie.

Voorbeeldverzoeken

Ailoot Ultra · Video

curl · video maken

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

Resultaten ophalen en opslaan

Ailoot Ultra · Video

ondertekende inhouds-URLs die u bezit

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

Taakstatus controleren

GET · Status van de oorspronkelijke bewerking

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

Lezen van andere inhoud

Elk voltooid eigen uitvoerresultaat opslaan

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 voltooide resultaten bewaren

Sla elke voltooide video of elk teruggegeven bestand op; haal elke daadwerkelijk teruggegeven bestands-URL op.

Bewaar alle daadwerkelijke uitvoer die u bezit en de geretourneerde gemeten metadata.

Als het oorspronkelijke antwoord moet worden gecontroleerd

503 result_pending_check + oorspronkelijke id + X-Should-Retry:false; herhaal het oorspronkelijke verzoek nooit

Antwoordvelden

Veld	Type	Betekenis
Veld`index`	Typeinteger	BetekenisPositie van deze video in de uitvoerlijst, geteld vanaf nul.
Veld`content_url`	Typestring	BetekenisOndertekende HTTPS-download-URL voor deze voltooide video.
Veld`sha256`	Typestring \| null	BetekenisSHA-256-digest van de oorspronkelijke videobytes; null indien niet beschikbaar.
Veld`size_bytes`	Typeinteger \| null	BetekenisGrootte van het oorspronkelijke videobestand in bytes; null indien niet beschikbaar.
Veld`duration_ms`	Typeinteger \| null	BetekenisGemeten videoduur in milliseconden; null indien niet beschikbaar.
Veld`width`	Typeinteger \| null	BetekenisVideobreedte in pixels; null indien niet beschikbaar.
Veld`height`	Typeinteger \| null	BetekenisVideohoogte in pixels; null indien niet beschikbaar.
Veld`video_codec`	Typestring \| null	BetekenisVideocodec-identificatie; null indien niet vastgelegd.
Veld`has_audio`	Typeboolean \| null	BetekenisOf de video een audiotrack bevat; null indien niet gemeten.
Veld`audio_codec`	Typestring \| null	BetekenisAudiocodec-identificatie; null wanneer geen identificatie is vastgelegd.

Fouten en vervolgstappen

Antwoord	Voorwaarde	Volgende stap
Antwoord404 · `not_found_error`	VoorwaardeVideotoegang is niet beschikbaar of deze video-ID is niet gevonden.	Volgende stapControleer videotoegang. Gebruik voor een bestaande video de oorspronkelijke openbare ID en dezelfde API-sleutel.
Antwoord401 · `authentication_error`	VoorwaardeDe API-sleutel komt niet overeen met het geauthenticeerde account.	Volgende stapControleer uw API-sleutel en accounttoegang voordat u indient.
Antwoord400 · `invalid_request_error`	VoorwaardeHet verzoek kon niet worden gelezen of de downloadindex is ongeldig.	Volgende stapCorrigeer de verzoekbody. Kies voor een download een uitvoerindex die door de oorspronkelijke taak is geretourneerd.
Antwoord422 · `price_unavailable`	VoorwaardeDe geselecteerde videoconfiguratie kan niet worden geprijsd.	Volgende stapKies een ondersteunde videoconfiguratie en vul de vereiste opties in voordat u een gecorrigeerd verzoek indient.
Antwoord422 · `invalid_request_error`	VoorwaardeEen videoinvoer of oorspronkelijke vervolgtaak is ongeldig.	Volgende stapGebruik geldige HTTPS-invoer. Gebruik voor een vervolg uw voltooide oorspronkelijke openbare video-ID met dezelfde API-sleutel.
Antwoord402 · `billing_error`	VoorwaardeHet beschikbare saldo of de limieten staan geen reservering toe.	Volgende stapControleer uw beschikbare saldo en limieten voordat u een nieuw verzoek verstuurt.
Antwoord503 · `server_error`	VoorwaardeVideoverificatie, opslag of servicetoegang is tijdelijk niet beschikbaar.	Volgende stapWacht tot de service beschikbaar is. Als u al een video-ID hebt, controleert u die oorspronkelijke taak in plaats van een nieuwe generatie aan te maken.
Antwoord503 · `result_pending_check`	VoorwaardeHet oorspronkelijke videoresultaat en de kosten moeten worden gecontroleerd.	Volgende stapBewaar de geretourneerde video-ID en controleer die taak. Verstuur geen vervangend generatieverzoek terwijl deze wordt gecontroleerd.
Antwoord503 · `owned_result_unavailable`	VoorwaardeDe bestaande videodownload is tijdelijk niet beschikbaar.	Volgende stapControleer dezelfde videotaak later en download de bestaande uitvoer. Een nieuwe generatie maakt een afzonderlijke operatie aan.
Antwoord409 · `video_not_ready`	VoorwaardeDe video-inhoud is niet gepubliceerd.	Volgende stapControleer de oorspronkelijke taakstatus. Download nadat deze completed meldt; als deze failed meldt, volgt u de melding over kostencontrole.

Aliasnamen

Modelaliasnamen

Ailoot Ultra heygen/heygen-video-1

Aliasnamen voor methodepaden

Gebruik de hierboven getoonde methodepaden.

Gerelateerde aanroeper-ID’s

heygen/heygen-video-1

FAQ · HeyGen: HeyGen Video

Welke invoer en resultaten zijn beschikbaar?: POST /v1/videos · heygen/heygen-video-1: text, image, audio, video → video
Welke velden gebruikt het verzoek?: 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
Welke limieten gelden?: 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

HeyGen: HeyGen Video