models

HeyGen: HeyGen Video

Markdown · JSON

HeyGen: HeyGen Video

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.

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

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ípusKövetelményÉrtékek és korlátokAlapértelmezett
MezőmodelTípusstringKövetelményKötelezőÉrtékek és korlátok
heygen/heygen-video-1
Alapértelmezett—
MezőpromptTípusstringKövetelményKötelezőÉrtékek és korlátokAlapértelmezett—
MeződurationTípusintegerKö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őresolutionTípusstringKövetelményOpcionálisÉrtékek és korlátok
480p, 768p, 2K
Alapértelmezett—
Mezőaspect_ratioTípusstringKövetelményOpcionálisÉrtékek és korlátok
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Alapértelmezett—
Mezőgenerate_audioTípusbooleanKövetelményOpcionálisÉrtékek és korlátok
false
Alapértelmezett—
Mezőframe_imagesTípusarrayKö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_referencesTípusarrayKövetelményOpcionálisÉrtékek és korlátokAlapértelmezett—
MezőseedTípusintegerKö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_urlTípusstringKövetelményOpcionálisÉrtékek és korlátok
Minta: ^https://
Alapértelmezett—
Mezősession_idTípusstringKövetelményOpcionálisÉrtékek és korlátokAlapértelmezett—
MezőtraceTípusobjectKövetelményOpcionálisÉrtékek és korlátokAlapértelmezett—
MezőuserTípusstringKövetelményOpcionálisÉrtékek és korlátokAlapé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éterSzerződés
Paramétercontent_typeSzerződésapplication/json
ParaméterrequiredSzerződésmodel, prompt, duration
Paramétermaterial_typesSzerződéstext, image, audio, video
Paraméteradditional_propertiesSzerződésfalse
Paraméteroptional_controlsSzerző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ásDíjtáblázatElőre jelzett mennyiségElszámolási egységElszámolási feltételekDíj
BeállításTokenek alapdíjaiDíjtáblázatAlapdíjElő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ó áraDíjtáblázat—Előre jelzett mennyiség—Elszámolási egységvideómásodpercenkéntElszámolási feltételekresolution: 2kDíj
Kimenet · Videó ára · Becslés, csak összehasonlításra $0.2 videómásodpercenként
BeállításVideó áraDíjtáblázat—Előre jelzett mennyiség—Elszámolási egységvideómásodpercenkéntElszámolási feltételekresolution: 480pDíj
Kimenet · Videó ára · Becslés, csak összehasonlításra $0.04 videómásodpercenként
BeállításVideó áraDíjtáblázat—Előre jelzett mennyiség—Elszámolási egységvideómásodpercenkéntElszámolási feltételekresolution: 768pDíj
Kimenet · Videó ára · Becslés, csak összehasonlításra $0.072 videómásodpercenként
BeállításVideó áraDíjtáblázat—Előre jelzett mennyiség—Elszámolási egységvideómásodpercenkéntElszámolási feltételekgenerálási mód: referenciaanyagokkal; felbontás: 2kDíj
Kimenet · Videó ára · Becslés, csak összehasonlításra $0.36 videómásodpercenként
BeállításVideó áraDíjtáblázat—Előre jelzett mennyiség—Elszámolási egységvideómásodpercenkéntElszámolási feltételekgenerálási mód: referenciaanyagokkal; felbontás: 480pDíj
Kimenet · Videó ára · Becslés, csak összehasonlításra $0.14 videómásodpercenként
BeállításVideó áraDíjtáblázat—Előre jelzett mennyiség—Elszámolási egységvideómásodpercenkéntElszámolási feltételekgenerálási mód: referenciaanyagokkal; felbontás: 768pDí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épDíjtáblázat—Előre jelzett mennyiség—Elszámolási egységbemeneti referenciaképenkéntElszá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égeDíjtáblázat—Előre jelzett mennyiségbecslés egy generálásraElszá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 →

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ásElszámolási feltételekDíj
BeállításVideó áraElszámolási feltételekresolution: 2kDí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ó áraElszámolási feltételekresolution: 480pDí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ó áraElszámolási feltételekresolution: 768pDí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ó áraElszámolási feltételekgenerálási mód: referenciaanyagokkal; felbontás: 2kDí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ó áraElszámolási feltételekgenerálási mód: referenciaanyagokkal; felbontás: 480pDí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ó áraElszámolási feltételekgenerálási mód: referenciaanyagokkal; felbontás: 768pDí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
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
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
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ípusJelentés
MezőindexTípusintegerJelentésE videó nullától induló pozíciója a kimeneti listában.
Mezőcontent_urlTípusstringJelentésAláírt HTTPS letöltési URL ehhez az elkészült videóhoz.
Mezősha256Típusstring | nullJelentésAz eredeti videóbájtok SHA-256 lenyomata; null, ha nem érhető el.
Mezősize_bytesTípusinteger | nullJelentésAz eredeti videófájl mérete bájtban; null, ha nem érhető el.
Meződuration_msTípusinteger | nullJelentésA videó mért időtartama ezredmásodpercben; null, ha nem érhető el.
MezőwidthTípusinteger | nullJelentésA videó szélessége pixelben; null, ha nem érhető el.
MezőheightTípusinteger | nullJelentésA videó magassága pixelben; null, ha nem érhető el.
Mezővideo_codecTípusstring | nullJelentésVideókodek-azonosító; null, ha nincs rögzítve.
Mezőhas_audioTípusboolean | nullJelentésJelzi, hogy a videó tartalmaz-e hangsávot; null, ha nem mérték meg.
Mezőaudio_codecTípusstring | nullJelentésHangkodek-azonosító; null, ha nincs azonosító rögzítve.
Hibák és következő lépések
VálaszFeltételKövetkező lépés
Válasz404 · not_found_errorFelté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_errorFelté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_errorFelté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_unavailableFelté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_errorFelté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_errorFelté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_errorFelté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_checkFelté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_unavailableFelté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_readyFelté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

Metódusútvonalak álnevei

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

Kapcsolódó modellazonosítók

heygen/heygen-video-1

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

További részletek

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 · Modellárak megtekintése

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 · Ajánlati feltételek és licencszerződés