Runway: Gen-4.5
Runway Gen-4.5 vytváří videa z popisu scény nebo obrázku s pokyny pohybu. Jeho klipy o délce 2–10 sekund, konkrétní pokyny pro kameru a odlišné možnosti kompozice pro převod textu a obrázku na video podporují filmové koncepty, doplňkové záběry a animované vizuální scény.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
Runway Gen-4.5 je model generování videa s režimy převodu textu a obrázku na video. Dokáže sledovat zadání popisující kompozici scény, akci objektu, choreografii kamery a posloupnost událostí. Užitečným výsledkem je krátký generovaný záběr, který lze zkontrolovat, uchovat nebo sestavit s dalšími záznamy.
Vyberte vstupní režim záběru
Převod textu na video začíná písemným popisem scény. Zahrňte viditelný obsah i pohyb: objekt, prostředí, osvětlení, rámování, akci a chování kamery. Tento režim se hodí pro novou scénu, doplňkové záběry, podklad pozadí nebo vizuální koncept, kde počáteční snímek nemusí reprodukovat dodaný obrázek.
Převod obrázku na video začíná obrázkem sloužícím jako první snímek. Ten dodává kompozici, obsah, osvětlení a styl. Písemný prompt zaměřte na následující děj: akci objektu, pohyb v prostředí, pohyb kamery a vývoj záběru.
Připravte jasný obrázek s již viditelnými důležitými detaily. Rozmazané tváře, ruce nebo jiné artefakty se mohou po animaci zvýraznit. Reference naznačující rychlý pohyb prachem nebo pohybovým rozmazáním může také odporovat promptu žádajícímu nehybný objekt.
Vizuál a pohyb popisujte přímo
Používejte jasný přirozený jazyk a pozitivní popisy zamýšleného výsledku. Zadání textu na video může nejprve uvést pohled kamery, objekt a akci a potom přidat zpracování scény. Podrobný popis je užitečný u záběru s definovanými požadavky; jednodušší dává větší prostor zkoumání. Žádný ideální počet slov nenahrazuje jasnost.
Například popište blízký pohled na mosaznou stolní lampu při rozsvícení následovaný pomalým pohybem kamery odhalujícím zápisník vedle ní. U textu na video uveďte viditelné materiály a světlo. Pokud tyto podrobnosti již stanovuje dodaný obrázek, prompt obrázku na video se může soustředit na změnu světla a odhalení kamerou.
Vyhněte se protichůdným pokynům. Pevný pohled s jemným pohybem objektu se liší od energického sledovacího záběru z ruky. Přidejte podrobnosti definující užitečný záběr, nikoli dlouhý seznam nesouvisejících vizuálních stylů.
Kamerové termíny a posloupnost akcí
Příručka kamery výrobce rozlišuje rámování, úhly, pohyb a ostření. Detail mění to, co vyplňuje snímek, podhled mění perspektivu, panorámování otáčí pohled kamery a sledovací pohyb následuje objekt. Pokyn přeostření posouvá ostrost mezi viditelnými objekty. Uveďte, co má být vidět nebo odhaleno během rozvoje pohybu.
Sekvenční prompty mohou vyjádřit události běžným jazykem nebo přibližnými časovými značkami. Tyto značky vedou pořadí a přibližné časování; nezaručují provedení přesné na snímek. Požadovaným akcím dejte dost času na přirozený průběh v rámci vybrané délky klipu.
U statického záběru popište pohyb patřící dovnitř snímku a podpořte zamýšlenou nehybnou kameru. Výrobce upozorňuje, že zcela nehybné pohledy mohou být obtížné, zvláště u některých celků nebo úvodních záběrů. Malé nežádoucí pohyby ověřte ve skutečném výsledku, místo předpokladu, že formulace statické kamery je znemožňuje.
Délka, rozměry a snímková frekvence
Gen-4.5 podporuje délky klipů od 2 do 10 sekund. Delší volba pojme několik seřazených akcí, zatímco krátká reakce či odhalení může použít kratší záběr. Dokumentovaný výstup je 720p s 24 nebo 25 snímky za sekundu v generovacím postupu výrobce.
Specifikace textu na video uvádí 16:9 při 1280 × 720 pixelech. Obrázek na video navíc uvádí 9:16 při 720 × 1280, 1:1 při 960 × 960, 4:3 při 1104 × 832, 3:4 při 832 × 1104 a 21:9 při 1584 × 672. Režim a skutečné rozměry uchovávejte společně, místo předpokladu, že oba vstupní režimy nabízejí stejnou sadu poměrů stran.
Poměr obrázku může určit výchozí kompozici a jeho změna může vstup oříznout. Před posouzením pohybu zkontrolujte umístění objektu: správná akce není užitečná, pokud byla oříznuta klíčová část zdrojového obrázku.
Sestavte delší sekvenci z dokončených záběrů
U obrazově vedené práce výrobce popisuje pokračování sekvence použitím posledního snímku dokončeného klipu jako obrazového vstupu dalšího generování. Klipy se potom spojí ve videoeditoru, kde se při střihu řeší sdílený snímek a časování. Jde o posloupnost samostatných záběrů, nikoli o jedno generování neomezené délky.
Uchovejte koncový snímek a odpovídající zadání, aby další záběr začal ze zamýšleného vizuálního stavu. Ve spojeném záznamu kontrolujte návaznost včetně vzhledu objektu, směru kamery a přechodu mezi klipy.
Uchovejte a zkontrolujte produkční výstup
Po generování zkontrolujte celý klip a uchovejte dokončený výstup. Postup výrobce poskytuje také samostatné možnosti zvětšení a produkčního exportu, například ProRes nebo sekvenci PNG. Jde o dodatečné možnosti postupu; nativní rozměry generování zůstávají odlišné od pozdějšího zvětšeného výsledku.
Gen-4.5 použijte pro filmové koncepty, animované vizuální nápady, doplňkové záběry a vývoj krátkých scén. Prompt, použitý vstupní obrázek, délku, režim a vrácený klip uchovávejte společně. Zkontrolujte pořadí akcí, chování kamery, detaily objektu, nežádoucí střihy a zamýšlené rámování a potom proveďte cílenou opravu záběru.
Ailoot Ultra · Video POST /v1/videos runway/gen-4.5
runway/gen-4.5Úvod
Runway Gen-4.5 vytváří videa z popisu scény nebo obrázku s pokyny pohybu. Jeho klipy o délce 2–10 sekund, konkrétní pokyny pro kameru a odlišné možnosti kompozice pro převod textu a obrázku na video podporují filmové koncepty, doplňkové záběry a animované vizuální scény.
- Přijímané vstupy
- Text · Obrázky
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Video POST /v1/videos
- Vstup
text,image- Výstup
video- Výstupní formát
- původní bajty MP4; bez normalizace a překódování
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity runway/gen-4.5 | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Poleduration | Typinteger | PožadavekPovinné | Hodnoty a limity 2, 3, 4, 5, 6, 7, 8, 9, 10 Minimum: 1 Maximum: 600 | Výchozí— |
Poleresolution | Typstring | PožadavekVolitelné | Hodnoty a limity 720p | Výchozí— |
Poleaspect_ratio | Typstring | PožadavekVolitelné | Hodnoty a limity 16:9, 9:16 | Výchozí— |
Polegenerate_audio | Typboolean | PožadavekVolitelné | Hodnoty a limity false | Výchozí— |
Poleframe_images | Typarray | PožadavekVolitelné | Hodnoty a limity Minimální počet položek: 1 Maximální počet položek: 1 Vstupní obsah: Pole objektů snímků. Každý objekt obsahuje type=image_url, image_url obsahující url a frame_type. Použijte HTTPS URL obrázku a nastavte frame_type na first_frame. Každá role snímku se smí vyskytnout nejvýše jednou. Přesné klíče: type, image_url, frame_type Podmínky: Tyto klíče popisují každý objekt snímku; image_url obsahuje pouze url. Pro požadavek obsahující pouze text vynechte frame_images. | Výchozí— |
Poleinput_references | Typarray | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Polesize | Typstring | PožadavekVolitelné | Hodnoty a limity 1280x720, 720x1280 Vzor: ^[1-9][0-9]*x[1-9][0-9]*$ | Výchozí— |
Poleseed | Typinteger | PožadavekVolitelné | Hodnoty a limity Minimum: -9 223 372 036 854 775 808 Maximum: 9 223 372 036 854 775 807 | Výchozí— |
Polecallback_url | Typstring | PožadavekVolitelné | Hodnoty a limity Vzor: ^https:// | Výchozí— |
Polesession_id | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poletrace | Typobject | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poleuser | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Kombinace vstupních materiálů
Text na video · Textové zadání. · Povinné: model, prompt, duration
Zadejte prompt jako text a duration v celých sekundách. Vyberte podporované rozlišení; přidejte poměr stran nebo použijte uvedenou velikost.
model: Typ: string · runway/gen-4.5
prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano
Obrázek na video · Textové zadání a obrázek prvního snímku. · Povinné: model, prompt, duration, frame_images
frame_images je pole. Každý objekt snímku obsahuje type, image_url a frame_type; image_url obsahuje url. Nastavte type na image_url. Použijte first_frame. Každá role snímku se smí vyskytnout nejvýše jednou. Pro každý snímek zadejte veřejnou HTTPS URL obrázku. Vyberte podporované rozlišení; přidejte poměr stran nebo použijte uvedenou velikost.
Přesné klíče: type, image_url, frame_type
model: Typ: string · runway/gen-4.5
prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt, duration |
Parametrmaterial_types | Kontrakttext, image |
Parametradditional_properties | Kontraktfalse |
Parametroptional_controls | Kontraktresolution, 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
Tarify
Jak se vypočítá konečný poplatek
Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
- Rychlý režim
- Neuvedeno Při výběru rychlého režimu
- Režim flex
- Neuvedeno Při výběru režimu flex
- Maximální intenzita uvažování
- Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)
Odhadované sazby pro srovnání
Ceny podle konfigurace
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Předpokládané množství | Účtovací jednotka | Podmínky účtování | Poplatek |
|---|---|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Předpokládané množství— | Účtovací jednotka— | Podmínky účtování— | Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů |
| KonfiguraceCena videa | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza sekundu videa | Podmínky účtováníV tomto cenovém klíči není uvedena žádná další podmínka. | Poplatek Výstup · Cena videa · Odhad pouze pro srovnání $0.24 za sekundu videa |
| KonfiguraceOdhadovaná cena generování | Tabulka sazeb— | Předpokládané množstvíodhad pro jedno generování | Účtovací jednotka— | Podmínky účtování— | Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.48 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování. |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
Podrobnosti referenčního tarifu
Referenční tabulky modelu nemění výběr metody, cenové nabídky ani poplatky. Skutečné poplatky používají sazby vybrané metody Ailoot.
Cenové reference konfigurací videa
Ceny podle konfigurace
| Konfigurace | Podmínky účtování | Poplatek |
|---|---|---|
| KonfiguraceCena videa | Podmínky účtováníV tomto cenovém klíči není uvedena žádná další podmínka. | Poplatek Výstup · Cena videa $0.24 za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci. |
Příklady požadavků
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
Přijímání a ukládání výsledků
Ailoot Ultra · Video
podepsané URL obsahu spravovaného službou
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Ověřit 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
Další načtení 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
Uchovejte všechny dokončené výsledky
Uložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.
Uchovejte každý skutečný výstup spravovaný službou a jeho vrácená metadata s naměřenými hodnotami.
Pokud je nutné ověřit původní odpověď
503 result_pending_check + původní id + X-Should-Retry:false; původní požadavek nikdy neopakujte
Pole odpovědi
| Pole | Typ | Význam |
|---|---|---|
Poleindex | Typinteger | VýznamPozice tohoto videa v seznamu výstupů, číslovaná od nuly. |
Polecontent_url | Typstring | VýznamPodepsaná HTTPS URL pro stažení tohoto dokončeného videa. |
Polesha256 | Typstring | null | VýznamOtisk SHA-256 původních bajtů videa; null, není-li dostupný. |
Polesize_bytes | Typinteger | null | VýznamVelikost původního videosouboru v bajtech; null, není-li dostupná. |
Poleduration_ms | Typinteger | null | VýznamNaměřená délka videa v milisekundách; null, není-li dostupná. |
Polewidth | Typinteger | null | VýznamŠířka videa v pixelech; null, není-li dostupná. |
Poleheight | Typinteger | null | VýznamVýška videa v pixelech; null, není-li dostupná. |
Polevideo_codec | Typstring | null | VýznamIdentifikátor video kodeku; null, není-li zaznamenán. |
Polehas_audio | Typboolean | null | VýznamZda video obsahuje zvukovou stopu; null, nebylo-li změřeno. |
Poleaudio_codec | Typstring | null | VýznamIdentifikátor zvukového kodeku; null, není-li žádný identifikátor zaznamenán. |
Chyby a další kroky
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď404 · not_found_error | PodmínkaPřístup k videu není dostupný nebo toto ID videa nebylo nalezeno. | Další krokZkontrolujte přístup k videu. U existujícího videa použijte jeho původní veřejné ID a stejný klíč API. |
Odpověď401 · authentication_error | PodmínkaKlíč API neodpovídá ověřenému účtu. | Další krokPřed odesláním zkontrolujte svůj klíč API a přístup k účtu. |
Odpověď400 · invalid_request_error | PodmínkaPožadavek se nepodařilo načíst nebo je index pro stažení neplatný. | Další krokOpravte tělo požadavku. Pro stažení vyberte index výstupu vrácený původní úlohou. |
Odpověď422 · price_unavailable | PodmínkaVybranou konfiguraci videa nelze ocenit. | Další krokPřed odesláním opraveného požadavku zvolte podporovanou konfiguraci videa a vyplňte její povinné volby. |
Odpověď422 · invalid_request_error | PodmínkaVstup videa nebo původní úloha pro pokračování jsou neplatné. | Další krokPoužívejte platné HTTPS vstupy. Pro pokračování použijte původní veřejné ID svého dokončeného videa se stejným klíčem API. |
Odpověď402 · billing_error | PodmínkaDostupný zůstatek nebo limity neumožňují rezervaci. | Další krokPřed odesláním nového požadavku zkontrolujte dostupný zůstatek a limity. |
Odpověď503 · server_error | PodmínkaOvěřování videa, úložiště nebo přístup ke službě jsou dočasně nedostupné. | Další krokPočkejte na dostupnost služby. Pokud už máte ID videa, kontrolujte tuto původní úlohu místo vytváření dalšího generování. |
Odpověď503 · result_pending_check | PodmínkaPůvodní výsledek videa a vyúčtovanou částku je třeba zkontrolovat. | Další krokUchovejte vrácené ID videa a kontrolujte tuto úlohu. Dokud probíhá kontrola, neposílejte náhradní požadavek na generování. |
Odpověď503 · owned_result_unavailable | PodmínkaStávající video je dočasně nedostupné ke stažení. | Další krokPozději zkontrolujte tutéž úlohu videa a stáhněte její existující výstup. Nové generování vytvoří samostatnou operaci. |
Odpověď409 · video_not_ready | PodmínkaObsah videa nebyl zveřejněn. | Další krokZkontrolujte stav původní úlohy. Stáhněte výstup, až nahlásí completed; nahlásí-li failed, řiďte se jejím upozorněním na kontrolu vyúčtování. |
Aliasy
Aliasy modelu
Ailoot Ultra runway/gen-4.5
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
FAQ · Runway: Gen-4.5
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/videos·runway/gen-4.5:text,image→video- Jaká pole požadavek používá?
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- Jaké limity platí?
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