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

# HeyGen: HeyGen Video

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

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

A HeyGen Video 5–15 másodperces jeleneteket generál párbeszéddel, atmoszférával és effektekkel szövegből, első képből vagy vizuális és hangreferenciákból. Általános célú heygen-video-1 modellje termék- és karaktersnitteket támogat referenciavezérléssel és MP4-kimenettel. Világos, körülhatárolt műveletek adnak neki hasznos gyártási feladatot.

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

A modellről

Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.

A HeyGen Video a HeyGen általános célú jelenetgeneráló modellje, amelyet a gyártó heygen-video-1 néven azonosít. Alkotói feladatleírásból együtt hozza létre az alanyt, helyszínt, fényt és hangot. Minden klip 5–15 másodperces, és tartalmazza generált hangsávját, párbeszéddel, atmoszférával és effektekkel együtt. Hasznos gyártási bemenet lehet jelenetleírás, termékfotó vagy személyt, helyet, mozgást rögzítő anyag. Az eredmény rövid jelenet termékbemutatóhoz, bevezető betéthez, ingatlannézethez vagy más szerkesztett videómunkához.

Három mód eltérő szerepet ad a bemeneteknek. A szöveg–videó a promptból készít jelenetet. A kép–videó szó szerint a megadott képen kezdődik, majd a cselekményben követi a feladatot. A referencia–videó megadott képekkel, videóval és opcionális hanggal irányít újonnan komponált jelenetet; legalább egy referenciaképet vagy videót igényel. Első képkockás képet válassz, ha a nyitókompozíciónak egyeznie kell egy állóképpel, referenciákat pedig akkor, ha ismert tárgynak eltérő kompozícióban kell megjelennie. Ez a jelenetmodell különbözik a HeyGen avatarrenderelő motorjaitól és Video Agent kompozíciós munkafolyamatától.

A gyártó útmutatója részletes, konkrét snittutasításokat részesít előnyben: egy alany, egy helyszín és egy körülhatárolt művelet, rögzített vagy finoman mozgó kamerával. Írd le a kamera helyét, objektívet vagy mélységélességi szándékot, fényt, felülettextúrát és színkezelést. Magyarázd el az érintkezési pontokat, ha a művelet érintkezéstől függ. Eredeti termékpéldához utazótermosz referenciafotóját használd, és kérd, hogy fa pulton álljon, miközben mellette műsorvezető beszél, kis kameramozgással a termosz felé. Az eredményben vizsgáld meg a termosz formáját, elhelyezését és látható jelöléseit.

A referencialisták legfeljebb kilenc képet, három videót és három hangelemet támogatnak, összesen legfeljebb tizenkét referenciával. A gyártó promptformátumában a képek, videók és hangok külön számozódnak: az első kép \<Picture 1\>, az első videó \<Video 1\>. Minden referenciának adj szerepet, és azt a feladatban kifejezetten azonosítsd. A modell minden referenciavideó első öt másodpercét olvassa, ezért a megfelelő részletet az elejére készítsd. Az API-referencia a referenciavideó arányait 1:4 és 4:1 közé teszi. Egy hosszú klip, amelynek csak a végén szerepel a kívánt mozgás, rossz előkészítés ehhez az öt másodperces bemeneti ablakhoz.

A dokumentált referenciafelület közvetlenül elérhető HTTPS-erőforrást, feltöltött anyagazonosítót vagy inline base64-et fogad. Az útmutató maximális képméretei URL-nél 16 MB, inline esetben 5 MB; videó vagy hang URL-nél legfeljebb 32 MB, inline esetben 16 MB lehet. Jól értelmezhető forrásanyagot készíts, könnyen megkülönböztethető fontos alannyal és a különböző referenciákban versengő utasítások nélkül. Az első képkockás képben tartsd meg a kívánt tájolást. Ezek a bemeneti részletek a gyártó referenciamunkafolyamatára vonatkoznak, és segítenek a kiválasztott módhoz szervezni az alkotói anyagokat.

A hangot a képpel azonos feladatban irányítsd. Add meg a párbeszédet, hangos előadást, szobahangot és konkrét effekteket, azt is, hogy egy hang közeli vagy távoli legyen-e. Add meg a kívánt zenekezelést, ha a jelenetnek csak beszédet és atmoszférát kell tartalmaznia. Az útmutató tervezési becslésként másodpercenként hozzávetőleg 2,5 kimondott szót javasol, ezért hagyj helyet szüneteknek és látható cselekménynek. Rövid bevezetés egy sorból, majd terméket feltáró mozzanatból tervezhető. Hallgasd meg a tényleges szavakat és azt, illik-e a generált hang a térhez és művelethez.

A kimeneti időtartam öt–tizenöt között egész másodpercekben választható, öt másodperces alapértékkel. A felbontás méretosztály: 480p, 768p, 1080p vagy 2k. A dokumentált kivágási lehetőségek 21:9, 16:9, 4:3, 1:1, 3:4 és 9:16. Szöveg–videóhoz és referencia–videóhoz 1080p vagy 2k esetén 16:9-et vagy 9:16-ot válassz; adaptív referenciakivágás 480p és 768p mellett dokumentált. A kép–videó az első kép arányait követi, ezért ha a kívánt alak változik, generálás előtt vágj. A kész eredmény tényleges méreteit ellenőrizd, ne feltételezd, hogy a méretosztály címkéje egy szokásos pixelpárt jelent.

A modellútmutató MP4-videót ad meg H.264 képkódolással és 32 kHz-es sztereó AAC-hanggal. A generálás feldolgozása aszinkron, a kész feladat pedig megadja a lejátszható videó helyét, időtartamát és méreteit. Aláírt videóhelye a feladat újbóli lekérésével frissíthető. A tényleges klipet, referenciaanyagokat és feladatleírást őrizd meg szerkesztési ellenőrzéshez. A függő vagy feldolgozási rekord a generálást követi; a kész videó a kép, beszéd és hang szerint értékelendő gyártási anyag.

A gyártó turbo, quality és disabled promptjavítási lehetőségeket dokumentál; a disabled változatlanul megtartja az előkészített megfogalmazást. Rögzített seed hasznos egyetlen tagmondat módosításának összehasonlításakor, a többi bemenet megtartásával. A választott seedet és beállításokat rögzítsd a snittfeladattal. Képernyőn megjelenő betűknél a kívánt fordulat legyen rövid és pontosan leírva; az útmutató a bekezdések, apró betűk és feliratozott ábrák utólagos kompozitálását ajánlja. A generált cím minden látható karakterét ellenőrizd, ne feltételezd a megfogalmazás helyes reprodukcióját.

Az útmutató a hosszú képernyőszöveget, a szirmok, papír vagy haj lágy organikus mozgását és a közeli kézzel végzett manipulációt kevésbé megbízható területként azonosítja. Eljárásmagyarázatnál világosan megírt sor közvetítse a lépéseket, míg a kép stabil személyt vagy tárgyat mutat; ha maga a fizikai művelet pontos kell legyen, külön ellenőrzött látványt használj. A teljes snittben ellenőrizd a tárgyfolytonosságot, érintkezést, arc- és kézrészleteket, párbeszédet és hangot. A következő felvételben megváltoztatandó elemek tömör listája praktikussá teszi a részletes gyártási feladatot.

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

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

HeyGen /`heygen/heygen-video-1`

### Kezdő lépések

A HeyGen Video 5–15 másodperces jeleneteket generál párbeszéddel, atmoszférával és effektekkel szövegből, első képből vagy vizuális és hangreferenciákból. Általános célú heygen-video-1 modellje termék- és karaktersnitteket támogat referenciavezérléssel és MP4-kimenettel. Világos, körülhatárolt műveletek adnak neki hasznos gyártási feladatot.

Elfogadott bemenetek

Szöveg · Képek · Hang · Videó

Eredmények

Videó

### Elérhető az Ailootban · bemenetek és metódusok

**Ailoot Ultra · Videó** `POST /v1/videos`

Bemenet

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

Kimenet

`video`

Kimeneti formátum

eredeti MP4-bájtok; normalizálás és átkódolás nélkül

| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
| --- | --- | --- | --- | --- |
| Mező`model` | Típus`string` | KövetelményKötelező | Értékek és korlátok heygen/heygen-video-1 | Alapértelmezett— |
| Mező`prompt` | Típus`string` | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
| Mező`duration` | Típus`integer` | KövetelményKötelező | Értékek és korlátok 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600 | Alapértelmezett— |
| Mező`resolution` | Típus`string` | KövetelményOpcionális | Értékek és korlátok 480p, 768p, 2K | Alapértelmezett— |
| Mező`aspect_ratio` | Típus`string` | KövetelményOpcionális | Értékek és korlátok 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Alapértelmezett— |
| Mező`generate_audio` | Típus`boolean` | KövetelményOpcionális | Értékek és korlátok false | Alapértelmezett— |
| Mező`frame_images` | Típus`array` | KövetelményOpcionális | Értékek és korlátok Minimális elemszám: 1 Maximális elemszám: 1 Bemeneti tartalom: Képkockaobjektumok tömbje. Minden objektumban type=image\_url, url mezőt tartalmazó image\_url és frame\_type szerepel. Használjon HTTPS kép-URL-címet, és a frame\_type értéke first\_frame legyen. Minden képkockaszerep legfeljebb egyszer fordulhat elő. Pontos kulcsok: type, image\_url, frame\_type Feltételek: Ezek a kulcsok minden képkockaobjektumot leírnak; az image\_url kizárólag url mezőt tartalmaz. Kizárólag szöveges kérésnél hagyja el a frame\_images mezőt. | Alapértelmezett— |
| Mező`input_references` | Típus`array` | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
| Mező`seed` | Típus`integer` | KövetelményOpcionális | Értékek és korlátok Minimum: -9 223 372 036 854 775 808 Maximum: 9 223 372 036 854 775 807 | Alapértelmezett— |
| Mező`callback_url` | Típus`string` | KövetelményOpcionális | Értékek és korlátok Minta: ^https:// | Alapértelmezett— |
| Mező`session_id` | Típus`string` | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
| Mező`trace` | Típus`object` | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
| Mező`user` | Típus`string` | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |

Bemeneti anyagok kombinációi

**Szövegből videó** · Írott utasítás. · Kötelező: model, prompt, duration

`A prompt szöveg, a duration pedig egész másodpercekben megadott időtartam legyen. Válasszon támogatott felbontást és szükség esetén képarányt.`

`model`: Típus: string · heygen/heygen-video-1

`prompt`: Típus: string · Maximális UTF-8 bájtszám: 10 000 · Nem csak szóközből álló tartalom szükséges: Igen

**Képből videó** · Írott utasítás és egy első képkockát ábrázoló kép. · Kötelező: model, prompt, duration, frame\_images

`A frame_images egy tömb. Minden képkockaobjektum type, image_url és frame_type mezőt tartalmaz; az image_url mezőben url található. A type értéke legyen image_url. Használja a first_frame szerepet. Minden képkockaszerep legfeljebb egyszer fordulhat elő. Minden képkockához adjon meg nyilvános HTTPS kép-URL-címet. Válasszon támogatott felbontást és szükség esetén képarányt.`

Pontos kulcsok: type, image\_url, frame\_type

`model`: Típus: string · heygen/heygen-video-1

`prompt`: Típus: string · Maximális UTF-8 bájtszám: 10 000 · Nem csak szóközből álló tartalom szükséges: Igen

**Reference to video** · Írott utasítás, valamint támogatott kép-, videó- és hangreferenciák. · Kötelező: model, prompt, duration, input\_references

`Az input_references objektumok tömbje. A type értéke image_url, video_url vagy audio_url legyen, és használja a hozzá tartozó, url mezőt tartalmazó mezőt. Használjon nyilvános HTTPS URL-címeket. A referenciaanyagokkal dolgozó mód kiválasztásához hagyja el a frame_images mezőt. Válasszon támogatott felbontást és szükség esetén képarányt.`

`model`: Típus: string · heygen/heygen-video-1

`prompt`: Típus: string · Maximális UTF-8 bájtszám: 10 000 · Nem csak szóközből álló tartalom szükséges: Igen

Metódus paraméterei és életciklusa

| Paraméter | Szerződés |
| --- | --- |
| Paraméter`content_type` | Szerződésapplication/json |
| Paraméter`required` | Szerződésmodel, prompt, duration |
| Paraméter`material_types` | Szerződéstext, image, audio, video |
| Paraméter`additional_properties` | Szerződésfalse |
| Paraméter`optional_controls` | Szerződésresolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, seed, callback\_url, session\_id, trace, user |

Életciklus: `submit_once_poll_original`

`GET /v1/videos/{public_id}`

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

### Díjcsomagok

##### A végső díj számítása

A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.

A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.

Gyors mód

Nincs megadva Ha a gyors mód van kiválasztva

Flex mód

Nincs megadva Ha a flex mód van kiválasztva

Maximális gondolkodási ráfordítás

Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik

#### Becsült díjak összehasonlításhoz

#### Árak beállításonként

Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.

| Beállítás | Díjtáblázat | Előre jelzett mennyiség | Elszámolási egység | Elszámolási feltételek | Díj |
| --- | --- | --- | --- | --- | --- |
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Elszámolási egység— | Elszámolási feltételek— | Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra **—** / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra **—** / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra **—** / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra **—** / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra **—** / 1K token |
| BeállításVideó ára | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egységvideómásodpercenként | Elszámolási feltételekresolution: 2k | Díj Kimenet · Videó ára · Becslés, csak összehasonlításra **$0.2** videómásodpercenként |
| BeállításVideó ára | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egységvideómásodpercenként | Elszámolási feltételekresolution: 480p | Díj Kimenet · Videó ára · Becslés, csak összehasonlításra **$0.04** videómásodpercenként |
| BeállításVideó ára | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egységvideómásodpercenként | Elszámolási feltételekresolution: 768p | Díj Kimenet · Videó ára · Becslés, csak összehasonlításra **$0.072** videómásodpercenként |
| BeállításVideó ára | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egységvideómásodpercenként | Elszámolási feltételekgenerálási mód: referenciaanyagokkal; felbontás: 2k | Díj Kimenet · Videó ára · Becslés, csak összehasonlításra **$0.36** videómásodpercenként |
| BeállításVideó ára | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egységvideómásodpercenként | Elszámolási feltételekgenerálási mód: referenciaanyagokkal; felbontás: 480p | Díj Kimenet · Videó ára · Becslés, csak összehasonlításra **$0.14** videómásodpercenként |
| BeállításVideó ára | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egységvideómásodpercenként | Elszámolási feltételekgenerálási mód: referenciaanyagokkal; felbontás: 768p | Díj Kimenet · Videó ára · Becslés, csak összehasonlításra **$0.2** videómásodpercenként |
| Beállításreferenciaként használt bemeneti kép | Díjtáblázat— | Előre jelzett mennyiség— | Elszámolási egységbemeneti referenciaképenként | Elszámolási feltételek— | Díj Bemenet · referenciaként használt bemeneti kép · Becslés, csak összehasonlításra **$0.08** bemeneti referenciaképenként |
| BeállításA generálás becsült költsége | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Elszámolási egység— | Elszámolási feltételek— | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra **$0.2** becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra. |

Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. [A foglalás és az elszámolás működése →](https://ailoot.ai/docs/hu/billing/reserve/)

#### A referencia-díjszabás részletei

A modellszintű referenciatáblázatok nem módosítják a metódusválasztást, az árajánlatokat vagy a díjakat. A tényleges díjak a kiválasztott Ailoot-metódus díjtételeit használják.

Videóbeállítások árhivatkozásai

#### Árak beállításonként

Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.

| Beállítás | Elszámolási feltételek | Díj |
| --- | --- | --- |
| BeállításVideó ára | Elszámolási feltételekresolution: 2k | Díj Kimenet · Videó ára **$0.18** videómásodpercenként A megjelenített konfiguráció közzétett árreferenciája. A végleges díjak a ténylegesen elszámolt konfigurációt követik. |
| BeállításVideó ára | Elszámolási feltételekresolution: 480p | Díj Kimenet · Videó ára **$0.04** videómásodpercenként A megjelenített konfiguráció közzétett árreferenciája. A végleges díjak a ténylegesen elszámolt konfigurációt követik. |
| BeállításVideó ára | Elszámolási feltételekresolution: 768p | Díj Kimenet · Videó ára **$0.06** videómásodpercenként A megjelenített konfiguráció közzétett árreferenciája. A végleges díjak a ténylegesen elszámolt konfigurációt követik. |
| BeállításVideó ára | Elszámolási feltételekgenerálási mód: referenciaanyagokkal; felbontás: 2k | Díj Kimenet · Videó ára **$0.36** videómásodpercenként A megjelenített konfiguráció közzétett árreferenciája. A végleges díjak a ténylegesen elszámolt konfigurációt követik. |
| BeállításVideó ára | Elszámolási feltételekgenerálási mód: referenciaanyagokkal; felbontás: 480p | Díj Kimenet · Videó ára **$0.08** videómásodpercenként A megjelenített konfiguráció közzétett árreferenciája. A végleges díjak a ténylegesen elszámolt konfigurációt követik. |
| BeállításVideó ára | Elszámolási feltételekgenerálási mód: referenciaanyagokkal; felbontás: 768p | Díj Kimenet · Videó ára **$0.12** videómásodpercenként A megjelenített konfiguráció közzétett árreferenciája. A végleges díjak a ténylegesen elszámolt konfigurációt követik. |

### Példakérések

#### Ailoot Ultra · Videó

curl · hozz létre videót

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

### Eredmények fogadása és mentése

#### Ailoot Ultra · Videó

aláírt saját tartalom-URL-címek

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

##### Feladatállapot ellenőrzése

Az eredeti művelet állapotának lekérése GET-tel

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

További tartalomlekérések

Mentsen minden elkészült, Önhöz tartozó kimenetet

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

##### Őrizzen meg minden elkészült eredményt

Mentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.

Őrizze meg az összes ténylegesen visszaadott, Önhöz tartozó kimenetet és a hozzájuk visszaadott mért metaadatokat.

##### Ha az eredeti választ ellenőrizni kell

503 result\_pending\_check + eredeti azonosító + X-Should-Retry:false; az eredeti kérést soha ne ismételje meg

Válaszmezők

| Mező | Típus | Jelentés |
| --- | --- | --- |
| Mező`index` | Típusinteger | JelentésE videó nullától induló pozíciója a kimeneti listában. |
| Mező`content_url` | Típusstring | JelentésAláírt HTTPS letöltési URL ehhez az elkészült videóhoz. |
| Mező`sha256` | Típusstring \| null | JelentésAz eredeti videóbájtok SHA-256 lenyomata; null, ha nem érhető el. |
| Mező`size_bytes` | Típusinteger \| null | JelentésAz eredeti videófájl mérete bájtban; null, ha nem érhető el. |
| Mező`duration_ms` | Típusinteger \| null | JelentésA videó mért időtartama ezredmásodpercben; null, ha nem érhető el. |
| Mező`width` | Típusinteger \| null | JelentésA videó szélessége pixelben; null, ha nem érhető el. |
| Mező`height` | Típusinteger \| null | JelentésA videó magassága pixelben; null, ha nem érhető el. |
| Mező`video_codec` | Típusstring \| null | JelentésVideókodek-azonosító; null, ha nincs rögzítve. |
| Mező`has_audio` | Típusboolean \| null | JelentésJelzi, hogy a videó tartalmaz-e hangsávot; null, ha nem mérték meg. |
| Mező`audio_codec` | Típusstring \| null | JelentésHangkodek-azonosító; null, ha nincs azonosító rögzítve. |

Hibák és következő lépések

| Válasz | Feltétel | Következő lépés |
| --- | --- | --- |
| Válasz404 · `not_found_error` | FeltételA videóhoz való hozzáférés nem érhető el, vagy ez a videóazonosító nem található. | Következő lépésEllenőrizze a videóhoz való hozzáférést. Meglévő videónál használja annak eredeti nyilvános azonosítóját és ugyanazt az API-kulcsot. |
| Válasz401 · `authentication_error` | FeltételAz API-kulcs nem egyezik a hitelesített fiókkal. | Következő lépésBeküldés előtt ellenőrizze az API-kulcsot és a fiók hozzáférését. |
| Válasz400 · `invalid_request_error` | FeltételA kérés nem olvasható, vagy a letöltési index érvénytelen. | Következő lépésJavítsa a kérés törzsét. Letöltéshez az eredeti feladat által visszaadott kimeneti indexet válasszon. |
| Válasz422 · `price_unavailable` | FeltételA kiválasztott videóbeállítás nem árazható. | Következő lépésVálasszon támogatott videóbeállítást, és adja meg az ahhoz kötelező opciókat a javított kérés beküldése előtt. |
| Válasz422 · `invalid_request_error` | FeltételA videóbemenet vagy az eredeti folytatási feladat érvénytelen. | Következő lépésHasználjon érvényes HTTPS bemeneteket. Folytatáshoz adja meg az elkészült eredeti videó nyilvános azonosítóját ugyanazzal az API-kulccsal. |
| Válasz402 · `billing_error` | FeltételA rendelkezésre álló egyenleg vagy a limitek nem teszik lehetővé az összeg zárolását. | Következő lépésÚj kérés elküldése előtt ellenőrizze a rendelkezésre álló egyenleget és a limiteket. |
| Válasz503 · `server_error` | FeltételA videó ellenőrzése, tárolása vagy a szolgáltatás elérése átmenetileg nem áll rendelkezésre. | Következő lépésVárja meg, amíg a szolgáltatás elérhető lesz. Ha már van videóazonosítója, az eredeti feladatot ellenőrizze újabb generálás létrehozása helyett. |
| Válasz503 · `result_pending_check` | FeltételAz eredeti videóeredményt és a díjat ellenőrizni kell. | Következő lépésŐrizze meg a visszaadott videóazonosítót, és ellenőrizze azt a feladatot. Az ellenőrzés ideje alatt ne küldjön helyettesítő generálási kérést. |
| Válasz503 · `owned_result_unavailable` | FeltételA meglévő videó letöltése átmenetileg nem érhető el. | Következő lépésEllenőrizze később ugyanazt a videófeladatot, és töltse le annak meglévő kimenetét. Egy új generálás külön műveletet hoz létre. |
| Válasz409 · `video_not_ready` | FeltételA videótartalom nincs közzétéve. | Következő lépésEllenőrizze az eredeti feladat állapotát. Akkor töltse le, amikor completed állapotot jelent; ha failed állapotot jelent, kövesse a díjellenőrzési értesítését. |

### Álnevek

#### Modell álnevei

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

#### Metódusútvonalak álnevei

Használja a fent látható metódusútvonalakat.

#### Kapcsolódó modellazonosítók

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

FAQ · HeyGen: HeyGen Video

Milyen bemenetek és eredmények érhetők el?

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

Mely mezőket használja a kérés?

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

Milyen korlátok érvényesek?

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

Csatlakoztassa az Ailootot a Claude Code-hoz, OpenCode-hoz, Hermeshez vagy saját alkalmazásához.

## A vállalat és projektportfóliója

A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben.

## Vásároljon tokeneket kedvezménnyel.

Előfizetési kedvezmény rendszeres munkához. Promókódok — akár 50% tokenvásárlási kedvezmény.

Előfizetés

Válasszon kedvezményes tarifát a rendszeres kéréseihez.

Promókód akár 50%-ig

Vásárláskor adja meg a kódot. Az ár az érvényes akció szerint újraszámolódik.

Költségek az előzményekben

Minden kéréshez megmarad a modell, a tokenek és az összeg.

[Előfizetés kiválasztása](https://ailoot.ai/docs/hu/billing/subscriptions/) · [Modellárak megtekintése](https://ailoot.ai/models/hu/)

## Csatlakoztassa az API-t az értékesített termékéhez.

SaaS, alkalmazások és botok — az Ailoot ajánlati feltételei és licencszerződése alapján. Viszonteladáshoz kérjen viszonteladói licencet.

Kereskedelmi alkalmazás

Építsen szöveg-, kép-, videó- és hanggenerálást szolgáltatása fizetős funkcióiba.

Viszonteladói licenc

Küldje el a projekt leírását és a hozzáférés módját. Kérjen írásos használati és viszonteladási feltételeket.

Dokumentumok a weboldalon

Az ajánlati feltételek, licencszerződés és adatkezelési szabályzat már a csatlakoztatás előtt elérhető.

[Viszonteladói licenc kérése](mailto:support@ailoot.ai) · [Ajánlati feltételek és licencszerződés](https://ailoot.ai/legal/offer?lang=hu)

## Ailoot · A vállalat és projektportfóliója





Az Ailoot felhalmozott működési tapasztalatra, széles ügyfélkörre, stabil szolgáltatásra és folyamatos KPI-ellenőrzésre épít.





A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben.





Az Ailoot ezt a működési tapasztalatot használja az ügyfelek termékeiben, ágenseiben, alkalmazásaiban és automatizálásaiban elérhető AI-funkciók API-hozzáféréséhez.