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

# HeyGen: HeyGen Video

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

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

HeyGen Video iz besedila, prve slike ali vizualnih in zvočnih referenc ustvarja 5–15-sekundne prizore z dialogom, vzdušjem in učinki. Njegov splošnonamenski model heygen-video-1 podpira kadre z izdelki in liki, z nadzorom referenc in izhodom MP4. Jasna, omejena dejanja mu dajejo uporaben produkcijski opis.

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

O modelu

Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.

HeyGen Video je HeyGenov splošnonamenski model za ustvarjanje prizorov, ki ga proizvajalec označuje kot heygen-video-1. Iz ustvarjalnega opisa skupaj ustvari motiv, okolje, svetlobo in zvok. Vsak posnetek je dolg 5–15 sekund in vsebuje ustvarjeno zvočno stezo, vključno z dialogom, ambientalnim zvokom in učinki. Uporabni produkcijski vhodi vključujejo opis prizora, fotografijo izdelka ali gradivo, ki določa osebo, kraj ali gibanje. Nastalo gradivo je kratek prizor za predstavitev izdelka, uvodni vložek, ogled nepremičnine ali drugo montažno video delo.

Trije načini vhodom dodelijo različne vloge. Ustvarjanje iz besedila ustvari prizor iz poziva. Ustvarjanje iz slike se začne dobesedno na priloženi sliki, nato sledi opisu dogajanja. Ustvarjanje iz referenc uporablja priložene slike, video in neobvezen zvok za usmerjanje na novo sestavljenega prizora; zahteva vsaj eno referenčno sliko ali video. Sliko prve sličice izberite, kadar se mora začetna kompozicija ujemati s fotografijo, reference pa, kadar naj znan predmet nastopi v drugačni kompoziciji. Ta model prizorov se razlikuje od HeyGenovih pogonov za izris avatarjev in postopka sestavljanja Video Agent.

Proizvajalčev vodič daje prednost podrobnim, konkretnim navodilom za kader: en motiv, ena lokacija in eno omejeno dejanje, z mirujočo ali nežno premikajočo se kamero. Opišite položaj kamere, objektiv ali namen globinske ostrine, svetlobo, teksturo površin in barvno obdelavo. Pojasnite, kje se predmeti dotikajo, kadar je dejanje odvisno od stika. Pri izvirnem primeru izdelka uporabite referenčno fotografijo potovalne termovke in zahtevajte, da stoji na lesenem pultu, medtem ko ob njej govori voditelj, z majhnim premikom kamere proti termovki. V rezultatu preverite obliko, postavitev in vidne oznake termovke.

Seznami referenc podpirajo do devet slik, tri videe in tri zvočne elemente, skupaj največ dvanajst referenc. Slike, videi in zvok so v proizvajalčevem formatu poziva oštevilčeni ločeno: prva slika je \<Picture 1\>, prvi video pa \<Video 1\>. Vsaki referenci dodelite vlogo in jo v opisu izrecno označite. Model prebere prvih pet sekund vsakega referenčnega videa, zato ustrezni odsek pripravite na začetku. Dokumentacija API določa tudi razmerja referenčnega videa med 1:4 in 4:1. Dolg posnetek, ki želeno gibanje vsebuje šele na koncu, je slaba priprava za to petsekundno vhodno okno.

Dokumentirani referenčni vmesnik sprejme neposredno dostopen vir HTTPS, identifikator naloženega gradiva ali vgrajeni base64. Vodič navaja največje velikosti slik 16 MB prek URL in 5 MB pri vgrajenih podatkih; video ali zvok sta lahko velika do 32 MB prek URL in 16 MB pri vgrajenih podatkih. Pripravite razločno izvorno gradivo, v katerem je pomemben motiv lahko prepoznaven in različne reference ne dajejo nasprotujočih si navodil. Predvideno usmerjenost ohranite v sliki prve sličice. Te vhodne podrobnosti zadevajo proizvajalčev referenčni postopek in pomagajo organizirati ustvarjalno gradivo za izbrani način.

Zvok usmerjajte v istem opisu kot sliko. Navedite dialog, govorno izvedbo, zvok prostora in določene učinke, vključno s tem, ali naj bo zvok blizu ali oddaljen. Določite želeno obravnavo glasbe, kadar naj prizor vsebuje samo govor in ambientalni zvok. Vodič kot načrtovalno oceno predlaga približno 2,5 izgovorjene besede na sekundo, zato pustite prostor za premore in vidno dogajanje. Kratko predstavitev lahko načrtujete kot eno repliko, ki ji sledi trenutek razkritja izdelka. Poslušajte dejanske besede ter preverite, ali ustvarjeni zvok ustreza prostoru in dogajanju.

Dolžino izhoda izberete v celih sekundah od pet do petnajst, privzeto pet sekund. Ločljivost je velikostni razred: 480p, 768p, 1080p ali 2k. Dokumentirane možnosti kadriranja so 21:9, 16:9, 4:3, 1:1, 3:4 in 9:16. Pri ustvarjanju iz besedila in referenc pri 1080p ali 2k izberite 16:9 ali 9:16; prilagodljivo kadriranje referenc je dokumentirano pri 480p in 768p. Ustvarjanje iz slike sledi razmerju prve slike, zato jo obrežite pred ustvarjanjem, kadar se zahtevana oblika spremeni. Preverite dejanske mere končnega rezultata, namesto da bi predpostavili, da oznaka velikostnega razreda pomeni en običajen par pikslov.

Vodič modela določa video MP4 s kodiranjem slike H.264 in stereo zvokom AAC pri 32 kHz. Ustvarjanje se obdeluje asinhrono, končano opravilo pa poda lokacijo predvajljivega videa, dolžino in mere. Njegovo podpisano lokacijo videa lahko osvežite s ponovnim pridobivanjem opravila. Za montažni pregled shranite dejanski posnetek, referenčno gradivo in opis. Zapis v stanju čakanja ali obdelave spremlja ustvarjanje; končni video je produkcijsko gradivo za oceno slike, govora in zvoka.

Proizvajalec dokumentira možnosti izboljševanja poziva turbo, quality in disabled; disabled ohrani pripravljeno besedilo, kot je zapisano. Stalno seme je uporabno pri primerjanju spremembe enega stavčnega dela ob ohranitvi drugih vhodov. Izbrano seme in nastavitve zabeležite z opisom kadra. Pri besedilu na zaslonu naj bo načrtovana fraza kratka in natančno zapisana; vodič priporoča naknadno dodajanje odstavkov, drobnega tiska in označenih diagramov. V ustvarjenem naslovu preverite vsak vidni znak, namesto da bi predpostavili pravilno reprodukcijo besedila.

Vodič kot manj zanesljiva področja navaja dolgo besedilo na zaslonu, mehko organsko gibanje, kot so cvetni listi, papir ali lasje, in bližnje upravljanje predmetov z rokami. Pri razlagi postopka naj jasno napisana replika prenese korake, slika pa pokaže stabilno osebo ali predmet; kadar mora biti fizični postopek sam natančen, uporabite ločeno preverjene vizualne prikaze. Celoten kader preglejte glede neprekinjenosti predmetov, stika, podrobnosti obraza in rok, dialoga ter zvoka. Jedrnat seznam sprememb za naslednjo izvedbo ohranja podroben produkcijski opis praktičen.

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

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

HeyGen /`heygen/heygen-video-1`

### Začetek

HeyGen Video iz besedila, prve slike ali vizualnih in zvočnih referenc ustvarja 5–15-sekundne prizore z dialogom, vzdušjem in učinki. Njegov splošnonamenski model heygen-video-1 podpira kadre z izdelki in liki, z nadzorom referenc in izhodom MP4. Jasna, omejena dejanja mu dajejo uporaben produkcijski opis.

Dovoljeni vhodi

Besedilo · Slike · Zvok · Video

Rezultati

Video

### Na voljo v Ailoot · vhodi in metode

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

Vhod

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

Izhod

`video`

Izhodni format

izvirni bajti MP4; brez normalizacije ali prekodiranja

| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
| --- | --- | --- | --- | --- |
| Polje`model` | Vrsta`string` | ZahtevaObvezno | Vrednosti in omejitve heygen/heygen-video-1 | Privzeto— |
| Polje`prompt` | Vrsta`string` | ZahtevaObvezno | Vrednosti in omejitve | Privzeto— |
| Polje`duration` | Vrsta`integer` | ZahtevaObvezno | Vrednosti in omejitve 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Najmanj: 1 Največ: 600 | Privzeto— |
| Polje`resolution` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve 480p, 768p, 2K | Privzeto— |
| Polje`aspect_ratio` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Privzeto— |
| Polje`generate_audio` | Vrsta`boolean` | ZahtevaIzbirno | Vrednosti in omejitve false | Privzeto— |
| Polje`frame_images` | Vrsta`array` | ZahtevaIzbirno | Vrednosti in omejitve Najmanjše število elementov: 1 Največ elementov: 1 Vhodna vsebina: Polje objektov sličic. Vsak objekt vsebuje type=image\_url, image\_url z url in frame\_type. Uporabite URL slike HTTPS in nastavite frame\_type na first\_frame. Vsaka vloga sličice se lahko pojavi največ enkrat. Natančni ključi: type, image\_url, frame\_type Pogoji: Ti ključi opisujejo vsak objekt sličice; image\_url vsebuje samo url. Pri zahtevi samo z besedilom izpustite frame\_images. | Privzeto— |
| Polje`input_references` | Vrsta`array` | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
| Polje`seed` | Vrsta`integer` | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: −9.223.372.036.854.775.808 Največ: 9.223.372.036.854.775.807 | Privzeto— |
| Polje`callback_url` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve Vzorec: ^https:// | Privzeto— |
| Polje`session_id` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
| Polje`trace` | Vrsta`object` | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |
| Polje`user` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |

Kombinacije vhodnih gradiv

**Iz besedila v video** · Pisni poziv. · Obvezno: model, prompt, duration

`Podajte prompt kot besedilo in duration v celih sekundah. Izberite podprto ločljivost in po potrebi razmerje stranic.`

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

`prompt`: Vrsta: string · Največ bajtov UTF-8: 10.000 · Zahtevan je vsaj en znak, ki ni beli znak: Da

**Iz slike v video** · Pisni poziv in slika prve sličice. · Obvezno: model, prompt, duration, frame\_images

`frame_images je polje. Vsak objekt sličice vsebuje type, image_url in frame_type; image_url vsebuje url. Nastavite type na image_url. Uporabite first_frame. Vsaka vloga sličice se lahko pojavi največ enkrat. Za vsako sličico podajte javni URL slike HTTPS. Izberite podprto ločljivost in po potrebi razmerje stranic.`

Natančni ključi: type, image\_url, frame\_type

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

`prompt`: Vrsta: string · Največ bajtov UTF-8: 10.000 · Zahtevan je vsaj en znak, ki ni beli znak: Da

**Reference to video** · Pisni poziv in podprte slikovne, video ter zvočne reference. · Obvezno: model, prompt, duration, input\_references

`input_references je polje objektov. Nastavite type na image_url, video_url, audio_url in uporabite ustrezno istoimensko polje, ki vsebuje url. Uporabite javne URL-je HTTPS. Za izbiro referenčnega načina izpustite frame_images. Izberite podprto ločljivost in po potrebi razmerje stranic.`

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

`prompt`: Vrsta: string · Največ bajtov UTF-8: 10.000 · Zahtevan je vsaj en znak, ki ni beli znak: Da

Parametri in življenjski cikel metode

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

Življenjski cikel: `submit_once_poll_original`

`GET /v1/videos/{public_id}`

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

### Cenik

##### Kako se izračuna končni strošek

Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.

Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.

Hitri način

Ni navedeno Ko je izbran hitri način

Način flex

Ni navedeno Ko je izbran način flex

Najvišja raven razmišljanja

Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)

#### Ocenjene cene za primerjavo

#### Cene po nastavitvah

Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.

| Nastavitev | Cenovna lestvica | Predvidena količina | Obračunska enota | Obračunski pogoji | Strošek |
| --- | --- | --- | --- | --- | --- |
| NastavitevOsnovne cene žetonov | Cenovna lestvicaOsnovna cena | Predvidena količina— | Obračunska enota— | Obračunski pogoji— | Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo **—** / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo **—** / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo **—** / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo **—** / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo **—** / 1K žetonov |
| NastavitevCena videa | Cenovna lestvica— | Predvidena količina— | Obračunska enotana sekundo videa | Obračunski pogojiresolution: 2k | Strošek Izhod · Cena videa · Ocena samo za primerjavo **$0.2** na sekundo videa |
| NastavitevCena videa | Cenovna lestvica— | Predvidena količina— | Obračunska enotana sekundo videa | Obračunski pogojiresolution: 480p | Strošek Izhod · Cena videa · Ocena samo za primerjavo **$0.04** na sekundo videa |
| NastavitevCena videa | Cenovna lestvica— | Predvidena količina— | Obračunska enotana sekundo videa | Obračunski pogojiresolution: 768p | Strošek Izhod · Cena videa · Ocena samo za primerjavo **$0.072** na sekundo videa |
| NastavitevCena videa | Cenovna lestvica— | Predvidena količina— | Obračunska enotana sekundo videa | Obračunski pogojinačin ustvarjanja: reference; ločljivost: 2k | Strošek Izhod · Cena videa · Ocena samo za primerjavo **$0.36** na sekundo videa |
| NastavitevCena videa | Cenovna lestvica— | Predvidena količina— | Obračunska enotana sekundo videa | Obračunski pogojinačin ustvarjanja: reference; ločljivost: 480p | Strošek Izhod · Cena videa · Ocena samo za primerjavo **$0.14** na sekundo videa |
| NastavitevCena videa | Cenovna lestvica— | Predvidena količina— | Obračunska enotana sekundo videa | Obračunski pogojinačin ustvarjanja: reference; ločljivost: 768p | Strošek Izhod · Cena videa · Ocena samo za primerjavo **$0.2** na sekundo videa |
| Nastavitevreferenčna vhodna slika | Cenovna lestvica— | Predvidena količina— | Obračunska enotana referenčno vhodno sliko | Obračunski pogoji— | Strošek Vhod · referenčna vhodna slika · Ocena samo za primerjavo **$0.08** na referenčno vhodno sliko |
| NastavitevOcenjeni strošek ustvarjanja | Cenovna lestvica— | Predvidena količinaocena za eno generiranje | Obračunska enota— | Obračunski pogoji— | Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo **$0.2** ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje. |

Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. [Kako delujeta rezervacija in obračun →](https://ailoot.ai/docs/sl/billing/reserve/)

#### Podrobnosti referenčne tarife

Referenčne lestvice modela ne spreminjajo izbire metode, ocen cen ali stroškov. Veljavni stroški uporabljajo cene izbrane metode Ailoot.

Cenovne reference konfiguracij videa

#### Cene po nastavitvah

Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.

| Nastavitev | Obračunski pogoji | Strošek |
| --- | --- | --- |
| NastavitevCena videa | Obračunski pogojiresolution: 2k | Strošek Izhod · Cena videa **$0.18** na sekundo videa Objavljena referenčna cena za prikazano konfiguracijo. Končni zneski sledijo dejansko obračunani konfiguraciji. |
| NastavitevCena videa | Obračunski pogojiresolution: 480p | Strošek Izhod · Cena videa **$0.04** na sekundo videa Objavljena referenčna cena za prikazano konfiguracijo. Končni zneski sledijo dejansko obračunani konfiguraciji. |
| NastavitevCena videa | Obračunski pogojiresolution: 768p | Strošek Izhod · Cena videa **$0.06** na sekundo videa Objavljena referenčna cena za prikazano konfiguracijo. Končni zneski sledijo dejansko obračunani konfiguraciji. |
| NastavitevCena videa | Obračunski pogojinačin ustvarjanja: reference; ločljivost: 2k | Strošek Izhod · Cena videa **$0.36** na sekundo videa Objavljena referenčna cena za prikazano konfiguracijo. Končni zneski sledijo dejansko obračunani konfiguraciji. |
| NastavitevCena videa | Obračunski pogojinačin ustvarjanja: reference; ločljivost: 480p | Strošek Izhod · Cena videa **$0.08** na sekundo videa Objavljena referenčna cena za prikazano konfiguracijo. Končni zneski sledijo dejansko obračunani konfiguraciji. |
| NastavitevCena videa | Obračunski pogojinačin ustvarjanja: reference; ločljivost: 768p | Strošek Izhod · Cena videa **$0.12** na sekundo videa Objavljena referenčna cena za prikazano konfiguracijo. Končni zneski sledijo dejansko obračunani konfiguraciji. |

### Primeri zahtev

#### Ailoot Ultra · Video

curl · ustvarite videoposnetek

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

### Prejmi in shrani rezultate

#### Ailoot Ultra · Video

podpisani URL-ji vsebine v vaši lasti

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

##### Preveri stanje opravila

GET stanje izvirne operacije

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

Branje druge vsebine

Shrani vsak dokončan izhod, ki vam pripada

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

##### Ohrani vse dokončane rezultate

Shranite vsak dokončan video ali vrnjeno datoteko; pridobite vsebino z vsake dejansko vrnjene URL gradiva.

Ohranite vsak dejanski izhod v vaši lasti in njegove vrnjene izmerjene metapodatke.

##### Če je treba preveriti izvirni odgovor

503 result\_pending\_check + prvotni id + X-Should-Retry:false; prvotne zahteve nikoli ne ponovite

Polja odgovora

| Polje | Vrsta | Pomen |
| --- | --- | --- |
| Polje`index` | Vrstainteger | PomenPoložaj tega videa na seznamu izhodov, štet od nič. |
| Polje`content_url` | Vrstastring | PomenPodpisani URL HTTPS za prenos tega dokončanega videa. |
| Polje`sha256` | Vrstastring \| null | PomenIzvleček SHA-256 izvirnih video bajtov; null, če ni na voljo. |
| Polje`size_bytes` | Vrstainteger \| null | PomenVelikost izvirne video datoteke v bajtih; null, če ni na voljo. |
| Polje`duration_ms` | Vrstainteger \| null | PomenIzmerjeno trajanje videa v milisekundah; null, če ni na voljo. |
| Polje`width` | Vrstainteger \| null | PomenŠirina videa v slikovnih pikah; null, če ni na voljo. |
| Polje`height` | Vrstainteger \| null | PomenVišina videa v slikovnih pikah; null, če ni na voljo. |
| Polje`video_codec` | Vrstastring \| null | PomenIdentifikator video kodeka; null, če ni zabeležen. |
| Polje`has_audio` | Vrstaboolean \| null | PomenAli video vsebuje zvočno sled; null, če ni izmerjeno. |
| Polje`audio_codec` | Vrstastring \| null | PomenIdentifikator zvočnega kodeka; null, kadar identifikator ni zabeležen. |

Napake in naslednji koraki

| Odgovor | Pogoj | Naslednji korak |
| --- | --- | --- |
| Odgovor404 · `not_found_error` | PogojDostop do videa ni na voljo ali ta ID videa ni bil najden. | Naslednji korakPreverite dostop do videa. Za obstoječi video uporabite njegov prvotni javni ID in isti ključ API. |
| Odgovor401 · `authentication_error` | PogojKljuč API se ne ujema z overjenim računom. | Naslednji korakPred oddajo preverite svoj ključ API in dostop do računa. |
| Odgovor400 · `invalid_request_error` | PogojZahteve ni bilo mogoče prebrati ali je indeks prenosa neveljaven. | Naslednji korakPopravite telo zahteve. Pri prenosu izberite indeks izhoda, ki ga je vrnilo prvotno opravilo. |
| Odgovor422 · `price_unavailable` | PogojIzbrane video konfiguracije ni mogoče ovrednotiti. | Naslednji korakIzberite podprto konfiguracijo videa in izpolnite njene obvezne možnosti, preden oddate popravljeno zahtevo. |
| Odgovor422 · `invalid_request_error` | PogojVideo vhod ali prvotno nadaljevalno opravilo ni veljavno. | Naslednji korakUporabite veljavne vhode HTTPS. Za nadaljevanje uporabite javni ID svojega dokončanega prvotnega videa z istim ključem API. |
| Odgovor402 · `billing_error` | PogojRazpoložljivo dobroimetje ali omejitve ne omogočajo rezervacije. | Naslednji korakPreden pošljete novo zahtevo, preverite razpoložljivo dobroimetje in omejitve. |
| Odgovor503 · `server_error` | PogojPreverjanje videa, shramba ali dostop do storitve začasno ni na voljo. | Naslednji korakPočakajte, da bo storitev na voljo. Če že imate ID videa, preverite to prvotno opravilo, namesto da ustvarite novo generacijo. |
| Odgovor503 · `result_pending_check` | PogojPrvotni video rezultat in zaračunani znesek je treba preveriti. | Naslednji korakOhranite vrnjeni ID videa in preverjajte to opravilo. Med preverjanjem ne pošljite nadomestne zahteve za ustvarjanje. |
| Odgovor503 · `owned_result_unavailable` | PogojPrenos obstoječega videa začasno ni na voljo. | Naslednji korakPozneje preverite isto video opravilo in prenesite njegov obstoječi izhod. Novo ustvarjanje ustvari ločeno operacijo. |
| Odgovor409 · `video_not_ready` | PogojVideo vsebina ni objavljena. | Naslednji korakPreverite stanje prvotnega opravila. Prenesite, ko sporoči completed; če sporoči failed, upoštevajte njegovo obvestilo o preverjanju zaračunanega zneska. |

### Druga imena

#### Druga imena modelov

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

#### Druga imena poti metod

Uporabite zgoraj navedene poti metod.

#### Povezani ID-ji za klic

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

FAQ · HeyGen: HeyGen Video

Kateri vhodi in rezultati so na voljo?

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

Katera polja uporablja zahteva?

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

Katere omejitve veljajo?

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

Ailoot povežite s Claude Code, OpenCode, Hermes ali svojo aplikacijo.

## Podjetje in njegov portfelj projektov

Podjetje in njegov portfelj projektov: milijoni strank; mesečna prodaja v milijardah.

## Žetone kupujte s popustom.

Naročniški popust za redno delo. Promocijske kode prinesejo do 50% popusta na nakup žetonov.

Naročnina

Za redne zahteve izberite paket s popustom.

Promocijska koda do 50%

Kodo vnesite ob nakupu. Cena se preračuna po veljavni akciji.

Poraba v zgodovini

Za vsako zahtevo se shranijo model, žetoni in znesek.

[Izberite naročnino](https://ailoot.ai/docs/sl/billing/subscriptions/) · [Oglejte si cene modelov](https://ailoot.ai/models/sl/)

## API povežite z izdelkom, ki ga prodajate.

SaaS, aplikacije in boti po ponudbi in licenčni pogodbi Ailoot. Za nadaljnjo prodajo zaprosite za preprodajno licenco.

Komercialna aplikacija

Ustvarjanje besedila, slik, videa in zvoka vključite v plačljive funkcije svoje storitve.

Licenca za preprodajalca

Pošljite opis projekta in shemo dostopa. Zahtevajte pisne pogoje uporabe in nadaljnje prodaje.

Dokumenti na strani

Ponudba, licenčna pogodba in politika obdelave podatkov so dostopne pred povezavo.

[Zaprosite za preprodajno licenco](mailto:support@ailoot.ai) · [Ponudba in licenčna pogodba](https://ailoot.ai/legal/offer?lang=sl)

## Ailoot · Podjetje in njegov portfelj projektov





Ailoot temelji na pridobljenih operativnih izkušnjah, široki bazi strank, stabilni storitvi in stalnem spremljanju KPI.





Podjetje in njegov portfelj projektov: milijoni strank; mesečna prodaja v milijardah.





Ailoot te operativne izkušnje uporablja za dostop prek API do funkcij umetne inteligence v izdelkih strank, agentih, aplikacijah in avtomatizacijah.