Runway: Gen-4.5
Runway Gen-4.5 crea video da una descrizione di scena o da un’immagine con indicazioni di movimento. I clip di 2–10 secondi, i prompt espliciti per la camera e le scelte di composizione separate per testo e immagini supportano concept cinematografici, B-roll e scene visive animate.
Informazioni sul modello
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
Runway Gen-4.5 è un modello di generazione video con modalità da testo e da immagini. Può seguire un brief che descrive composizione della scena, azione del soggetto, coreografia della camera e una sequenza di eventi. Il risultato utile è una breve inquadratura generata che può essere controllata, conservata o assemblata con altri filmati.
Scegliere la modalità di ingresso per l’inquadratura
La generazione di video da testo parte da una descrizione scritta della scena. Includi sia il contenuto visibile sia il movimento: soggetto, ambientazione, illuminazione, inquadratura, azione e comportamento della camera. Questa modalità è utile per una nuova scena, B-roll, uno sfondo per compositing o un concept visivo in cui il fotogramma iniziale non deve riprodurre un’immagine fornita.
La generazione di video da immagini parte da un’immagine che funge da primo fotogramma. Quell’immagine fornisce composizione, contenuto, illuminazione e stile. Concentra il prompt scritto su ciò che deve accadere dopo: azione del soggetto, movimento nell’ambiente, movimento di camera e progressione dell’inquadratura.
Prepara un’immagine chiara con i dettagli importanti già visibili. Volti o mani sfocati e altri artefatti possono diventare più evidenti una volta animati. Un riferimento che suggerisce movimento rapido tramite polvere o sfocatura di movimento può anche essere in conflitto con un prompt che richiede un soggetto fermo.
Descrivere direttamente immagini e movimento
Usa un linguaggio naturale chiaro e descrizioni positive del risultato desiderato. Un brief da testo può indicare prima la vista della camera, il soggetto e l’azione, poi aggiungere il trattamento della scena. Una descrizione dettagliata è utile quando l’inquadratura ha requisiti definiti; una più semplice lascia maggiore spazio all’esplorazione. Non esiste un numero ideale di parole che sostituisca la chiarezza.
Per esempio, descrivi una vista ravvicinata di una lampada da scrivania in ottone mentre si accende, seguita da un lento movimento di camera che rivela un taccuino accanto. Specifica materiali visibili e luce per la generazione da testo. Se un’immagine fornita definisce già questi dettagli, il prompt da immagine può concentrarsi sul cambiamento della luce e sulla rivelazione tramite la camera.
Evita indicazioni contraddittorie. Una vista fissa con un movimento lieve del soggetto è diversa da un’energica ripresa d’inseguimento a camera a mano. Aggiungi i dettagli che definiscono l’inquadratura utile invece di una lunga lista di stili visivi non collegati.
Termini di camera e azioni in sequenza
La guida di camera del produttore distingue inquadratura, angolazioni, movimento e messa a fuoco. Un primo piano cambia ciò che riempie il fotogramma, un’angolazione dal basso cambia la prospettiva, una panoramica ruota la vista della camera e una carrellata d’accompagnamento segue un soggetto. Un’istruzione di cambio di fuoco sposta la messa a fuoco tra soggetti visibili. Specifica che cosa deve essere in vista o rivelato mentre il movimento si sviluppa.
I prompt sequenziali possono esprimere gli eventi in linguaggio comune o con indicazioni temporali approssimative. Queste guidano l’ordine e i tempi indicativi; non garantiscono un’esecuzione esatta al fotogramma. Lascia alle azioni richieste tempo sufficiente per svolgersi naturalmente entro la durata scelta del clip.
Per un’inquadratura statica, descrivi il movimento che appartiene all’interno del fotogramma e rafforza l’intenzione di una camera ferma. Il produttore osserva che viste completamente immobili possono essere difficili, soprattutto in alcuni campi larghi o inquadrature d’ambientazione. Controlla i piccoli movimenti indesiderati nel risultato effettivo invece di presumere che una frase sulla camera statica li renda impossibili.
Durata, dimensioni e frame rate
Gen-4.5 supporta durate da 2 a 10 secondi. Una scelta più lunga può contenere più azioni ordinate, mentre una breve reazione o rivelazione può usare un’inquadratura più corta. L’output documentato è 720p, a 24 o 25 fotogrammi al secondo nel flusso di generazione del produttore.
La specifica da testo elenca 16:9 a 1280 × 720 pixel. Quella da immagini aggiunge 9:16 a 720 × 1280, 1:1 a 960 × 960, 4:3 a 1104 × 832, 3:4 a 832 × 1104 e 21:9 a 1584 × 672. Mantieni associati modalità e dimensioni effettive invece di presumere che entrambe le modalità di ingresso offrano gli stessi rapporti d’aspetto.
Il rapporto d’aspetto di un’immagine può definire la composizione predefinita, e cambiarlo può ritagliare l’input. Controlla la posizione del soggetto prima di giudicare il movimento: un’azione corretta non è utile se una parte essenziale dell’immagine sorgente è stata tagliata.
Costruire una sequenza più lunga da inquadrature completate
Per lavori guidati da immagini, il produttore descrive la continuazione di una sequenza usando l’ultimo fotogramma di un clip completato come immagine di ingresso di un’altra generazione. I clip vengono poi combinati in un editor video, gestendo nel montaggio il fotogramma condiviso e i tempi. È una sequenza di inquadrature separate, non una singola generazione di durata illimitata.
Conserva il fotogramma finale e il brief corrispondente, così l’inquadratura successiva parte dallo stato visivo previsto. Controlla la continuità nel filmato assemblato, compresi aspetto del soggetto, direzione della camera e transizione tra clip.
Conservare e controllare il risultato di produzione
Dopo la generazione, controlla l’intero clip e conserva l’output completato. Il flusso del produttore offre anche scelte separate di ingrandimento e di esportazione per la produzione, come ProRes o una sequenza PNG. Sono opzioni aggiuntive del flusso; le dimensioni native di generazione restano distinte da un risultato ingrandito successivamente.
Usa Gen-4.5 per concept cinematografici, idee visive animate, B-roll e sviluppo di brevi scene. Conserva insieme prompt, eventuale immagine di ingresso, durata, modalità e clip restituito. Controlla ordine delle azioni, comportamento della camera, dettagli del soggetto, tagli indesiderati e inquadratura prevista, poi apporta una correzione mirata alla ripresa.
Ailoot Ultra · Video POST /v1/videos runway/gen-4.5
runway/gen-4.5Introduzione
Runway Gen-4.5 crea video da una descrizione di scena o da un’immagine con indicazioni di movimento. I clip di 2–10 secondi, i prompt espliciti per la camera e le scelte di composizione separate per testo e immagini supportano concept cinematografici, B-roll e scene visive animate.
- Input accettati
- Testo · Immagini
- Risultati
- Video
Disponibile in Ailoot · input e metodi
Ailoot Ultra · Video POST /v1/videos
- Tipi di input
text,image- Tipi di output
video- Formato di output
- byte MP4 originali; nessuna normalizzazione o transcodifica
| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti runway/gen-4.5 | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti | Predefinito— |
Campoduration | Tipointeger | RequisitoObbligatorio | Valori e limiti 2, 3, 4, 5, 6, 7, 8, 9, 10 Minimo: 1 Massimo: 600 | Predefinito— |
Camporesolution | Tipostring | RequisitoFacoltativo | Valori e limiti 720p | Predefinito— |
Campoaspect_ratio | Tipostring | RequisitoFacoltativo | Valori e limiti 16:9, 9:16 | Predefinito— |
Campogenerate_audio | Tipoboolean | RequisitoFacoltativo | Valori e limiti false | Predefinito— |
Campoframe_images | Tipoarray | RequisitoFacoltativo | Valori e limiti Numero minimo di elementi: 1 Numero massimo di elementi: 1 Contenuto in input: Array di oggetti fotogramma. Ogni oggetto contiene type=image_url, image_url con url e frame_type. Usa un URL HTTPS dell'immagine e imposta frame_type su first_frame. Ogni ruolo del fotogramma compare al massimo una volta. Chiavi esatte: type, image_url, frame_type Condizioni: Queste chiavi descrivono ogni oggetto fotogramma; image_url contiene solo url. Ometti frame_images per una richiesta di solo testo. | Predefinito— |
Campoinput_references | Tipoarray | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Camposize | Tipostring | RequisitoFacoltativo | Valori e limiti 1280x720, 720x1280 Schema: ^[1-9][0-9]*x[1-9][0-9]*$ | Predefinito— |
Camposeed | Tipointeger | RequisitoFacoltativo | Valori e limiti Minimo: -9.223.372.036.854.775.808 Massimo: 9.223.372.036.854.775.807 | Predefinito— |
Campocallback_url | Tipostring | RequisitoFacoltativo | Valori e limiti Schema: ^https:// | Predefinito— |
Camposession_id | Tipostring | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Campotrace | Tipoobject | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Campouser | Tipostring | RequisitoFacoltativo | Valori e limiti | Predefinito— |
Combinazioni di materiali in input
Da testo a video · Un prompt scritto. · Obbligatorio: model, prompt, duration
Fornisci il prompt come testo e la durata in secondi interi. Scegli una risoluzione supportata; aggiungi un rapporto d'aspetto oppure usa una dimensione elencata.
model: Tipo: string · runway/gen-4.5
prompt: Tipo: string · Numero massimo di byte UTF-8: 10.000 · Sono richiesti caratteri diversi dagli spazi: Sì
Da immagine a video · Un prompt scritto e un'immagine del primo fotogramma. · Obbligatorio: model, prompt, duration, frame_images
frame_images è un array. Ogni oggetto fotogramma contiene type, image_url e frame_type; image_url contiene url. Imposta type su image_url. Usa first_frame. Ogni ruolo del fotogramma può comparire al massimo una volta. Fornisci un URL HTTPS pubblico dell'immagine per ogni fotogramma. Scegli una risoluzione supportata; aggiungi un rapporto d'aspetto oppure usa una dimensione elencata.
Chiavi esatte: type, image_url, frame_type
model: Tipo: string · runway/gen-4.5
prompt: Tipo: string · Numero massimo di byte UTF-8: 10.000 · Sono richiesti caratteri diversi dagli spazi: Sì
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, prompt, duration |
Parametromaterial_types | Contrattotext, image |
Parametroadditional_properties | Contrattofalse |
Parametrooptional_controls | Contrattoresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Ciclo di vita: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Tariffe
Calcolo del costo finale
Le tariffe visualizzate stimano il costo prima della generazione. L'addebito finale viene calcolato in base al costo registrato per la generazione originale. La durata misurata dell'output e le quantità previste non costituiscono la quantità finale fatturabile.
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
- Modalità rapida
- Non specificato Quando è selezionata la modalità rapida
- Modalità flex
- Non specificato Quando è selezionata la modalità flex
- Sforzo massimo di ragionamento
- Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)
Tariffe stimate per il confronto
Prezzi per configurazione
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Quantità prevista | Unità di fatturazione | Condizioni di fatturazione | Costo |
|---|---|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Quantità prevista— | Unità di fatturazione— | Condizioni di fatturazione— | Costo Input · Token in input · Stima solo a fini di confronto — / 1K token Output · Token in output · Stima solo a fini di confronto — / 1K token Input · Lettura dalla cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache · Stima solo a fini di confronto — / 1K token Input · Scrittura nella cache, 1 ora · Stima solo a fini di confronto — / 1K token |
| ConfigurazionePrezzo del video | Listino delle tariffe— | Quantità prevista— | Unità di fatturazioneper secondo di video | Condizioni di fatturazioneIn questa chiave tariffaria non è dichiarata alcuna condizione aggiuntiva. | Costo Output · Prezzo del video · Stima solo a fini di confronto $0.24 per secondo di video |
| ConfigurazioneCosto stimato della generazione | Listino delle tariffe— | Quantità previstastima per una generazione | Unità di fatturazione— | Condizioni di fatturazione— | Costo Output · Costo di generazione stimato · Stima solo a fini di confronto $0.48 stima prima della generazione Questa stima non è un addebito aggiuntivo né una tariffa fissa per la generazione completata. |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
Dettagli della tariffa di riferimento
I listini di riferimento del modello non modificano la selezione del metodo, i preventivi o gli addebiti. Gli addebiti attivi usano le tariffe del metodo Ailoot selezionato.
Riferimenti tariffari delle configurazioni video
Prezzi per configurazione
| Configurazione | Condizioni di fatturazione | Costo |
|---|---|---|
| ConfigurazionePrezzo del video | Condizioni di fatturazioneIn questa chiave tariffaria non è dichiarata alcuna condizione aggiuntiva. | Costo Output · Prezzo del video $0.24 per secondo di video Riferimento di prezzo pubblicato per la configurazione mostrata. Gli addebiti finali seguono la configurazione effettivamente fatturata. |
Esempi di richieste
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
Ricevi e salva i risultati
Ailoot Ultra · Video
URL firmati di contenuti di tua proprietà
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Verifica lo stato dell’attività
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
Altre letture di contenuto
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
Conserva tutti i risultati completati
Salva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito.
Conserva ogni risultato effettivo di tua proprietà e i metadati misurati restituiti.
Se occorre verificare la risposta originale
503 result_pending_check + id originale + X-Should-Retry:false; non ripetere mai l'operazione originale
Campi della risposta
| Campo | Tipo | Significato |
|---|---|---|
Campoindex | Tipointeger | SignificatoPosizione di questo video nell'elenco dei risultati, con indice a partire da zero. |
Campocontent_url | Tipostring | SignificatoURL HTTPS firmato per il download di questo video completato. |
Camposha256 | Tipostring | null | SignificatoDigest SHA-256 dei byte video originali; null se non disponibile. |
Camposize_bytes | Tipointeger | null | SignificatoDimensione del file video originale in byte; null se non disponibile. |
Campoduration_ms | Tipointeger | null | SignificatoDurata misurata del video in millisecondi; null se non disponibile. |
Campowidth | Tipointeger | null | SignificatoLarghezza del video in pixel; null se non disponibile. |
Campoheight | Tipointeger | null | SignificatoAltezza del video in pixel; null se non disponibile. |
Campovideo_codec | Tipostring | null | SignificatoIdentificatore del codec video; null se non registrato. |
Campohas_audio | Tipoboolean | null | SignificatoIndica se il video contiene una traccia audio; null se non misurato. |
Campoaudio_codec | Tipostring | null | SignificatoIdentificatore del codec audio; null quando non è registrato alcun identificatore. |
Errori e passaggi successivi
| Risposta | Condizione | Passaggio successivo |
|---|---|---|
Risposta404 · not_found_error | CondizioneL'accesso al video non è disponibile oppure questo ID video non è stato trovato. | Passaggio successivoVerifica l'accesso al video. Per un video esistente, usa l'ID pubblico originale e la stessa chiave API. |
Risposta401 · authentication_error | CondizioneLa chiave API non corrisponde all'account autenticato. | Passaggio successivoVerifica la chiave API e l'accesso all'account prima dell'invio. |
Risposta400 · invalid_request_error | CondizioneNon è stato possibile leggere la richiesta oppure l'indice di download non è valido. | Passaggio successivoCorreggi il corpo della richiesta. Per un download, scegli un indice di uscita restituito dall'attività originale. |
Risposta422 · price_unavailable | CondizioneNon è possibile determinare il prezzo della configurazione video selezionata. | Passaggio successivoScegli una configurazione video supportata e completa le opzioni obbligatorie prima di inviare una richiesta corretta. |
Risposta422 · invalid_request_error | CondizioneUn input video o l'attività originale di continuazione non è valido. | Passaggio successivoUsa input HTTPS validi. Per la continuazione, usa l'ID video pubblico del tuo originale completato con la stessa chiave API. |
Risposta402 · billing_error | CondizioneIl saldo disponibile o i limiti non consentono di riservare l'importo. | Passaggio successivoControlla il saldo disponibile e i limiti prima di inviare una nuova richiesta. |
Risposta503 · server_error | CondizioneLa verifica video, l’archiviazione o l’accesso al servizio sono temporaneamente indisponibili. | Passaggio successivoAttendi che il servizio sia disponibile. Se hai già un ID video, verifica quell'attività originale invece di creare un'altra generazione. |
Risposta503 · result_pending_check | CondizioneIl risultato video originale e l'addebito devono essere verificati. | Passaggio successivoConserva l'ID video restituito e verifica quell'attività. Non inviare una richiesta di generazione sostitutiva mentre la verifica è in corso. |
Risposta503 · owned_result_unavailable | CondizioneIl download del video esistente è temporaneamente indisponibile. | Passaggio successivoVerifica in seguito la stessa attività video e scarica il risultato esistente. Una nuova generazione crea un'operazione separata. |
Risposta409 · video_not_ready | CondizioneIl contenuto video non è stato pubblicato. | Passaggio successivoVerifica lo stato dell'attività originale. Scarica dopo che segnala completed; se segnala failed, segui l'avviso di verifica dell'addebito. |
Alias
Alias del modello
Ailoot Ultra runway/gen-4.5
Alias dei percorsi dei metodi
Usa i percorsi dei metodi indicati sopra.
ID di chiamata correlati
FAQ · Runway: Gen-4.5
- Quali input e risultati sono disponibili?
POST /v1/videos·runway/gen-4.5:text,image→video- Quali campi usa la richiesta?
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- Quali limiti si applicano?
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