Runway: Gen-4.5
Runway Gen-4.5 vytvára videá z opisu scény alebo obrázka s pokynmi pohybu. Jeho klipy 2–10 sekúnd, explicitné kamerové zadania a samostatné kompozičné voľby prevodu textu a obrázka na video podporujú filmové koncepty, doplnkové zábery a animované vizuálne scény.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
Runway Gen-4.5 je model generovania videa s režimami prevodu textu na video a obrázka na video. Dokáže sledovať zadanie opisujúce kompozíciu scény, akciu subjektu, choreografiu kamery a postupnosť udalostí. Užitočným výsledkom je krátky generovaný záber, ktorý možno skontrolovať, uchovať alebo zostaviť s ďalšími zábermi.
Vyberte vstupný režim pre záber
Prevod textu na video začína písaným opisom scény. Zahrňte viditeľný obsah aj pohyb: subjekt, prostredie, osvetlenie, záber, akciu a správanie kamery. Tento režim je užitočný pre novú scénu, doplnkové zábery, podklad pozadia alebo vizuálny koncept, kde východisková snímka nemusí reprodukovať dodaný obrázok.
Prevod obrázka na video začína obrázkom pôsobiacim ako prvá snímka. Tento obrázok dodáva kompozíciu, obsah, osvetlenie a štýl. Písaný prompt sústreďte na to, čo sa má stať ďalej: akciu subjektu, pohyb v prostredí, pohyb kamery a vývoj záberu.
Pripravte jasný obrázok s už viditeľnými dôležitými detailmi. Rozmazané tváre, ruky alebo iné artefakty sa pri animácii môžu zvýrazniť. Referencia naznačujúca rýchly pohyb prachom alebo pohybovou neostrosťou môže tiež odporovať promptu žiadajúcemu nehybný subjekt.
Vizuál a pohyb opisujte priamo
Používajte jasný prirodzený jazyk a pozitívne opisy zamýšľaného výsledku. Zadanie prevodu textu na video môže najprv uviesť pohľad kamery, subjekt a akciu a potom pridať spracovanie scény. Podrobný opis je užitočný pri definovaných požiadavkách záberu; jednoduchší poskytuje viac priestoru na skúmanie. Neexistuje ideálny počet slov nahrádzajúci jasnosť.
Napríklad opíšte blízky pohľad na mosadznú stolovú lampu pri zapnutí jej svetla a nasledujúci pomalý pohyb kamery odhaľujúci zošit vedľa nej. Pri prevode textu na video uveďte viditeľné materiály a svetlo. Ak dodaný obrázok už tieto detaily stanovuje, prompt prevodu obrázka na video sa môže sústrediť na zmenu svetla a kamerové odhalenie.
Vyhnite sa protirečivým pokynom. Pevný pohľad s jemným pohybom subjektu sa líši od energického sledovacieho záberu z ruky. Pridávajte detaily definujúce užitočný záber namiesto dlhého zoznamu nesúvisiacich vizuálnych štýlov.
Kamerové pojmy a postupná akcia
Kamerová príručka výrobcu rozlišuje záber, uhly, pohyb a zaostrenie. Detail mení to, čo vypĺňa záber, podhľad mení perspektívu, panorámovanie otáča pohľad kamery a sledovací pohyb nasleduje subjekt. Pokyn preostrenia presúva zaostrenie medzi viditeľnými subjektmi. Uveďte, čo má byť viditeľné alebo odhalené počas vývoja pohybu.
Postupné prompty môžu vyjadrovať udalosti bežným jazykom alebo približnými časovými značkami. Tieto značky usmerňujú poradie a približné časovanie; nie sú zárukou vykonania presného na snímku. Požadovaným akciám dajte dostatok času na prirodzený priebeh v zvolenej dĺžke klipu.
Pri statickom zábere opíšte pohyb patriaci do záberu a posilnite zamýšľanú nehybnú kameru. Výrobca uvádza, že úplne nehybné pohľady môžu byť náročné, najmä pri niektorých širokých alebo úvodných záberoch. V skutočnom výsledku skontrolujte malé nechcené pohyby a nepredpokladajte, že fráza o statickej kamere ich znemožňuje.
Dĺžka, rozmery a snímková frekvencia
Gen-4.5 podporuje dĺžky klipov 2 až 10 sekúnd. Dlhšia voľba môže pojať viacero usporiadaných akcií, kým krátka reakcia alebo odhalenie môže použiť kratší záber. Dokumentovaný výstup je 720p s 24 alebo 25 snímkami za sekundu v generovacom postupe výrobcu.
Špecifikácia prevodu textu na video uvádza 16:9 pri 1280 × 720 pixeloch. Prevod obrázka na video navyše uvádza 9:16 pri 720 × 1280, 1:1 pri 960 × 960, 4:3 pri 1104 × 832, 3:4 pri 832 × 1104 a 21:9 pri 1584 × 672. Režim a skutočné rozmery držte spolu a nepredpokladajte rovnaký súbor pomerov strán v oboch vstupných režimoch.
Pomer obrázka môže určiť predvolenú kompozíciu a jeho zmena môže vstup orezať. Pred hodnotením pohybu skontrolujte umiestnenie subjektu: správna akcia nie je užitočná, ak bola dôležitá časť zdrojového obrázka odrezaná.
Zostavte dlhšiu postupnosť z dokončených záberov
Pri práci vedenej obrázkom výrobca opisuje pokračovanie postupnosti použitím poslednej snímky dokončeného klipu ako obrazového vstupu ďalšieho generovania. Klipy sa potom kombinujú vo video editore so spoločnou snímkou a časovaním riešenými pri strihu. Ide o postupnosť samostatných záberov, nie jedno generovanie s neobmedzenou dĺžkou.
Koncovú snímku a príslušné zadanie uchovajte, aby ďalší záber začal zo zamýšľaného vizuálneho stavu. V spojených záberoch skontrolujte kontinuitu vrátane vzhľadu subjektu, smeru kamery a prechodu medzi klipmi.
Uchovajte a skontrolujte produkčný výsledok
Po generovaní skontrolujte celý klip a uchovajte dokončený výstup. Postup výrobcu poskytuje aj samostatné možnosti zväčšenia a produkčného exportu ako ProRes alebo postupnosť PNG. Sú to ďalšie možnosti postupu; natívne rozmery generovania zostávajú odlišné od neskôr zväčšeného výsledku.
Gen-4.5 použite pre filmové koncepty, animované vizuálne nápady, doplnkové zábery a vývoj krátkych scén. Prompt, použitý vstupný obrázok, dĺžku, režim a vrátený klip uchovajte spolu. Skontrolujte poradie akcií, správanie kamery, detaily subjektu, nechcené strihy a zamýšľaný záber a potom vykonajte cielenú opravu záberu.
Ailoot Ultra · Video POST /v1/videos runway/gen-4.5
runway/gen-4.5Úvod
Runway Gen-4.5 vytvára videá z opisu scény alebo obrázka s pokynmi pohybu. Jeho klipy 2–10 sekúnd, explicitné kamerové zadania a samostatné kompozičné voľby prevodu textu a obrázka na video podporujú filmové koncepty, doplnkové zábery a animované vizuálne scény.
- Povolené vstupy
- Text · Obrázky
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Video POST /v1/videos
- Vstup
text,image- Výstup
video- Výstupný formát
- pôvodné bajty MP4; bez normalizácie a prekódovania
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity runway/gen-4.5 | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity | Predvolené— |
Poleduration | Typinteger | PožiadavkaPovinné | Hodnoty a limity 2, 3, 4, 5, 6, 7, 8, 9, 10 Minimum: 1 Maximum: 600 | Predvolené— |
Poleresolution | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 720p | Predvolené— |
Poleaspect_ratio | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 16:9, 9:16 | Predvolené— |
Polegenerate_audio | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity false | Predvolené— |
Poleframe_images | Typarray | PožiadavkaVoliteľné | Hodnoty a limity Minimálny počet položiek: 1 Maximálny počet položiek: 1 Vstupný obsah: Pole objektov snímok. Každý objekt má type=image_url, image_url obsahujúce url a frame_type. Použite HTTPS URL obrázka a nastavte frame_type na first_frame. Každá rola snímky sa môže vyskytnúť najviac raz. Presné kľúče: type, image_url, frame_type Podmienky: Tieto kľúče opisujú každý objekt snímky; image_url obsahuje iba url. Pri čisto textovej požiadavke vynechajte frame_images. | Predvolené— |
Poleinput_references | Typarray | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Polesize | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 1280x720, 720x1280 Vzor: ^[1-9][0-9]*x[1-9][0-9]*$ | Predvolené— |
Poleseed | Typinteger | PožiadavkaVoliteľné | Hodnoty a limity Minimum: -9 223 372 036 854 775 808 Maximum: 9 223 372 036 854 775 807 | Predvolené— |
Polecallback_url | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Vzor: ^https:// | Predvolené— |
Polesession_id | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poletrace | Typobject | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Poleuser | Typstring | PožiadavkaVoliteľné | Hodnoty a limity | Predvolené— |
Kombinácie vstupných podkladov
Z textu na video · Textové zadanie. · Povinné: model, prompt, duration
Zadajte prompt ako text a duration v celých sekundách. Vyberte podporované rozlíšenie; pridajte pomer strán alebo použite uvedenú veľkosť.
model: Typ: string · runway/gen-4.5
prompt: Typ: string · Maximálny počet bajtov UTF-8: 10 000 · Vyžaduje sa aspoň jeden znak, ktorý nie je bielym znakom: Áno
Z obrázka na video · Textové zadanie a obrázok prvej snímky. · Povinné: model, prompt, duration, frame_images
frame_images je pole. Každý objekt snímky má type, image_url a frame_type; image_url obsahuje url. Nastavte type na image_url. Použite first_frame. Každá rola snímky sa môže vyskytnúť najviac raz. Pre každú snímku zadajte verejnú HTTPS URL obrázka. Vyberte podporované rozlíšenie; pridajte pomer strán alebo použite uvedenú veľkosť.
Presné kľúče: type, image_url, frame_type
model: Typ: string · runway/gen-4.5
prompt: Typ: string · Maximálny počet bajtov UTF-8: 10 000 · Vyžaduje sa aspoň jeden znak, ktorý nie je bielym znakom: Áno
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt, duration |
Parametermaterial_types | Špecifikáciatext, image |
Parameteradditional_properties | Špecifikáciafalse |
Parameteroptional_controls | Špecifikáciaresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Životný cyklus: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Cenník
Ako sa vypočíta konečný poplatok
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Odhadované sadzby na porovnanie
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Odhadované množstvo | Účtovacia jednotka | Podmienky účtovania | Poplatok |
|---|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Účtovacia jednotka— | Podmienky účtovania— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| KonfiguráciaCena videa | Sadzobník— | Odhadované množstvo— | Účtovacia jednotkaza sekundu videa | Podmienky účtovaniaV tomto cenovom kľúči nie je uvedená žiadna ďalšia podmienka. | Poplatok Výstup · Cena videa · Odhad iba na porovnanie $0.24 za sekundu videa |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Účtovacia jednotka— | Podmienky účtovania— | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.48 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie. |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Podrobnosti referenčnej tarify
Referenčné sadzobníky modelu nemenia výber metódy, cenové odhady ani poplatky. Aktívne poplatky používajú sadzby vybranej metódy Ailoot.
Cenové referencie konfigurácií videa
Ceny podľa konfigurácie
| Konfigurácia | Podmienky účtovania | Poplatok |
|---|---|---|
| KonfiguráciaCena videa | Podmienky účtovaniaV tomto cenovom kľúči nie je uvedená žiadna ďalšia podmienka. | Poplatok Výstup · Cena videa $0.24 za sekundu videa Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou. |
Príklady požiadaviek
Ailoot Ultra · Video
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
Prijať a uložiť výsledky
Ailoot Ultra · Video
podpísané URL obsahu vo vašom vlastníctve
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Skontrolovať stav úlohy
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
Čítanie ďalšieho obsahu
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
Uchovať všetky dokončené výsledky
Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.
Zachovajte každý skutočný výstup vo vašom vlastníctve a jeho vrátené namerané metadáta.
Ak treba overiť pôvodnú odpoveď
503 result_pending_check + pôvodné id + X-Should-Retry:false; pôvodnú požiadavku nikdy znova neodosielajte
Polia odpovede
| Pole | Typ | Význam |
|---|---|---|
Poleindex | Typinteger | VýznamPozícia tohto videa v zozname výstupov, číslovaná od nuly. |
Polecontent_url | Typstring | VýznamPodpísaná HTTPS URL na stiahnutie tohto dokončeného videa. |
Polesha256 | Typstring | null | VýznamOdtlačok SHA-256 pôvodných bajtov videa; null, ak nie je dostupný. |
Polesize_bytes | Typinteger | null | VýznamVeľkosť pôvodného videosúboru v bajtoch; null, ak nie je dostupná. |
Poleduration_ms | Typinteger | null | VýznamNameraná dĺžka videa v milisekundách; null, ak nie je dostupná. |
Polewidth | Typinteger | null | VýznamŠírka videa v pixeloch; null, ak nie je dostupná. |
Poleheight | Typinteger | null | VýznamVýška videa v pixeloch; null, ak nie je dostupná. |
Polevideo_codec | Typstring | null | VýznamIdentifikátor video kodeku; null, ak nie je zaznamenaný. |
Polehas_audio | Typboolean | null | VýznamČi video obsahuje zvukovú stopu; null, ak sa to nemeralo. |
Poleaudio_codec | Typstring | null | VýznamIdentifikátor zvukového kodeku; null, keď nie je zaznamenaný žiadny identifikátor. |
Chyby a ďalšie kroky
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď404 · not_found_error | PodmienkaPrístup k videu nie je dostupný alebo sa toto ID videa nenašlo. | Ďalší krokSkontrolujte prístup k videu. Pri existujúcom videu použite jeho pôvodné verejné ID a rovnaký kľúč API. |
Odpoveď401 · authentication_error | PodmienkaKľúč API nezodpovedá overenému účtu. | Ďalší krokPred odoslaním skontrolujte svoj kľúč API a prístup účtu. |
Odpoveď400 · invalid_request_error | PodmienkaPožiadavku sa nepodarilo načítať alebo je index sťahovania neplatný. | Ďalší krokOpravte telo požiadavky. Pri sťahovaní vyberte index výstupu vrátený pôvodnou úlohou. |
Odpoveď422 · price_unavailable | PodmienkaCenu vybranej konfigurácie videa nemožno určiť. | Ďalší krokVyberte podporovanú konfiguráciu videa a pred odoslaním opravenej požiadavky vyplňte jej povinné možnosti. |
Odpoveď422 · invalid_request_error | PodmienkaVstup videa alebo pôvodná úloha pokračovania sú neplatné. | Ďalší krokPoužite platné vstupy HTTPS. Pri pokračovaní použite verejné ID svojho dokončeného pôvodného videa s rovnakým kľúčom API. |
Odpoveď402 · billing_error | PodmienkaDostupný zostatok alebo limity neumožňujú rezerváciu. | Ďalší krokPred odoslaním novej požiadavky skontrolujte dostupný zostatok a limity. |
Odpoveď503 · server_error | PodmienkaOverovanie videa, úložisko alebo prístup k službe sú dočasne nedostupné. | Ďalší krokPočkajte na dostupnosť služby. Ak už máte ID videa, skontrolujte pôvodnú úlohu namiesto vytvorenia ďalšieho generovania. |
Odpoveď503 · result_pending_check | PodmienkaPôvodný výsledok videa a poplatok treba skontrolovať. | Ďalší krokZachovajte vrátené ID videa a skontrolujte danú úlohu. Počas jej kontroly neodosielajte náhradnú požiadavku na generovanie. |
Odpoveď503 · owned_result_unavailable | PodmienkaStiahnutie existujúceho videa je dočasne nedostupné. | Ďalší krokNeskôr skontrolujte tú istú úlohu videa a stiahnite jej existujúci výstup. Nové generovanie vytvára samostatnú operáciu. |
Odpoveď409 · video_not_ready | PodmienkaObsah videa nebol zverejnený. | Ďalší krokSkontrolujte stav pôvodnej úlohy. Keď hlási completed, stiahnite jej výsledok; ak hlási failed, riaďte sa jej oznámením o kontrole poplatku. |
Aliasy
Aliasy modelov
Ailoot Ultra runway/gen-4.5
Aliasy ciest metód
Použite cesty metód uvedené vyššie.
Súvisiace ID na volanie
FAQ · Runway: Gen-4.5
- Aké vstupy a výsledky sú dostupné?
POST /v1/videos·runway/gen-4.5:text,image→video- Aké polia používa požiadavka?
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- Aké limity platia?
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