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

# HeyGen: HeyGen Video

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

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

HeyGen Video generuje scény 5–15 sekúnd s dialógom, atmosférou a efektmi z textu, prvého obrázka alebo vizuálnych a zvukových referencií. Všeobecný model heygen-video-1 podporuje produktové a zábery postáv s referenčným ovládaním a výstupom MP4. Jasné, ohraničené akcie mu dávajú užitočné produkčné zadanie.

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

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

HeyGen Video je všeobecný model generovania scén od HeyGen, výrobcom identifikovaný ako heygen-video-1. Vytvára subjekt, prostredie, svetlo a zvuk spolu z tvorivého zadania. Každý klip má 5–15 sekúnd a obsahuje generovanú zvukovú stopu vrátane dialógu, atmosféry a efektov. Užitočné produkčné vstupy zahŕňajú opis scény, fotografiu produktu alebo materiál stanovujúci osobu, miesto či pohyb. Výsledným materiálom je krátka scéna pre prezentáciu produktu, vložku úvodného oboznámenia, pohľad na nehnuteľnosť alebo inú strihovú prácu s videom.

Tri režimy dávajú vstupom odlišné úlohy. Prevod textu na video vytvára scénu z promptu. Prevod obrázka na video doslova začína dodaným obrázkom a potom sleduje zadanie akcie. Prevod referencií na video používa dodané obrázky, video a voliteľný zvuk na usmernenie novo komponovanej scény; vyžaduje aspoň jeden referenčný obrázok alebo video. Obrázok prvej snímky vyberte, keď úvodná kompozícia musí zodpovedať statickému obrázku, a referencie, keď sa má známy predmet objaviť v inej kompozícii. Tento model scén sa líši od vykresľovacích enginov avatarov HeyGen a kompozičného postupu Video Agent.

Príručka výrobcu uprednostňuje podrobné, konkrétne pokyny záberu: jeden subjekt, jednu lokáciu a jednu ohraničenú akciu s pevnou alebo jemne sa pohybujúcou kamerou. Opíšte polohu kamery, zámer objektívu alebo hĺbky ostrosti, svetlo, textúru povrchu a farebné spracovanie. Ak akcia závisí od kontaktu, vysvetlite, kde sa predmety dotýkajú. Pri pôvodnom produktovom príklade použite referenčnú fotografiu cestovnej termosky a žiadajte, aby stála na drevenom pulte, kým vedľa nej hovorí moderátor, s malým pohybom kamery k termoske. Vo výsledku skontrolujte tvar, umiestnenie a viditeľné označenia termosky.

Referenčné zoznamy podporujú až deväť obrázkov, tri videá a tri zvukové položky s maximálne dvanástimi referenciami spolu. Obrázky, videá a zvuk sa vo formáte promptu výrobcu číslujú samostatne: prvý obrázok je \<Picture 1\> a prvé video \<Video 1\>. Každej referencii dajte úlohu a výslovne ju identifikujte v zadaní. Model číta prvých päť sekúnd každého referenčného videa, preto príslušný úsek pripravte na začiatku. Referencia API tiež určuje pomery referenčného videa medzi 1:4 a 4:1. Dlhý klip s požadovaným pohybom len na konci je slabou prípravou pre toto päťsekundové vstupné okno.

Dokumentované referenčné rozhranie prijíma priamo dostupný zdroj HTTPS, identifikátor nahraného materiálu alebo vložené base64. Príručka uvádza maximálne veľkosti obrázkov 16 MB cez URL a 5 MB pri vložení; video alebo zvuk môžu mať do 32 MB cez URL a 16 MB pri vložení. Pripravte čitateľný zdrojový materiál s ľahko rozlíšiteľným dôležitým subjektom a bez súperiacich pokynov v rôznych referenciách. V obrázku prvej snímky zachovajte zamýšľanú orientáciu. Tieto vstupné podrobnosti sa týkajú referenčného postupu výrobcu a pomáhajú organizovať tvorivé materiály pre zvolený režim.

Zvuk režírujte v rovnakom zadaní ako obraz. Uveďte dialóg, hlasový prednes, zvuk miestnosti a konkrétne efekty vrátane toho, či má byť zvuk blízky alebo vzdialený. Ak scéna má obsahovať len reč a atmosféru, určite zamýšľané spracovanie hudby. Príručka navrhuje ako plánovací odhad približne 2,5 hovoreného slova za sekundu, preto nechajte priestor na prestávky a viditeľnú akciu. Krátky úvod možno naplánovať ako jednu repliku nasledovanú momentom odhaľujúcim produkt. Vypočujte si skutočné slová a zhodu generovaného zvuku s priestorom a akciou.

Výstupná dĺžka sa vyberá v celých sekundách od piatich do pätnástich s predvolenými piatimi sekundami. Rozlíšenie je veľkostná trieda: 480p, 768p, 1080p alebo 2k. Dokumentované voľby záberu sú 21:9, 16:9, 4:3, 1:1, 3:4 a 9:16. Pri prevode textu a referencií na video v 1080p alebo 2k zvoľte 16:9 alebo 9:16; adaptívny referenčný záber je dokumentovaný pri 480p a 768p. Prevod obrázka na video sleduje pomery prvého obrázka, preto pri zmene požadovaného tvaru orežte obrázok pred generovaním. Skontrolujte skutočné rozmery dokončeného výsledku a nepredpokladajte, že označenie veľkostnej triedy znamená jednu bežnú dvojicu pixelových rozmerov.

Príručka modelu určuje video MP4 s obrazovým kódovaním H.264 a zvukom AAC pri 32 kHz stereo. Generovanie sa spracúva asynchrónne a dokončená úloha dodáva adresu prehrateľného videa, dĺžku a rozmery. Podpísanú adresu videa možno obnoviť opätovným získaním úlohy. Uchovajte skutočný klip, referenčné materiály a zadanie pre kontrolu zostrihu. Čakajúci alebo spracovávaný záznam sleduje generovanie; dokončené video je produkčným výsledkom na posúdenie obrazu, reči a zvuku.

Výrobca dokumentuje voľby vylepšenia promptu turbo, quality a disabled; disabled zachová pripravené znenie tak, ako je napísané. Pevný seed je užitočný pri porovnávaní zmeny jednej časti vety so zachovaním ostatných vstupov. Zvolený seed a nastavenia zaznamenajte so zadaním záberu. Pri písme na obrazovke zachovajte zamýšľanú frázu krátku a zapíšte ju presne; príručka odporúča odseky, drobné písmo a označené diagramy komponovať dodatočne. Každý viditeľný znak generovaného názvu skontrolujte a nepredpokladajte správnu reprodukciu znenia.

Príručka identifikuje dlhý text na obrazovke, mäkký organický pohyb ako lupene, papier alebo vlasy a detailnú manipuláciu rukami ako menej spoľahlivé oblasti. Pri vysvetlení postupu nech jasne napísaná replika komunikuje kroky, zatiaľ čo obraz ukazuje stabilnú osobu alebo predmet; ak musí byť samotná fyzická operácia presná, použite samostatne overené vizuály. Celý záber skontrolujte z hľadiska kontinuity predmetov, kontaktu, detailov tváre a rúk, dialógu a zvuku. Stručný zoznam toho, čo sa má v ďalšej verzii zmeniť, udržuje podrobné produkčné zadanie praktické.

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

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

HeyGen /`heygen/heygen-video-1`

### Úvod

HeyGen Video generuje scény 5–15 sekúnd s dialógom, atmosférou a efektmi z textu, prvého obrázka alebo vizuálnych a zvukových referencií. Všeobecný model heygen-video-1 podporuje produktové a zábery postáv s referenčným ovládaním a výstupom MP4. Jasné, ohraničené akcie mu dávajú užitočné produkčné zadanie.

Povolené vstupy

Text · Obrázky · Audio · Video

Výsledky

Video

### Dostupné v Ailoot · vstupy a metódy

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

Vstup

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

Výstup

`video`

Výstupný formát

pôvodné bajty MP4; bez normalizácie a prekódovania

| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
| --- | --- | --- | --- | --- |
| Pole`model` | Typ`string` | PožiadavkaPovinné | Hodnoty a limity heygen/heygen-video-1 | Predvolené— |
| Pole`prompt` | Typ`string` | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
| Pole`duration` | Typ`integer` | PožiadavkaPovinné | Hodnoty a limity 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600 | Predvolené— |
| Pole`resolution` | Typ`string` | PožiadavkaVoliteľné | Hodnoty a limity 480p, 768p, 2K | Predvolené— |
| Pole`aspect_ratio` | Typ`string` | PožiadavkaVoliteľné | Hodnoty a limity 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Predvolené— |
| Pole`generate_audio` | Typ`boolean` | PožiadavkaVoliteľné | Hodnoty a limity false | Predvolené— |
| Pole`frame_images` | Typ`array` | PožiadavkaVoliteľné | Hodnoty a limity Minimálny počet položiek: 1 Maximálny počet položiek: 1 Vstupný obsah: Pole objektov snímok. Každý objekt má type=image\_url, image\_url obsahujúce url a frame\_type. Použite HTTPS URL obrázka a nastavte frame\_type na first\_frame. Každá rola snímky sa môže vyskytnúť najviac raz. Presné kľúče: type, image\_url, frame\_type Podmienky: Tieto kľúče opisujú každý objekt snímky; image\_url obsahuje iba url. Pri čisto textovej požiadavke vynechajte frame\_images. | Predvolené— |
| Pole`input_references` | Typ`array` | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
| Pole`seed` | Typ`integer` | PožiadavkaVoliteľné | Hodnoty a limity Minimum: -9 223 372 036 854 775 808 Maximum: 9 223 372 036 854 775 807 | Predvolené— |
| Pole`callback_url` | Typ`string` | PožiadavkaVoliteľné | Hodnoty a limity Vzor: ^https:// | Predvolené— |
| Pole`session_id` | Typ`string` | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
| Pole`trace` | Typ`object` | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
| Pole`user` | Typ`string` | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |

Kombinácie vstupných podkladov

**Z textu na video** · Textové zadanie. · Povinné: model, prompt, duration

`Zadajte prompt ako text a duration v celých sekundách. Vyberte podporované rozlíšenie a podľa potreby aj pomer strán.`

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

`prompt`: Typ: string · Maximálny počet bajtov UTF-8: 10 000 · Vyžaduje sa aspoň jeden znak, ktorý nie je bielym znakom: Áno

**Z obrázka na video** · Textové zadanie a obrázok prvej snímky. · Povinné: model, prompt, duration, frame\_images

`frame_images je pole. Každý objekt snímky má type, image_url a frame_type; image_url obsahuje url. Nastavte type na image_url. Použite first_frame. Každá rola snímky sa môže vyskytnúť najviac raz. Pre každú snímku zadajte verejnú HTTPS URL obrázka. Vyberte podporované rozlíšenie a podľa potreby aj pomer strán.`

Presné kľúče: type, image\_url, frame\_type

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

`prompt`: Typ: string · Maximálny počet bajtov UTF-8: 10 000 · Vyžaduje sa aspoň jeden znak, ktorý nie je bielym znakom: Áno

**Reference to video** · Textové zadanie a podporované obrazové, video a zvukové referencie. · Povinné: model, prompt, duration, input\_references

`input_references je pole objektov. Nastavte type na image_url, video_url, audio_url a použite zodpovedajúce pole obsahujúce url. Použite verejné HTTPS URL. Režim referencií vyberiete vynechaním frame_images. Vyberte podporované rozlíšenie a podľa potreby aj pomer strán.`

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

`prompt`: Typ: string · Maximálny počet bajtov UTF-8: 10 000 · Vyžaduje sa aspoň jeden znak, ktorý nie je bielym znakom: Áno

Parametre a životný cyklus metódy

| Parameter | Špecifikácia |
| --- | --- |
| Parameter`content_type` | Špecifikáciaapplication/json |
| Parameter`required` | Špecifikáciamodel, prompt, duration |
| Parameter`material_types` | Špecifikáciatext, image, audio, video |
| Parameter`additional_properties` | Špecifikáciafalse |
| Parameter`optional_controls` | Špecifikáciaresolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, seed, callback\_url, session\_id, trace, user |

Životný cyklus: `submit_once_poll_original`

`GET /v1/videos/{public_id}`

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

### Cenník

##### Ako sa vypočíta konečný poplatok

Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim

Neuvedené Keď je zvolený rýchly režim

Režim Flex

Neuvedené Keď je zvolený režim flex

Maximálna úroveň uvažovania

Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)

#### Odhadované sadzby na porovnanie

#### Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

| Konfigurácia | Sadzobník | Odhadované množstvo | Účtovacia jednotka | Podmienky účtovania | Poplatok |
| --- | --- | --- | --- | --- | --- |
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Účtovacia jednotka— | Podmienky účtovania— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie **—** / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie **—** / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie **—** / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie **—** / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie **—** / 1K tokenov |
| KonfiguráciaCena videa | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza sekundu videa | Podmienky účtovaniaresolution: 2k | Poplatok Výstup · Cena videa · Odhad iba na porovnanie **$0.2** za sekundu videa |
| KonfiguráciaCena videa | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza sekundu videa | Podmienky účtovaniaresolution: 480p | Poplatok Výstup · Cena videa · Odhad iba na porovnanie **$0.04** za sekundu videa |
| KonfiguráciaCena videa | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza sekundu videa | Podmienky účtovaniaresolution: 768p | Poplatok Výstup · Cena videa · Odhad iba na porovnanie **$0.072** za sekundu videa |
| KonfiguráciaCena videa | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza sekundu videa | Podmienky účtovaniarežim generovania: reference; rozlíšenie: 2k | Poplatok Výstup · Cena videa · Odhad iba na porovnanie **$0.36** za sekundu videa |
| KonfiguráciaCena videa | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza sekundu videa | Podmienky účtovaniarežim generovania: reference; rozlíšenie: 480p | Poplatok Výstup · Cena videa · Odhad iba na porovnanie **$0.14** za sekundu videa |
| KonfiguráciaCena videa | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza sekundu videa | Podmienky účtovaniarežim generovania: reference; rozlíšenie: 768p | Poplatok Výstup · Cena videa · Odhad iba na porovnanie **$0.2** za sekundu videa |
| Konfiguráciareferenčný vstupný obrázok | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza referenčný vstupný obrázok | Podmienky účtovania— | Poplatok Vstup · referenčný vstupný obrázok · Odhad iba na porovnanie **$0.08** za referenčný vstupný obrázok |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Účtovacia jednotka— | Podmienky účtovania— | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie **$0.2** odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie. |

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. [Ako funguje rezervácia a vyúčtovanie →](https://ailoot.ai/docs/sk/billing/reserve/)

#### Podrobnosti referenčnej tarify

Referenčné sadzobníky modelu nemenia výber metódy, cenové odhady ani poplatky. Aktívne poplatky používajú sadzby vybranej metódy Ailoot.

Cenové referencie konfigurácií videa

#### Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

| Konfigurácia | Podmienky účtovania | Poplatok |
| --- | --- | --- |
| KonfiguráciaCena videa | Podmienky účtovaniaresolution: 2k | Poplatok Výstup · Cena videa **$0.18** za sekundu videa Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou. |
| KonfiguráciaCena videa | Podmienky účtovaniaresolution: 480p | Poplatok Výstup · Cena videa **$0.04** za sekundu videa Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou. |
| KonfiguráciaCena videa | Podmienky účtovaniaresolution: 768p | Poplatok Výstup · Cena videa **$0.06** za sekundu videa Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou. |
| KonfiguráciaCena videa | Podmienky účtovaniarežim generovania: reference; rozlíšenie: 2k | Poplatok Výstup · Cena videa **$0.36** za sekundu videa Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou. |
| KonfiguráciaCena videa | Podmienky účtovaniarežim generovania: reference; rozlíšenie: 480p | Poplatok Výstup · Cena videa **$0.08** za sekundu videa Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou. |
| KonfiguráciaCena videa | Podmienky účtovaniarežim generovania: reference; rozlíšenie: 768p | Poplatok Výstup · Cena videa **$0.12** za sekundu videa Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou. |

### Príklady požiadaviek

#### Ailoot Ultra · Video

curl · vytvoriť video

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

### Prijať a uložiť výsledky

#### Ailoot Ultra · Video

podpísané URL obsahu vo vašom vlastníctve

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

##### Skontrolovať stav úlohy

GET stav pôvodnej operácie

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

Čítanie ďalšieho obsahu

Uložiť každý dokončený výstup, ktorý vám patrí

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

##### Uchovať všetky dokončené výsledky

Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.

Zachovajte každý skutočný výstup vo vašom vlastníctve a jeho vrátené namerané metadáta.

##### Ak treba overiť pôvodnú odpoveď

503 result\_pending\_check + pôvodné id + X-Should-Retry:false; pôvodnú požiadavku nikdy znova neodosielajte

Polia odpovede

| Pole | Typ | Význam |
| --- | --- | --- |
| Pole`index` | Typinteger | VýznamPozícia tohto videa v zozname výstupov, číslovaná od nuly. |
| Pole`content_url` | Typstring | VýznamPodpísaná HTTPS URL na stiahnutie tohto dokončeného videa. |
| Pole`sha256` | Typstring \| null | VýznamOdtlačok SHA-256 pôvodných bajtov videa; null, ak nie je dostupný. |
| Pole`size_bytes` | Typinteger \| null | VýznamVeľkosť pôvodného videosúboru v bajtoch; null, ak nie je dostupná. |
| Pole`duration_ms` | Typinteger \| null | VýznamNameraná dĺžka videa v milisekundách; null, ak nie je dostupná. |
| Pole`width` | Typinteger \| null | VýznamŠírka videa v pixeloch; null, ak nie je dostupná. |
| Pole`height` | Typinteger \| null | VýznamVýška videa v pixeloch; null, ak nie je dostupná. |
| Pole`video_codec` | Typstring \| null | VýznamIdentifikátor video kodeku; null, ak nie je zaznamenaný. |
| Pole`has_audio` | Typboolean \| null | VýznamČi video obsahuje zvukovú stopu; null, ak sa to nemeralo. |
| Pole`audio_codec` | Typstring \| null | VýznamIdentifikátor zvukového kodeku; null, keď nie je zaznamenaný žiadny identifikátor. |

Chyby a ďalšie kroky

| Odpoveď | Podmienka | Ďalší krok |
| --- | --- | --- |
| Odpoveď404 · `not_found_error` | PodmienkaPrístup k videu nie je dostupný alebo sa toto ID videa nenašlo. | Ďalší krokSkontrolujte prístup k videu. Pri existujúcom videu použite jeho pôvodné verejné ID a rovnaký kľúč API. |
| Odpoveď401 · `authentication_error` | PodmienkaKľúč API nezodpovedá overenému účtu. | Ďalší krokPred odoslaním skontrolujte svoj kľúč API a prístup účtu. |
| Odpoveď400 · `invalid_request_error` | PodmienkaPožiadavku sa nepodarilo načítať alebo je index sťahovania neplatný. | Ďalší krokOpravte telo požiadavky. Pri sťahovaní vyberte index výstupu vrátený pôvodnou úlohou. |
| Odpoveď422 · `price_unavailable` | PodmienkaCenu vybranej konfigurácie videa nemožno určiť. | Ďalší krokVyberte podporovanú konfiguráciu videa a pred odoslaním opravenej požiadavky vyplňte jej povinné možnosti. |
| Odpoveď422 · `invalid_request_error` | PodmienkaVstup videa alebo pôvodná úloha pokračovania sú neplatné. | Ďalší krokPoužite platné vstupy HTTPS. Pri pokračovaní použite verejné ID svojho dokončeného pôvodného videa s rovnakým kľúčom API. |
| Odpoveď402 · `billing_error` | PodmienkaDostupný zostatok alebo limity neumožňujú rezerváciu. | Ďalší krokPred odoslaním novej požiadavky skontrolujte dostupný zostatok a limity. |
| Odpoveď503 · `server_error` | PodmienkaOverovanie videa, úložisko alebo prístup k službe sú dočasne nedostupné. | Ďalší krokPočkajte na dostupnosť služby. Ak už máte ID videa, skontrolujte pôvodnú úlohu namiesto vytvorenia ďalšieho generovania. |
| Odpoveď503 · `result_pending_check` | PodmienkaPôvodný výsledok videa a poplatok treba skontrolovať. | Ďalší krokZachovajte vrátené ID videa a skontrolujte danú úlohu. Počas jej kontroly neodosielajte náhradnú požiadavku na generovanie. |
| Odpoveď503 · `owned_result_unavailable` | PodmienkaStiahnutie existujúceho videa je dočasne nedostupné. | Ďalší krokNeskôr skontrolujte tú istú úlohu videa a stiahnite jej existujúci výstup. Nové generovanie vytvára samostatnú operáciu. |
| Odpoveď409 · `video_not_ready` | PodmienkaObsah videa nebol zverejnený. | Ďalší krokSkontrolujte stav pôvodnej úlohy. Keď hlási completed, stiahnite jej výsledok; ak hlási failed, riaďte sa jej oznámením o kontrole poplatku. |

### Aliasy

#### Aliasy modelov

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

#### Aliasy ciest metód

Použite cesty metód uvedené vyššie.

#### Súvisiace ID na volanie

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

FAQ · HeyGen: HeyGen Video

Aké vstupy a výsledky sú dostupné?

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

Aké polia používa požiadavka?

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

Aké limity platia?

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

Pripojte Ailoot k Claude Code, OpenCode, Hermes alebo vlastnej aplikácii.

## Spoločnosť a jej portfólio projektov

Spoločnosť a jej portfólio projektov: milióny zákazníkov; mesačné tržby v miliardách.

## Nakupujte tokeny so zľavou.

Zľava predplatného na pravidelnú prácu. Promo kódy až 50% na nákup tokenov.

Predplatné

Na pravidelné požiadavky vyberte tarifu so zľavou.

Promo kód až 50%

Pri nákupe zadajte kód. Cena sa prepočíta podľa prebiehajúcej akcie.

Výdavky v histórii

Pri každej požiadavke sa uloží model, tokeny a suma.

[Vybrať predplatné](https://ailoot.ai/docs/sk/billing/subscriptions/) · [Zobraziť ceny modelov](https://ailoot.ai/models/sk/)

## Pripojte API k produktu, ktorý predávate.

SaaS, aplikácie a boti podľa ponuky a licenčnej zmluvy Ailoot. Na ďalší predaj požiadajte o licenciu predajcu.

Komerčná aplikácia

Začleňte generovanie textu, obrázkov, videa a zvuku do platených funkcií svojej služby.

Licencia pre predajcu

Pošlite popis projektu a spôsob poskytovania prístupu. Vyžiadajte písomné podmienky použitia a ďalšieho predaja.

Dokumenty na webe

Ponuka, licenčná zmluva a zásady spracovania dát sú dostupné pred pripojením.

[Požiadať o licenciu predajcu](mailto:support@ailoot.ai) · [Ponuka a licenčná zmluva](https://ailoot.ai/legal/offer?lang=sk)

## Ailoot · Spoločnosť a jej portfólio projektov





Ailoot stavia na dlhodobých prevádzkových skúsenostiach, širokej klientskej základni, stabilných službách a priebežnom sledovaní KPI.





Spoločnosť a jej portfólio projektov: milióny zákazníkov; mesačné tržby v miliardách.





Ailoot využíva tieto prevádzkové skúsenosti na poskytovanie prístupu cez API k funkciám AI v produktoch zákazníkov, agentoch, aplikáciách a automatizáciách.