Skip to main content
POST
cURL
Utilizza gen4.5 per generare un video da un Prompt di testo. Invia la tua chiave API CometAPI con autenticazione Bearer e un corpo della richiesta JSON.

Prepara la richiesta

  • Imposta model su gen4.5.
  • Descrivi la scena e il movimento in promptText, usando da 1 a 1.000 unità di codice UTF-16.
  • Imposta ratio su 1280:720 per l’orientamento orizzontale o su 720:1280 per quello verticale.
  • Imposta duration su un numero intero compreso tra 2 e 10 secondi.
Tutti e quattro i campi sono obbligatori. Per iniziare da un’immagine, usa Crea un’attività Runway da immagine a video. Non includere promptImage né un’opzione audio in questa richiesta da testo a video.

Imposta i controlli facoltativi

Per un seed di campionamento esplicito, usa valori da 1 a 4294967295. L’omissione o 0 seleziona un seed casuale. Se includi contentModeration, imposta il relativo publicFigureThreshold su auto o low; altrimenti ometti l’oggetto. Usa outputFormat per selezionare MP4, ProRes, sequenze PNG o uno dei formati HDR elencati nello schema della richiesta. Omettilo per H.264 MP4. Puoi impostare proresProfile solo quando outputFormat è prores o hdr_prores. Il formato HDR ProRes accetta 422, 422 HQ o 4444.

Recupera il risultato

Salva il valore id restituito e usa Ottieni un’attività Runway. Quando status è SUCCEEDED, leggi gli URL del video in output.

Autorizzazioni

Authorization
string
header
obbligatorio

Use your CometAPI API key.

Corpo

application/json

Request parameters for gen4.5.

model
enum<string>
obbligatorio

Model ID for this request variant.

Opzioni disponibili:
gen4.5
Allowed value: "gen4.5"
promptText
string
obbligatorio

Describe the requested scene or motion in 1 to 1,000 UTF-16 code units.

Required string length: 1 - 1000
ratio
enum<string>
obbligatorio

Requested output dimensions, expressed as width:height. Choose a value listed for this model and endpoint.

Opzioni disponibili:
1280:720,
720:1280
duration
integer
obbligatorio

Requested video duration in whole seconds, from 2 through 10.

Intervallo richiesto: 2 <= x <= 10
seed
integer

Optional sampling seed. Use a positive integer for an explicit seed. Omission or 0 selects a random seed.

Intervallo richiesto: 0 <= x <= 4294967295
contentModeration
object

Optional content moderation settings. Omit the object to use standard moderation.

outputFormat
enum<string>

Output encoding. Omit for mp4 (H.264). prores returns MOV; png_sequence returns a PNG ZIP; sdr_rec709_10bit returns 10-bit Rec.709 HEVC. hdr10 and hlg return 10-bit HDR MP4; hdr_pq_12bit_master returns 12-bit HEVC MOV; hdr_prores returns HDR ProRes MOV. The HDR PNG/EXR sequence formats return ZIP archives; the ACEScg variants target the named ACES version.

Opzioni disponibili:
mp4,
prores,
png_sequence,
hdr10,
hlg,
sdr_rec709_10bit,
hdr_pq_12bit_master,
hdr_prores,
hdr_png_sequence,
hdr_exr_sequence,
hdr_exr_acescg_sequence_1_3,
hdr_exr_acescg_sequence_2_0
proresProfile
enum<string>

Profile for outputFormat prores or hdr_prores. Omit for 4444 with prores, or 422 HQ with hdr_prores. hdr_prores accepts only 422, 422 HQ, or 4444. Omit this field for other formats.

Opzioni disponibili:
422,
4444,
422 Proxy,
422 LT,
422 HQ,
4444 XQ

Risposta

Task submitted. Save its id to retrieve task status.

id
string
obbligatorio

Task ID for GET /runwayml/v1/tasks/{id}.

status
string

Task state, when returned.

createdAt
string<date-time>

Task submission timestamp, when returned.

output
string<uri>[]

Result URLs, when returned.

failure
string

Failure explanation, when returned.

failureCode
string

Machine-readable failure code, when returned.

estimatedCost
object

Task estimate metadata, when returned.

cost
object

Task cost metadata, when returned.

Ultima modifica il 18 settembre 2026