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

# HeyGen: HeyGen Video

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

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

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`](https://ailoot.ai/models/nl/heygen-heygen-video-1/#method-0)

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`](https://ailoot.ai/models/nl/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

HeyGen /`heygen/heygen-video-1`

### Aan de slag

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.

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 →](https://ailoot.ai/docs/nl/billing/reserve/)

#### 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

```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
```

### 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

```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
```

Lezen van andere inhoud

Elk voltooid eigen uitvoerresultaat opslaan

```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 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`](https://ailoot.ai/models/nl/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

#### Aliasnamen voor methodepaden

Gebruik de hierboven getoonde methodepaden.

#### Gerelateerde aanroeper-ID’s

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

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`

Verbind Ailoot met Claude Code, OpenCode, Hermes of je eigen applicatie.

## Het bedrijf en zijn projectenportefeuille

Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden.

## Koop tokens met korting.

Abonnementsvoordeel voor regelmatig gebruik. Promotiecodes geven tot 50% korting op tokens.

Abonnement

Kies een abonnement met korting voor je terugkerende verzoeken.

Promotiecode tot 50%

Vul de code bij aankoop in. De prijs wordt volgens de lopende actie herberekend.

Kosten in de geschiedenis

Model, tokens en bedrag worden per verzoek bewaard.

[Kies een abonnement](https://ailoot.ai/docs/nl/billing/subscriptions/) · [Bekijk modelprijzen](https://ailoot.ai/models/nl/)

## Verbind de API met het product dat je verkoopt.

SaaS, apps en bots volgens de openbare aanbodvoorwaarden en licentieovereenkomst van Ailoot. Vraag voor doorverkoop een resellerlicentie aan.

Commerciële applicatie

Voeg tekst-, beeld-, video- en geluidsgeneratie aan betaalde functies van je service toe.

Resellerlicentie

Stuur een projectbeschrijving en toegangsschema. Vraag schriftelijke voorwaarden voor gebruik en doorverkoop.

Documenten op de site

Aanbodvoorwaarden, licentieovereenkomst en gegevensbeleid zijn vóór het verbinden beschikbaar.

[Vraag een resellerlicentie aan](mailto:support@ailoot.ai) · [Aanbodvoorwaarden en licentieovereenkomst](https://ailoot.ai/legal/offer?lang=nl)

## Ailoot · Het bedrijf en zijn projectenportefeuille





Ailoot bouwt op opgebouwde operationele ervaring, een groot klantenbestand, een stabiele dienst en doorlopende KPI-controle.





Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden.





Ailoot gebruikt die operationele ervaring voor API-toegang tot AI-functies in klantproducten, agents, applicaties en automatiseringen.