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-1Kezdő 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ípusstring | KövetelményKötelező | Értékek és korlátok heygen/heygen-video-1 | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok | Alapértelmezett— |
Meződuration | Típusinteger | 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ípusstring | KövetelményOpcionális | Értékek és korlátok 480p, 768p, 2K | Alapértelmezett— |
Mezőaspect_ratio | Típusstring | 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ípusboolean | KövetelményOpcionális | Értékek és korlátok false | Alapértelmezett— |
Mezőframe_images | Típusarray | 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ípusarray | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőseed | Típusinteger | 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ípusstring | KövetelményOpcionális | Értékek és korlátok Minta: ^https:// | Alapértelmezett— |
Mezősession_id | Típusstring | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőtrace | Típusobject | KövetelményOpcionális | Értékek és korlátok | Alapértelmezett— |
Mezőuser | Típusstring | 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étercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt, duration |
Paramétermaterial_types | Szerződéstext, image, audio, video |
Paraméteradditional_properties | Szerződésfalse |
Paraméteroptional_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 →
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ó
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
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
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
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
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