Runway: Gen-4.5
A Runway Gen-4.5 jelenetleírásból vagy mozgásutasítással kísért képből készít videót. 2–10 másodperces klipjei, explicit kamerapromptolása és külön szöveg–videó, illetve kép–videó kompozíciós lehetőségei filmes koncepciókat, B-rollt és animált vizuális jeleneteket támogatnak.
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 Runway Gen-4.5 videógeneráló modell szöveg–videó és kép–videó móddal. Olyan feladatot követhet, amely jelenetkompozíciót, alanyműveletet, kamerakoreográfiát és eseménysort ír le. A hasznos eredmény rövid generált snitt, amely ellenőrizhető, megőrizhető vagy más felvételekkel összeállítható.
Válassz bemeneti módot a snitthez
A szöveg–videó írott jelenetleírásból indul. A látható tartalmat és mozgást is add meg: alany, helyszín, világítás, kivágás, cselekmény és kameraviselkedés. Ez a mód új jelenethez, B-rollhoz, háttérfelvételhez vagy olyan vizuális koncepcióhoz hasznos, ahol a kezdőképnek nem kell megadott képet reprodukálnia.
A kép–videó első képkockaként működő képből indul. Ez a kép adja a kompozíciót, témát, világítást és stílust. Az írott prompt arra összpontosítson, mi történjen ezután: az alany műveletére, környezeti mozgásra, kameramozgásra és a snitt előrehaladására.
Tiszta képet készíts, amelyen a fontos részletek már láthatók. Az elmosódott arcok, kezek vagy más hibák animálva feltűnőbbé válhatnak. A poron vagy mozgási elmosódáson át gyors mozgást sugalló referencia is ütközhet a mozdulatlan alanyt kérő prompttal.
A látványt és mozgást közvetlenül írd le
Világos természetes nyelvet és a kívánt eredmény pozitív leírását használd. A szöveg–videó feladat először a kameranézetet, alanyt és műveletet adhatja meg, majd a jelenetkezelést. Részletes leírás akkor hasznos, ha a snittnek meghatározott követelményei vannak; egyszerűbb leírás több teret ad a felfedezésnek. Nincs a világosságot helyettesítő ideális szószám.
Például írj le közeli képet egy sárgaréz asztali lámpáról, amint felkapcsolódik a fénye, majd lassú kameramozgást, amely felfed mellette egy jegyzetfüzetet. Szöveg–videóhoz add meg a látható anyagokat és fényt. Ha a megadott kép már rögzíti ezeket a részleteket, a kép–videó prompt a fényváltozásra és kamerás felfedésre összpontosíthat.
Kerüld az ellentmondó irányítást. A rögzített nézet finom alanymozgással különbözik az energikus kézikamerás követősnittől. A hasznos snittet meghatározó részleteket add hozzá, ne egymáshoz nem kapcsolódó vizuális stílusok hosszú listáját.
Kamerakifejezések és sorba rendezett cselekmény
A gyártó kameraútmutatója megkülönbözteti a kivágást, kameraállást, mozgást és fókuszt. A közeli módosítja, mi tölti ki a képet, az alacsony kameraállás a perspektívát változtatja, a svenk elforgatja a kamera nézetét, a követőmozgás pedig alanyt követ. A fókuszváltási utasítás látható alanyok között viszi át az élességet. Add meg, minek kell látszania vagy felfedődnie a mozgás kibontakozásakor.
A szekvenciális promptok közönséges nyelven vagy hozzávetőleges időbélyegekkel fejezhetik ki az eseményeket. Az időbélyegek a sorrendet és közelítő időzítést irányítják; nem garantálnak képkockapontos végrehajtást. A kiválasztott klipidőtartamban adj elegendő időt a kért műveletek természetes lezajlásához.
Statikus snittnél írd le a képen belüli mozgást, és erősítsd meg a kívánt álló kamerát. A gyártó szerint a teljesen mozdulatlan nézetek nehezek lehetnek, különösen egyes tág vagy helyszínbevezető snitteknél. A tényleges eredményben ellenőrizd az apró nem kívánt mozgásokat, ne feltételezd, hogy a statikus kamera kifejezése lehetetlenné teszi őket.
Időtartam, méretek és képkockasebesség
A Gen-4.5 2–10 másodperces klipidőtartamokat támogat. A hosszabb választás több sorba rendezett műveletnek adhat helyet, míg rövid reakció vagy felfedés rövidebb snittet használhat. Dokumentált kimenete 720p, a gyártó generálási munkafolyamatában másodpercenként 24 vagy 25 képkockával.
A szöveg–videó specifikáció 16:9-et sorol fel 1280 × 720 pixellel. A kép–videó ezenfelül 9:16-ot 720 × 1280, 1:1-et 960 × 960, 4:3-at 1104 × 832, 3:4-et 832 × 1104 és 21:9-et 1584 × 672 mérettel. A módot és tényleges méreteket együtt kezeld, ne feltételezd, hogy mindkét bemeneti mód azonos képaránykészletet kínál.
A kép aránya rögzítheti az alapértelmezett kompozíciót, és megváltoztatása levághatja a bemenetet. A mozgás megítélése előtt ellenőrizd az alany elhelyezését: a helyes művelet nem hasznos, ha a forráskép kulcsfontosságú része kimaradt.
Hosszabb sorozat építése kész snittekből
Képvezérelt munkához a gyártó sorozatfolytatást ír le úgy, hogy egy kész klip utolsó képkockája lesz a következő generálás képbemenete. A klipeket ezután videószerkesztőben kapcsolják össze, közös képkockájukat és időzítésüket a szerkesztés kezeli. Ez külön snittek sorozata, nem egyetlen korlátlan időtartamú generálás.
Őrizd meg a záróképet és megfelelő feladatleírást, hogy a következő snitt a kívánt vizuális állapotból induljon. Az összekapcsolt felvételben ellenőrizd a folytonosságot, beleértve az alany megjelenését, kamera irányát és klipek közötti átmenetet.
A gyártási anyag megtartása és ellenőrzése
Generálás után ellenőrizd a teljes klipet, és őrizd meg a kész kimenetet. A gyártó munkafolyamata külön nagyítási és gyártási exportlehetőségeket is ad, például ProRes-t vagy PNG-sorozatot. Ezek további munkafolyamat-lehetőségek; a natív generálási méretek különböznek a később felnagyított eredménytől.
A Gen-4.5 filmes koncepciókhoz, animált vizuális ötletekhez, B-rollhoz és rövid jelenetfejlesztéshez használható. A promptot, használt bemeneti képet, időtartamot, módot és visszaadott klipet együtt őrizd meg. Ellenőrizd a cselekménysorrendet, kameraviselkedést, alanyrészleteket, nem kívánt vágásokat és tervezett kivágást, majd célzott javítást végezz a snitten.
Ailoot Ultra · Videó POST /v1/videos runway/gen-4.5
runway/gen-4.5Kezdő lépések
A Runway Gen-4.5 jelenetleírásból vagy mozgásutasítással kísért képből készít videót. 2–10 másodperces klipjei, explicit kamerapromptolása és külön szöveg–videó, illetve kép–videó kompozíciós lehetőségei filmes koncepciókat, B-rollt és animált vizuális jeleneteket támogatnak.
- Elfogadott bemenetek
- Szöveg · Képek
- Eredmények
- Videó
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Videó POST /v1/videos
- Bemenet
text,image- 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 runway/gen-4.5 | 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 2, 3, 4, 5, 6, 7, 8, 9, 10 Minimum: 1 Maximum: 600 | Alapértelmezett— |
Mezőresolution | Típusstring | KövetelményOpcionális | Értékek és korlátok 720p | Alapértelmezett— |
Mezőaspect_ratio | Típusstring | KövetelményOpcionális | Értékek és korlátok 16:9, 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ősize | Típusstring | KövetelményOpcionális | Értékek és korlátok 1280x720, 720x1280 Minta: ^[1-9][0-9]*x[1-9][0-9]*$ | 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; adjon hozzá képarányt, vagy használjon felsorolt méretet.
model: Típus: string · runway/gen-4.5
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; adjon hozzá képarányt, vagy használjon felsorolt méretet.
Pontos kulcsok: type, image_url, frame_type
model: Típus: string · runway/gen-4.5
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 |
Paraméteradditional_properties | Szerződésfalse |
Paraméteroptional_controls | Szerződésresolution, aspect_ratio, generate_audio, frame_images, input_references, size, 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ételekEbben az árképzési kulcsban nincs további feltétel megadva. | Díj Kimenet · Videó ára · Becslés, csak összehasonlításra $0.24 videómásodpercenké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.48 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
| Beállítás | Elszámolási feltételek | Díj |
|---|---|---|
| BeállításVideó ára | Elszámolási feltételekEbben az árképzési kulcsban nincs további feltétel megadva. | Díj Kimenet · Videó ára $0.24 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":"runway/gen-4.5","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', 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 runway/gen-4.5
Metódusútvonalak álnevei
Használja a fent látható metódusútvonalakat.
Kapcsolódó modellazonosítók
FAQ · Runway: Gen-4.5
- Milyen bemenetek és eredmények érhetők el?
POST /v1/videos·runway/gen-4.5:text,image→video- Mely mezőket használja a kérés?
POST /v1/videos·runway/gen-4.5:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- Milyen korlátok érvényesek?
POST /v1/videos·runway/gen-4.5:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807