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

# HeyGen: HeyGen Video

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

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

HeyGen Video generuje scény 5–15 sekund s dialogem, atmosférou a efekty z textu, prvního obrázku nebo vizuálních a zvukových referencí. Jeho univerzální model heygen-video-1 podporuje produktové záběry i postavy, s referenčním ovládáním a výstupem MP4. Jasné, ohraničené akce mu dávají užitečné produkční zadání.

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

O modelu

Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.

HeyGen Video je univerzální model generování scén od HeyGen, výrobcem identifikovaný jako heygen-video-1. Vytváří objekt, prostředí, světlo a zvuk společně z tvůrčího zadání. Každý klip trvá 5–15 sekund a obsahuje generovanou zvukovou stopu včetně dialogu, atmosféry a efektů. Užitečné produkční vstupy zahrnují popis scény, fotografii produktu nebo materiál stanovující osobu, místo či pohyb. Výsledným podkladem je krátká scéna pro produktovou prezentaci, úvodní instruktážní vložku, pohled na nemovitost nebo jinou práci s upravovaným videem.

Tři režimy dávají vstupům odlišné role. Převod textu na video vytváří scénu z promptu. Převod obrázku na video doslova začíná dodaným obrázkem a potom sleduje zadání akce. Převod referencí na video používá dodané obrázky, video a volitelný zvuk pro vedení nově sestavené scény; vyžaduje alespoň jeden referenční obrázek nebo video. Obrázek prvního snímku vyberte, má-li úvodní kompozice odpovídat statickému obrázku, a reference, má-li se známý předmět objevit v jiné kompozici. Tento model scén se liší od renderovacích enginů avatarů HeyGen i od kompozičního postupu Video Agent.

Příručka výrobce upřednostňuje podrobné, konkrétní vedení záběru: jeden objekt, jedno místo a jednu ohraničenou akci, s pevnou nebo jemně se pohybující kamerou. Popište polohu kamery, záměr objektivu nebo hloubky ostrosti, světlo, texturu povrchu a barevné zpracování. Pokud akce závisí na kontaktu, vysvětlete místa dotyku předmětů. U původního produktového příkladu použijte referenční fotografii cestovní termosky a požádejte, aby stála na dřevěném pultu, zatímco vedle ní mluví moderátor, s malým pohybem kamery k termosce. Ve výsledku zkontrolujte tvar, umístění a viditelné označení termosky.

Seznamy referencí podporují až devět obrázků, tři videa a tři zvukové položky, s maximem dvanáct referencí celkem. Obrázky, videa a zvuk se ve formátu promptu výrobce číslují samostatně: první obrázek je \<Picture 1\> a první video \<Video 1\>. Každé referenci dejte roli a v zadání ji výslovně určete. Model čte prvních pět sekund každého referenčního videa, proto relevantní úsek připravte na začátku. Referenční příručka API také stanovuje poměry referenčního videa mezi 1:4 a 4:1. Dlouhý klip obsahující požadovaný pohyb až na konci je nevhodnou přípravou pro toto pětisekundové vstupní okno.

Dokumentované referenční rozhraní přijímá přímo přístupný zdroj HTTPS, identifikátor nahraného podkladu nebo vložené base64. Příručka uvádí maximální velikosti obrázku 16 MB přes URL a 5 MB vloženě; video nebo zvuk mohou mít až 32 MB přes URL a 16 MB vloženě. Připravte čitelné zdrojové materiály se snadno rozlišitelným důležitým objektem a bez soupeřících pokynů různých referencí. V obrázku prvního snímku zachovejte zamýšlenou orientaci. Tyto vstupní podrobnosti se týkají referenčního postupu výrobce a pomáhají uspořádat tvůrčí materiály pro vybraný režim.

Zvuk režírujte ve stejném zadání jako obraz. Uveďte dialog, hlasový přednes, zvuk místnosti a konkrétní efekty včetně jejich blízkosti či vzdálenosti. Pokud má scéna obsahovat pouze řeč a atmosféru, určete zamýšlené hudební zpracování. Příručka jako plánovací odhad navrhuje přibližně 2.5 mluveného slova za sekundu, proto ponechte prostor pro pauzy a viditelnou akci. Krátký úvod lze naplánovat jako jednu repliku následovanou okamžikem odhalení produktu. Poslechněte skutečná slova a ověřte, zda generovaný zvuk odpovídá prostoru a akci.

Výstupní délka se vybírá v celých sekundách od pěti do patnácti s výchozími pěti sekundami. Rozlišení je velikostní třída: 480p, 768p, 1080p nebo 2k. Dokumentované volby rámování jsou 21:9, 16:9, 4:3, 1:1, 3:4 a 9:16. U převodu textu a referencí na video při 1080p nebo 2k vyberte 16:9 nebo 9:16; adaptivní referenční rámování je dokumentováno při 480p a 768p. Převod obrázku na video sleduje proporce prvního obrázku, proto při změně požadovaného tvaru ořízněte vstup před generováním. Ověřte skutečné rozměry hotového výsledku, místo předpokladu, že označení velikostní třídy znamená jednu běžnou dvojici pixelů.

Modelová příručka stanovuje video MP4 s obrazovým kódováním H.264 a stereofonním zvukem AAC při 32 kHz. Generování se zpracovává asynchronně a dokončený úkol dodává umístění přehratelného videa, délku a rozměry. Podepsané umístění videa lze obnovit opětovným načtením úkolu. Skutečný klip, referenční materiály a zadání uchovejte pro střihovou kontrolu. Čekající nebo zpracovávaný záznam sleduje generování; hotové video je produkčním výstupem k posouzení obrazu, řeči a zvuku.

Výrobce dokumentuje volby vylepšení promptu turbo, quality a disabled; disabled ponechává připravené znění tak, jak bylo napsáno. Pevný seed se hodí při porovnávání změny jedné věty při zachování ostatních vstupů. Vybraný seed a nastavení zaznamenejte se zadáním záběru. U nápisů v obraze udržujte zamýšlenou frázi krátkou a přesně ji zapište; příručka doporučuje odstavce, drobný text a označené diagramy skládat dodatečně. U generovaného titulku kontrolujte každý viditelný znak, místo předpokladu správného reprodukování znění.

Příručka označuje za méně spolehlivé oblasti dlouhý text na obrazovce, jemný organický pohyb okvětních lístků, papíru nebo vlasů a manipulaci rukou v detailu. U vysvětlení postupu nechte jasně napsanou repliku sdělit kroky a obrazem ukažte stabilní osobu nebo předmět; má-li být samotná fyzická operace přesná, použijte samostatně ověřené vizuály. Celý záběr zkontrolujte z hlediska návaznosti předmětů, kontaktu, detailů tváře a rukou, dialogu i zvuku. Stručný seznam změn pro další verzi udržuje podrobné produkční zadání praktické.

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

[`heygen/heygen-video-1`](https://ailoot.ai/models/cs/#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 sekund s dialogem, atmosférou a efekty z textu, prvního obrázku nebo vizuálních a zvukových referencí. Jeho univerzální model heygen-video-1 podporuje produktové záběry i postavy, s referenčním ovládáním a výstupem MP4. Jasné, ohraničené akce mu dávají užitečné produkční zadání.

Přijímané vstupy

Text · Obrázky · Zvuk · Video

Výsledky

Video

### Dostupné v Ailoot · vstupy a metody

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

Vstup

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

Výstup

`video`

Výstupní formát

původní bajty MP4; bez normalizace a překódování

| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
| --- | --- | --- | --- | --- |
| Pole`model` | Typ`string` | PožadavekPovinné | Hodnoty a limity heygen/heygen-video-1 | Výchozí— |
| Pole`prompt` | Typ`string` | PožadavekPovinné | Hodnoty a limity | Výchozí— |
| Pole`duration` | Typ`integer` | PožadavekPovinné | Hodnoty a limity 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600 | Výchozí— |
| Pole`resolution` | Typ`string` | PožadavekVolitelné | Hodnoty a limity 480p, 768p, 2K | Výchozí— |
| Pole`aspect_ratio` | Typ`string` | PožadavekVolitelné | Hodnoty a limity 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Výchozí— |
| Pole`generate_audio` | Typ`boolean` | PožadavekVolitelné | Hodnoty a limity false | Výchozí— |
| Pole`frame_images` | Typ`array` | PožadavekVolitelné | Hodnoty a limity Minimální počet položek: 1 Maximální počet položek: 1 Vstupní obsah: Pole objektů snímků. Každý objekt obsahuje type=image\_url, image\_url obsahující url a frame\_type. Použijte HTTPS URL obrázku a nastavte frame\_type na first\_frame. Každá role snímku se smí vyskytnout nejvýše jednou. Přesné klíče: type, image\_url, frame\_type Podmínky: Tyto klíče popisují každý objekt snímku; image\_url obsahuje pouze url. Pro požadavek obsahující pouze text vynechte frame\_images. | Výchozí— |
| Pole`input_references` | Typ`array` | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
| Pole`seed` | Typ`integer` | PožadavekVolitelné | Hodnoty a limity Minimum: -9 223 372 036 854 775 808 Maximum: 9 223 372 036 854 775 807 | Výchozí— |
| Pole`callback_url` | Typ`string` | PožadavekVolitelné | Hodnoty a limity Vzor: ^https:// | Výchozí— |
| Pole`session_id` | Typ`string` | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
| Pole`trace` | Typ`object` | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
| Pole`user` | Typ`string` | PožadavekVolitelné | Hodnoty a limity | Výchozí— |

Kombinace vstupních materiálů

**Text na video** · Textové zadání. · Povinné: model, prompt, duration

`Zadejte prompt jako text a duration v celých sekundách. Vyberte podporované rozlišení a případně poměr stran.`

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

`prompt`: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano

**Obrázek na video** · Textové zadání a obrázek prvního snímku. · Povinné: model, prompt, duration, frame\_images

`frame_images je pole. Každý objekt snímku obsahuje type, image_url a frame_type; image_url obsahuje url. Nastavte type na image_url. Použijte first_frame. Každá role snímku se smí vyskytnout nejvýše jednou. Pro každý snímek zadejte veřejnou HTTPS URL obrázku. Zvolte podporované rozlišení a případně poměr stran.`

Přesné klíče: type, image\_url, frame\_type

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

`prompt`: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano

**Reference to video** · Textové zadání a podporované obrazové, video a zvukové reference. · Povinné: model, prompt, duration, input\_references

`input_references je pole objektů. Nastavte type na image_url, video_url nebo audio_url a použijte odpovídající pole obsahující url. Používejte veřejné HTTPS URL. Vynecháním frame_images zvolíte režim referencí. Vyberte podporované rozlišení a případně poměr stran.`

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

`prompt`: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano

Parametry a životní cyklus metody

| Parametr | Kontrakt |
| --- | --- |
| Parametr`content_type` | Kontraktapplication/json |
| Parametr`required` | Kontraktmodel, prompt, duration |
| Parametr`material_types` | Kontrakttext, image, audio, video |
| Parametr`additional_properties` | Kontraktfalse |
| Parametr`optional_controls` | Kontraktresolution, 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`

### Tarify

##### Jak se vypočítá konečný poplatek

Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.

Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.

Rychlý režim

Neuvedeno Při výběru rychlého režimu

Režim flex

Neuvedeno Při výběru režimu flex

Maximální intenzita uvažování

Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)

#### Odhadované sazby pro srovnání

#### Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

| Konfigurace | Tabulka sazeb | Předpokládané množství | Účtovací jednotka | Podmínky účtování | Poplatek |
| --- | --- | --- | --- | --- | --- |
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Předpokládané množství— | Účtovací jednotka— | Podmínky účtování— | Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání **—** / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání **—** / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání **—** / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání **—** / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání **—** / 1K tokenů |
| KonfiguraceCena videa | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza sekundu videa | Podmínky účtováníresolution: 2k | Poplatek Výstup · Cena videa · Odhad pouze pro srovnání **$0.2** za sekundu videa |
| KonfiguraceCena videa | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza sekundu videa | Podmínky účtováníresolution: 480p | Poplatek Výstup · Cena videa · Odhad pouze pro srovnání **$0.04** za sekundu videa |
| KonfiguraceCena videa | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza sekundu videa | Podmínky účtováníresolution: 768p | Poplatek Výstup · Cena videa · Odhad pouze pro srovnání **$0.072** za sekundu videa |
| KonfiguraceCena videa | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza sekundu videa | Podmínky účtovánírežim generování: reference; rozlišení: 2k | Poplatek Výstup · Cena videa · Odhad pouze pro srovnání **$0.36** za sekundu videa |
| KonfiguraceCena videa | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza sekundu videa | Podmínky účtovánírežim generování: reference; rozlišení: 480p | Poplatek Výstup · Cena videa · Odhad pouze pro srovnání **$0.14** za sekundu videa |
| KonfiguraceCena videa | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza sekundu videa | Podmínky účtovánírežim generování: reference; rozlišení: 768p | Poplatek Výstup · Cena videa · Odhad pouze pro srovnání **$0.2** za sekundu videa |
| Konfiguracereferenční vstupní obrázek | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza vstupní referenční obrázek | Podmínky účtování— | Poplatek Vstup · referenční vstupní obrázek · Odhad pouze pro srovnání **$0.08** za vstupní referenční obrázek |
| KonfiguraceOdhadovaná cena generování | Tabulka sazeb— | Předpokládané množstvíodhad pro jedno generování | Účtovací jednotka— | Podmínky účtování— | Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání **$0.2** odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování. |

Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. [Jak funguje rezervace a vyúčtování →](https://ailoot.ai/docs/cs/billing/reserve/)

#### Podrobnosti referenčního tarifu

Referenční tabulky modelu nemění výběr metody, cenové nabídky ani poplatky. Skutečné poplatky používají sazby vybrané metody Ailoot.

Cenové reference konfigurací videa

#### Ceny podle konfigurace

Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.

| Konfigurace | Podmínky účtování | Poplatek |
| --- | --- | --- |
| KonfiguraceCena videa | Podmínky účtováníresolution: 2k | Poplatek Výstup · Cena videa **$0.18** za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci. |
| KonfiguraceCena videa | Podmínky účtováníresolution: 480p | Poplatek Výstup · Cena videa **$0.04** za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci. |
| KonfiguraceCena videa | Podmínky účtováníresolution: 768p | Poplatek Výstup · Cena videa **$0.06** za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci. |
| KonfiguraceCena videa | Podmínky účtovánírežim generování: reference; rozlišení: 2k | Poplatek Výstup · Cena videa **$0.36** za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci. |
| KonfiguraceCena videa | Podmínky účtovánírežim generování: reference; rozlišení: 480p | Poplatek Výstup · Cena videa **$0.08** za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci. |
| KonfiguraceCena videa | Podmínky účtovánírežim generování: reference; rozlišení: 768p | Poplatek Výstup · Cena videa **$0.12** za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci. |

### Příklady požadavků

#### Ailoot Ultra · Video

curl · vytvořte 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
```

### Přijímání a ukládání výsledků

#### Ailoot Ultra · Video

podepsané URL obsahu spravovaného službou

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

##### Ověřit stav úlohy

Získat stav původní operace pomocí GET

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

Další načtení obsahu

Uložte každý dokončený výstup, který vám patří

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

##### Uchovejte všechny dokončené výsledky

Uložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.

Uchovejte každý skutečný výstup spravovaný službou a jeho vrácená metadata s naměřenými hodnotami.

##### Pokud je nutné ověřit původní odpověď

503 result\_pending\_check + původní id + X-Should-Retry:false; původní požadavek nikdy neopakujte

Pole odpovědi

| Pole | Typ | Význam |
| --- | --- | --- |
| Pole`index` | Typinteger | VýznamPozice tohoto videa v seznamu výstupů, číslovaná od nuly. |
| Pole`content_url` | Typstring | VýznamPodepsaná HTTPS URL pro stažení tohoto dokončeného videa. |
| Pole`sha256` | Typstring \| null | VýznamOtisk SHA-256 původních bajtů videa; null, není-li dostupný. |
| Pole`size_bytes` | Typinteger \| null | VýznamVelikost původního videosouboru v bajtech; null, není-li dostupná. |
| Pole`duration_ms` | Typinteger \| null | VýznamNaměřená délka videa v milisekundách; null, není-li dostupná. |
| Pole`width` | Typinteger \| null | VýznamŠířka videa v pixelech; null, není-li dostupná. |
| Pole`height` | Typinteger \| null | VýznamVýška videa v pixelech; null, není-li dostupná. |
| Pole`video_codec` | Typstring \| null | VýznamIdentifikátor video kodeku; null, není-li zaznamenán. |
| Pole`has_audio` | Typboolean \| null | VýznamZda video obsahuje zvukovou stopu; null, nebylo-li změřeno. |
| Pole`audio_codec` | Typstring \| null | VýznamIdentifikátor zvukového kodeku; null, není-li žádný identifikátor zaznamenán. |

Chyby a další kroky

| Odpověď | Podmínka | Další krok |
| --- | --- | --- |
| Odpověď404 · `not_found_error` | PodmínkaPřístup k videu není dostupný nebo toto ID videa nebylo nalezeno. | Další krokZkontrolujte přístup k videu. U existujícího videa použijte jeho původní veřejné ID a stejný klíč API. |
| Odpověď401 · `authentication_error` | PodmínkaKlíč API neodpovídá ověřenému účtu. | Další krokPřed odesláním zkontrolujte svůj klíč API a přístup k účtu. |
| Odpověď400 · `invalid_request_error` | PodmínkaPožadavek se nepodařilo načíst nebo je index pro stažení neplatný. | Další krokOpravte tělo požadavku. Pro stažení vyberte index výstupu vrácený původní úlohou. |
| Odpověď422 · `price_unavailable` | PodmínkaVybranou konfiguraci videa nelze ocenit. | Další krokPřed odesláním opraveného požadavku zvolte podporovanou konfiguraci videa a vyplňte její povinné volby. |
| Odpověď422 · `invalid_request_error` | PodmínkaVstup videa nebo původní úloha pro pokračování jsou neplatné. | Další krokPoužívejte platné HTTPS vstupy. Pro pokračování použijte původní veřejné ID svého dokončeného videa se stejným klíčem API. |
| Odpověď402 · `billing_error` | PodmínkaDostupný zůstatek nebo limity neumožňují rezervaci. | Další krokPřed odesláním nového požadavku zkontrolujte dostupný zůstatek a limity. |
| Odpověď503 · `server_error` | PodmínkaOvěřování videa, úložiště nebo přístup ke službě jsou dočasně nedostupné. | Další krokPočkejte na dostupnost služby. Pokud už máte ID videa, kontrolujte tuto původní úlohu místo vytváření dalšího generování. |
| Odpověď503 · `result_pending_check` | PodmínkaPůvodní výsledek videa a vyúčtovanou částku je třeba zkontrolovat. | Další krokUchovejte vrácené ID videa a kontrolujte tuto úlohu. Dokud probíhá kontrola, neposílejte náhradní požadavek na generování. |
| Odpověď503 · `owned_result_unavailable` | PodmínkaStávající video je dočasně nedostupné ke stažení. | Další krokPozději zkontrolujte tutéž úlohu videa a stáhněte její existující výstup. Nové generování vytvoří samostatnou operaci. |
| Odpověď409 · `video_not_ready` | PodmínkaObsah videa nebyl zveřejněn. | Další krokZkontrolujte stav původní úlohy. Stáhněte výstup, až nahlásí completed; nahlásí-li failed, řiďte se jejím upozorněním na kontrolu vyúčtování. |

### Aliasy

#### Aliasy modelu

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

#### Aliasy cest metod

Použijte cesty metod uvedené výše.

#### Související ID modelů

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

FAQ · HeyGen: HeyGen Video

Jaké vstupy a výsledky jsou dostupné?

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

Jaká pole požadavek používá?

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

Jaké limity platí?

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

Připojte Ailoot k Claude Code, OpenCode, Hermes nebo vlastní aplikaci.

## Společnost a její portfolio projektů

Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.

## Nakupujte tokeny se slevou.

Sleva předplatného pro pravidelnou práci. Promo kódy až 50% na nákup tokenů.

Předplatné

Pro pravidelné požadavky vyberte tarif se slevou.

Promo kód až 50%

Při nákupu zadejte kód. Cena se přepočítá podle probíhající akce.

Výdaje v historii

U každého požadavku se uloží model, tokeny a částka.

[Vybrat předplatné](https://ailoot.ai/docs/cs/billing/subscriptions/) · [Zobrazit ceny modelů](https://ailoot.ai/models/cs/)

## Připojte API k produktu, který prodáváte.

SaaS, aplikace a boti podle nabídky a licenční smlouvy Ailoot. Pro přeprodej požádejte o licenci přeprodejce.

Komerční aplikace

Začleňte generování textu, obrázků, videa a zvuku do placených funkcí své služby.

Licence pro přeprodejce

Pošlete popis projektu a způsob poskytování přístupu. Vyžádejte písemné podmínky použití a přeprodeje.

Dokumenty na webu

Nabídka, licenční smlouva a zásady zpracování dat jsou dostupné před připojením.

[Požádat o licenci přeprodejce](mailto:support@ailoot.ai) · [Nabídka a licenční smlouva](https://ailoot.ai/legal/offer?lang=cs)

## Ailoot · Společnost a její portfolio projektů





Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI.





Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.





Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.