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

# HeyGen: HeyGen Video

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

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

HeyGen Video iš teksto, pirmojo vaizdo arba vaizdo ir garso orientyrų generuoja 5–15 sekundžių scenas su dialogu, aplinkos garsais ir efektais. Jo bendros paskirties heygen-video-1 modelis palaiko produktų bei personažų planus, orientyrų valdiklius ir MP4 išvestį. Aiškūs, apibrėžti veiksmai suteikia jam naudingą gamybos užduotį.

- [**Ailoot Ultra · Vaizdo įrašai** `POST /v1/videos` `heygen/heygen-video-1`](https://ailoot.ai/models/lt/heygen-heygen-video-1/#method-0)

Apie modelį

Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.

HeyGen Video yra HeyGen bendros paskirties scenų generavimo modelis, gamintojo identifikuojamas kaip heygen-video-1. Pagal kūrybinę užduotį jis kartu kuria objektą, aplinką, šviesą ir garsą. Kiekvienas klipas trunka 5–15 sekundžių ir turi sugeneruotą garso takelį, įskaitant dialogą, aplinkos garsus bei efektus. Naudinga gamybos įvestis apima scenos aprašymą, produkto nuotrauką arba medžiagą, nustatančią žmogų, vietą ar judesį. Gautas failas yra trumpa scena produkto pristatymui, įvadiniam intarpui, nekilnojamojo turto vaizdui ar kitam montuojamam vaizdo darbui.

Trys režimai suteikia įvestims skirtingus vaidmenis. Kūrimas iš teksto kuria sceną pagal užklausą. Kūrimas iš vaizdo prasideda tiksliai pateiktu vaizdu, tada vykdo veiksmo užduotį. Kūrimas iš orientyrų naudoja pateiktus vaizdus, vaizdo įrašus ir pasirenkamą garsą naujai komponuojamai scenai nukreipti; jam reikia bent vieno orientyrinio vaizdo arba vaizdo įrašo. Pirmojo kadro vaizdą rinkitės tada, kai pradžios kompozicija turi sutapti su nuotrauka, o orientyrus – kai žinomas daiktas turi atsirasti kitoje kompozicijoje. Šis scenų modelis skiriasi nuo HeyGen avatarų atvaizdavimo variklių ir Video Agent kompozicijos eigos.

Gamintojo vadovas teikia pirmenybę išsamiems, konkretiems plano nurodymams: vienas objektas, viena vieta ir vienas apibrėžtas veiksmas, naudojant fiksuotą arba švelniai judančią kamerą. Aprašykite kameros padėtį, objektyvo arba ryškumo gylio sumanymą, šviesą, paviršiaus tekstūrą ir spalvų stilistiką. Paaiškinkite, kur objektai liečiasi, kai veiksmas priklauso nuo sąlyčio. Originaliam produkto pavyzdžiui naudokite orientyrinę kelioninio termoso nuotrauką ir paprašykite, kad jis stovėtų ant medinio stalviršio, šalia kalbant pristatytojui, kamerai truputį artėjant prie termoso. Rezultate patikrinkite termoso formą, vietą ir matomą žymėjimą.

Orientyrų sąrašai palaiko iki devynių vaizdų, trijų vaizdo įrašų ir trijų garso elementų, iš viso daugiausia dvylika orientyrų. Vaizdai, vaizdo įrašai ir garsas gamintojo užklausos formate numeruojami atskirai: pirmas vaizdas yra \<Picture 1\>, o pirmas vaizdo įrašas – \<Video 1\>. Kiekvienam orientyrui suteikite vaidmenį ir jį aiškiai įvardykite užduotyje. Modelis skaito pirmąsias penkias kiekvieno orientyrinio vaizdo įrašo sekundes, todėl svarbią atkarpą paruoškite pradžioje. API žinynas taip pat nurodo orientyrinio vaizdo proporcijas nuo 1:4 iki 4:1. Ilgas klipas, kuriame norimas judesys yra tik pabaigoje, netinka šiam penkių sekundžių įvesties langui.

Dokumentuota orientyrų sąsaja priima tiesiogiai pasiekiamą HTTPS išteklių, įkelto failo identifikatorių arba įterptą base64. Vadove nurodyti maksimalūs vaizdų dydžiai: 16 MB pateikiant URL ir 5 MB įterpiant; vaizdo arba garso failai gali būti iki 32 MB per URL ir 16 MB įterpti. Paruoškite aiškią pradinę medžiagą, kurioje svarbus objektas lengvai atskiriamas, o skirtingi orientyrai nepateikia konkuruojančių nurodymų. Pirmojo kadro vaizde išlaikykite norimą orientaciją. Šios įvesties detalės taikomos gamintojo orientyrų eigai ir padeda sutvarkyti kūrybinę medžiagą pasirinktam režimui.

Garsą režisuokite toje pačioje užduotyje kaip vaizdą. Nurodykite dialogą, balso atlikimą, patalpos foną ir konkrečius efektus, įskaitant tai, ar garsas turi skambėti arti, ar toli. Jei scenoje turi būti tik kalba ir aplinkos garsai, aprašykite norimą muzikos naudojimą. Vadovas siūlo planuojant skaičiuoti maždaug 2,5 tariamo žodžio per sekundę, todėl palikite laiko pauzėms ir matomam veiksmui. Trumpą įžangą galima suplanuoti kaip vieną repliką, po kurios seka produkto atskleidimo akimirka. Klausykite tikrųjų žodžių ir ar sugeneruotas garsas dera prie erdvės bei veiksmo.

Rezultato trukmė pasirenkama sveikomis sekundėmis nuo penkių iki penkiolikos, numatytoji – penkios sekundės. Raiška yra dydžio klasė: 480p, 768p, 1080p arba 2k. Dokumentuoti kadravimo variantai yra 21:9, 16:9, 4:3, 1:1, 3:4 ir 9:16. Kuriant iš teksto arba orientyrų 1080p ar 2k raiška, rinkitės 16:9 arba 9:16; prisitaikantis orientyrų kadravimas dokumentuotas 480p ir 768p raiškoms. Kūrimas iš vaizdo seka pirmojo vaizdo proporcijas, todėl apkirpkite prieš generavimą, kai reikia kitos formos. Peržiūrėkite tikruosius užbaigto rezultato matmenis, užuot manę, kad dydžio klasės žyma reiškia vieną įprastą pikselių porą.

Modelio vadovas nurodo MP4 vaizdą su H.264 vaizdo kodavimu ir AAC 32 kHz stereogarsu. Generavimas apdorojamas asinchroniškai, o užbaigta užduotis pateikia paleidžiamo vaizdo vietą, trukmę bei matmenis. Pasirašytą vaizdo vietą galima atnaujinti dar kartą gaunant užduotį. Išsaugokite patį klipą, orientyrinę medžiagą ir užduotį montažo peržiūrai. Laukimo ar apdorojimo įrašas seka generavimą; užbaigtas vaizdo įrašas yra gamybos rezultatas, kurio vaizdą, kalbą ir garsą reikia įvertinti.

Gamintojas dokumentuoja užklausos pagerinimo pasirinkimus turbo, quality ir disabled; disabled išlaiko paruoštą formuluotę tokią, kokia parašyta. Fiksuotas pradinis atsitiktinumo skaičius naudingas lyginant vienos frazės pakeitimą, išlaikant kitas įvestis. Pasirinktą skaičių ir nustatymus įrašykite su plano užduotimi. Ekrano užrašams norimą frazę laikykite trumpą ir parašykite tiksliai; vadovas rekomenduoja pastraipas, smulkų tekstą ir pažymėtas diagramas įkomponuoti vėliau. Sugeneruotame pavadinime patikrinkite kiekvieną matomą simbolį, užuot manę, kad tekstas atkartotas teisingai.

Vadovas kaip mažiau patikimas sritis įvardija ilgą ekrano tekstą, švelnų organinį judėjimą, pavyzdžiui, žiedlapių, popieriaus ar plaukų, ir smulkius rankų veiksmus iš arti. Procedūriniam paaiškinimui leiskite aiškiai parašytai replikai perteikti žingsnius, o vaizde rodykite stabilų žmogų arba daiktą; kai pats fizinis veiksmas turi būti tikslus, naudokite atskirai patikrintus vaizdus. Peržiūrėkite visą planą pagal daikto vientisumą, sąlytį, veido bei rankų detales, dialogą ir garsą. Trumpas sąrašas to, ką keisti kitame bandyme, išlaiko išsamią gamybos užduotį praktišką.

**Ailoot Ultra · Vaizdo įrašai** `POST /v1/videos` `heygen/heygen-video-1`

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

HeyGen /`heygen/heygen-video-1`

### Pradžia

HeyGen Video iš teksto, pirmojo vaizdo arba vaizdo ir garso orientyrų generuoja 5–15 sekundžių scenas su dialogu, aplinkos garsais ir efektais. Jo bendros paskirties heygen-video-1 modelis palaiko produktų bei personažų planus, orientyrų valdiklius ir MP4 išvestį. Aiškūs, apibrėžti veiksmai suteikia jam naudingą gamybos užduotį.

Leidžiamos įvestys

Tekstas · Vaizdai · Garsas · Vaizdo įrašai

Rezultatai

Vaizdo įrašai

### Prieinama Ailoot · įvestys ir metodai

**Ailoot Ultra · Vaizdo įrašai** `POST /v1/videos`

Įvestis

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

Išvestis

`video`

Išvesties formatas

originalūs MP4 baitai; be normalizavimo ar perkodavimo

| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
| --- | --- | --- | --- | --- |
| Laukas`model` | Tipas`string` | ReikalavimasPrivaloma | Reikšmės ir ribos heygen/heygen-video-1 | Numatyta— |
| Laukas`prompt` | Tipas`string` | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
| Laukas`duration` | Tipas`integer` | ReikalavimasPrivaloma | Reikšmės ir ribos 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Mažiausia reikšmė: 1 Didžiausia reikšmė: 600 | Numatyta— |
| Laukas`resolution` | Tipas`string` | ReikalavimasNeprivaloma | Reikšmės ir ribos 480p, 768p, 2K | Numatyta— |
| Laukas`aspect_ratio` | Tipas`string` | ReikalavimasNeprivaloma | Reikšmės ir ribos 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Numatyta— |
| Laukas`generate_audio` | Tipas`boolean` | ReikalavimasNeprivaloma | Reikšmės ir ribos false | Numatyta— |
| Laukas`frame_images` | Tipas`array` | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausias elementų skaičius: 1 Didžiausias elementų skaičius: 1 Įvesties turinys: Kadrų objektų masyvas. Kiekviename objekte yra type=image\_url, image\_url su url ir frame\_type. Naudokite HTTPS paveikslėlio URL ir nustatykite frame\_type reikšmę first\_frame. Kiekviena kadro paskirtis nurodoma daugiausia vieną kartą. Tikslūs raktai: type, image\_url, frame\_type Sąlygos: Šie raktai apibūdina kiekvieną kadro objektą; image\_url turi tik url. Jei užklausoje yra tik tekstas, praleiskite frame\_images. | Numatyta— |
| Laukas`input_references` | Tipas`array` | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
| Laukas`seed` | Tipas`integer` | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: −9 223 372 036 854 775 808 Didžiausia reikšmė: 9 223 372 036 854 775 807 | Numatyta— |
| Laukas`callback_url` | Tipas`string` | ReikalavimasNeprivaloma | Reikšmės ir ribos Šablonas: ^https:// | Numatyta— |
| Laukas`session_id` | Tipas`string` | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
| Laukas`trace` | Tipas`object` | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
| Laukas`user` | Tipas`string` | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |

Įvesties medžiagos deriniai

**Iš teksto į vaizdo įrašą** · Tekstinė užklausa. · Privaloma: model, prompt, duration

`Pateikite prompt kaip tekstą ir duration sveikomis sekundėmis. Pasirinkite palaikomą skiriamąją gebą ir, jei reikia, kraštinių santykį.`

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

`prompt`: Tipas: string · Didžiausias UTF-8 baitų skaičius: 10 000 · Būtinas bent vienas simbolis, nepriskiriamas tarpų simboliams: Taip

**Iš vaizdo į vaizdo įrašą** · Tekstinė užklausa ir pirmojo kadro paveikslėlis. · Privaloma: model, prompt, duration, frame\_images

`frame_images yra masyvas. Kiekviename kadro objekte yra type, image_url ir frame_type; image_url turi url lauką. Nustatykite type reikšmę image_url. Naudokite first_frame. Kiekviena kadro paskirtis gali būti nurodyta daugiausia vieną kartą. Kiekvienam kadrui pateikite viešą HTTPS paveikslėlio URL. Pasirinkite palaikomą skiriamąją gebą ir, jei reikia, kraštinių santykį.`

Tikslūs raktai: type, image\_url, frame\_type

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

`prompt`: Tipas: string · Didžiausias UTF-8 baitų skaičius: 10 000 · Būtinas bent vienas simbolis, nepriskiriamas tarpų simboliams: Taip

**Reference to video** · Tekstinė užklausa ir palaikoma pavyzdinė medžiaga: paveikslėliai, vaizdo įrašai, garsas. · Privaloma: model, prompt, duration, input\_references

`input_references yra objektų masyvas. Nustatykite type reikšmę image_url, video_url, audio_url ir naudokite atitinkamą lauką su url. Naudokite viešus HTTPS URL. Kad pasirinktumėte pavyzdinės medžiagos režimą, praleiskite frame_images. Pasirinkite palaikomą skiriamąją gebą ir, jei reikia, kraštinių santykį.`

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

`prompt`: Tipas: string · Didžiausias UTF-8 baitų skaičius: 10 000 · Būtinas bent vienas simbolis, nepriskiriamas tarpų simboliams: Taip

Metodo parametrai ir gyvavimo ciklas

| Parametras | Specifikacija |
| --- | --- |
| Parametras`content_type` | Specifikacijaapplication/json |
| Parametras`required` | Specifikacijamodel, prompt, duration |
| Parametras`material_types` | Specifikacijatext, image, audio, video |
| Parametras`additional_properties` | Specifikacijafalse |
| Parametras`optional_controls` | Specifikacijaresolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, seed, callback\_url, session\_id, trace, user |

Gyvavimo ciklas: `submit_once_poll_original`

`GET /v1/videos/{public_id}`

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

### Planai

##### Kaip apskaičiuojamas galutinis mokestis

Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.

Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.

Spartusis režimas

Nenurodyta Pasirinkus spartųjį režimą

Flex režimas

Nenurodyta Pasirinkus flex režimą

Didžiausios samprotavimo pastangos

Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)

#### Numatomi įkainiai palyginimui

#### Kainos pagal konfigūraciją

Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.

| Konfigūracija | Įkainių lentelė | Numatomas kiekis | Apskaitos vienetas | Apmokestinimo sąlygos | Mokestis |
| --- | --- | --- | --- | --- | --- |
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Numatomas kiekis— | Apskaitos vienetas— | Apmokestinimo sąlygos— | Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui **—** / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui **—** / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui **—** / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui **—** / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui **—** / 1K tokenų |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosresolution: 2k | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui **$0.2** už vaizdo įrašo sekundę |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosresolution: 480p | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui **$0.04** už vaizdo įrašo sekundę |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosresolution: 768p | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui **$0.072** už vaizdo įrašo sekundę |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosgeneravimo režimas: reference; skiriamoji geba: 2k | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui **$0.36** už vaizdo įrašo sekundę |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosgeneravimo režimas: reference; skiriamoji geba: 480p | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui **$0.14** už vaizdo įrašo sekundę |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosgeneravimo režimas: reference; skiriamoji geba: 768p | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui **$0.2** už vaizdo įrašo sekundę |
| Konfigūracijareferencinis įvesties vaizdas | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž pavyzdinį įvesties vaizdą | Apmokestinimo sąlygos— | Mokestis Įvestis · referencinis įvesties vaizdas · Įvertis tik palyginimui **$0.08** už pavyzdinį įvesties vaizdą |
| KonfigūracijaNumatoma generavimo kaina | Įkainių lentelė— | Numatomas kiekisvieno generavimo įvertis | Apskaitos vienetas— | Apmokestinimo sąlygos— | Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui **$0.2** įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis. |

Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. [Kaip veikia rezervavimas ir atsiskaitymas →](https://ailoot.ai/docs/lt/billing/reserve/)

#### Informacinio tarifo duomenys

Modelio informacinės lentelės nekeičia metodo pasirinkimo, kainos įverčių ar mokesčių. Galiojantys mokesčiai nustatomi pagal pasirinkto Ailoot metodo įkainius.

Vaizdo įrašo konfigūracijų kainų nuorodos

#### Kainos pagal konfigūraciją

Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.

| Konfigūracija | Apmokestinimo sąlygos | Mokestis |
| --- | --- | --- |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosresolution: 2k | Mokestis Išvestis · Vaizdo įrašo kaina **$0.18** už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosresolution: 480p | Mokestis Išvestis · Vaizdo įrašo kaina **$0.04** už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosresolution: 768p | Mokestis Išvestis · Vaizdo įrašo kaina **$0.06** už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosgeneravimo režimas: reference; skiriamoji geba: 2k | Mokestis Išvestis · Vaizdo įrašo kaina **$0.36** už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosgeneravimo režimas: reference; skiriamoji geba: 480p | Mokestis Išvestis · Vaizdo įrašo kaina **$0.08** už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosgeneravimo režimas: reference; skiriamoji geba: 768p | Mokestis Išvestis · Vaizdo įrašo kaina **$0.12** už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |

### Užklausų pavyzdžiai

#### Ailoot Ultra · Vaizdo įrašai

curl · sukurkite vaizdo įrašą

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

### Gauti ir išsaugoti rezultatus

#### Ailoot Ultra · Vaizdo įrašai

pasirašyti jums priklausančio turinio URL

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

##### Tikrinti užduoties būseną

GET pirminės operacijos būsena

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

Kito turinio skaitymas

Išsaugoti kiekvieną jums priklausančią baigtą išvestį

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

##### Išsaugoti visus baigtus rezultatus

Išsaugokite kiekvieną baigtą vaizdo įrašą arba grąžintą failą; gaukite turinį iš kiekvieno faktiškai grąžinto medžiagos URL.

Išsaugokite kiekvieną tikrą jums priklausantį rezultatą ir grąžintus išmatuotus jo metaduomenis.

##### Jei reikia patikrinti pradinį atsakymą

503 result\_pending\_check + pradinis id + X-Should-Retry:false; niekada nekartokite pradinės užklausos

Atsakymo laukai

| Laukas | Tipas | Reikšmė |
| --- | --- | --- |
| Laukas`index` | Tipasinteger | ReikšmėŠio vaizdo įrašo pozicija rezultatų sąraše, skaičiuojama nuo nulio. |
| Laukas`content_url` | Tipasstring | ReikšmėPasirašytas HTTPS atsisiuntimo URL šiam užbaigtam vaizdo įrašui. |
| Laukas`sha256` | Tipasstring \| null | ReikšmėPradinio vaizdo įrašo baitų SHA-256 santrauka; null, jei nepasiekiama. |
| Laukas`size_bytes` | Tipasinteger \| null | ReikšmėPradinio vaizdo įrašo failo dydis baitais; null, jei nepasiekiamas. |
| Laukas`duration_ms` | Tipasinteger \| null | ReikšmėIšmatuota vaizdo įrašo trukmė milisekundėmis; null, jei nepasiekiama. |
| Laukas`width` | Tipasinteger \| null | ReikšmėVaizdo įrašo plotis pikseliais; null, jei nepasiekiamas. |
| Laukas`height` | Tipasinteger \| null | ReikšmėVaizdo įrašo aukštis pikseliais; null, jei nepasiekiamas. |
| Laukas`video_codec` | Tipasstring \| null | ReikšmėVaizdo kodeko identifikatorius; null, jei neužregistruotas. |
| Laukas`has_audio` | Tipasboolean \| null | ReikšmėAr vaizdo įraše yra garso takelis; null, jei nenustatyta. |
| Laukas`audio_codec` | Tipasstring \| null | ReikšmėGarso kodeko identifikatorius; null, kai identifikatorius neužregistruotas. |

Klaidos ir tolesni veiksmai

| Atsakymas | Sąlyga | Kitas žingsnis |
| --- | --- | --- |
| Atsakymas404 · `not_found_error` | SąlygaPrieiga prie vaizdo įrašo nepasiekiama arba šis vaizdo įrašo ID nerastas. | Kitas žingsnisPatikrinkite prieigą prie vaizdo įrašo. Jei vaizdo įrašas jau yra, naudokite jo pradinį viešą ID ir tą patį API raktą. |
| Atsakymas401 · `authentication_error` | SąlygaAPI raktas neatitinka autentifikuotos paskyros. | Kitas žingsnisPrieš pateikdami patikrinkite savo API raktą ir paskyros prieigą. |
| Atsakymas400 · `invalid_request_error` | SąlygaNepavyko nuskaityti užklausos arba atsisiuntimo indeksas netinkamas. | Kitas žingsnisPataisykite užklausos turinį. Atsisiuntimui pasirinkite išvesties indeksą, kurį grąžino pradinė užduotis. |
| Atsakymas422 · `price_unavailable` | SąlygaPasirinktos vaizdo įrašo konfigūracijos kainos nustatyti negalima. | Kitas žingsnisPasirinkite palaikomą vaizdo įrašo konfigūraciją ir prieš pateikdami pataisytą užklausą užpildykite jos privalomas parinktis. |
| Atsakymas422 · `invalid_request_error` | SąlygaVaizdo įrašo įvestis arba pradinė tęsinio užduotis netinkama. | Kitas žingsnisNaudokite tinkamą HTTPS įvestį. Tęsiniui naudokite užbaigto pradinio vaizdo įrašo viešą ID ir tą patį API raktą. |
| Atsakymas402 · `billing_error` | SąlygaTurimas likutis arba limitai neleidžia rezervuoti lėšų. | Kitas žingsnisPrieš siųsdami naują užklausą patikrinkite turimą likutį ir limitus. |
| Atsakymas503 · `server_error` | SąlygaVaizdo įrašo patikra, saugykla arba prieiga prie paslaugos laikinai nepasiekiama. | Kitas žingsnisPalaukite, kol paslauga taps pasiekiama. Jei jau turite vaizdo įrašo ID, tikrinkite tą pradinę užduotį, užuot pradėję kitą generavimą. |
| Atsakymas503 · `result_pending_check` | SąlygaReikia patikrinti pradinį vaizdo įrašo rezultatą ir mokestį. | Kitas žingsnisIšsaugokite grąžintą vaizdo įrašo ID ir tikrinkite tą užduotį. Kol ji tikrinama, nesiųskite ją pakeičiančios generavimo užklausos. |
| Atsakymas503 · `owned_result_unavailable` | SąlygaEsamo vaizdo įrašo atsisiuntimas laikinai nepasiekiamas. | Kitas žingsnisVėliau patikrinkite tą pačią vaizdo įrašo užduotį ir atsisiųskite jos esamą rezultatą. Naujas generavimas sukuria atskirą operaciją. |
| Atsakymas409 · `video_not_ready` | SąlygaVaizdo įrašo turinys nepaskelbtas. | Kitas žingsnisPatikrinkite pradinės užduoties būseną. Atsisiųskite, kai ji praneša completed; jei praneša failed, vadovaukitės jos pranešimu apie mokesčio patikrą. |

### Pseudonimai

#### Modelių pseudonimai

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

#### Metodų kelių pseudonimai

Naudokite aukščiau nurodytus metodų kelius.

#### Susiję ID iškvietimui

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

FAQ · HeyGen: HeyGen Video

Kokios įvestys ir rezultatai prieinami?

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

Kokius laukus naudoja užklausa?

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

Kokie apribojimai taikomi?

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

Prijunkite Ailoot prie Claude Code, OpenCode, Hermes arba savo programos.

## Įmonė ir jos projektų portfelis

Įmonė ir jos projektų portfelis: milijonai klientų; mėnesio pardavimai siekia milijardus.

## Pirkite žetonus su nuolaida.

Prenumeratos nuolaida reguliariam darbui. Kodai — iki 50% žetonų pirkimui.

Prenumerata

Pasirinkite planą su nuolaida reguliarioms užklausoms.

Nuolaidos kodas iki 50%

Įveskite kodą perkant. Kaina perskaičiuojama pagal galiojančios akcijos sąlygas.

Išlaidos istorijoje

Kiekvienai užklausai išsaugomi modelis, žetonai ir suma.

[Pasirinkti prenumeratą](https://ailoot.ai/docs/lt/billing/subscriptions/) · [Peržiūrėti modelių kainas](https://ailoot.ai/models/lt/)

## Prijunkite API prie produkto, kurį parduodate.

SaaS, programos ir botai pagal Ailoot ofertą bei licencijos sutartį. Perpardavimui paprašykite perpardavėjo licencijos.

Komercinė programa

Teksto, vaizdų, video ir garso kūrimą integruokite į mokamas paslaugos funkcijas.

Perpardavėjo licencija

Atsiųskite projekto aprašymą ir prieigos schemą. Paprašykite rašytinių naudojimo ir perpardavimo sąlygų.

Dokumentai svetainėje

Oferta, licencijos sutartis ir duomenų tvarkymo politika prieinamos prieš prisijungiant.

[Paprašyti perpardavėjo licencijos](mailto:support@ailoot.ai) · [Oferta ir licencijos sutartis](https://ailoot.ai/legal/offer?lang=lt)

## Ailoot · Įmonė ir jos projektų portfelis





Ailoot remiasi sukaupta veiklos patirtimi, plačia klientų baze, stabiliomis paslaugomis ir nuolatine KPI kontrole.





Įmonė ir jos projektų portfelis: milijonai klientų; mėnesio pardavimai siekia milijardus.





Ailoot šią veiklos patirtį pritaiko teikdama API prieigą prie DI funkcijų klientų produktuose, agentuose, programose ir automatizavimo sprendimuose.