Crea un task Runway da immagine a video

POST

runwayml

image_to_video

curl "https://api.cometapi.com/runwayml/v1/image_to_video" \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "gen4.5",
  "promptImage": "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg",
  "promptText": "The cat turns toward the camera.",
  "ratio": "1280:720",
  "duration": 5
}'

{
  "id": "00000000-0000-4000-8000-000000000001"
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Usa questo endpoint per animare un’immagine di origine. Invia la tua chiave API CometAPI con autenticazione Bearer e un corpo della richiesta JSON.

Scegli un modello

Modello	Campi obbligatori	Prompt di movimento
`gen4.5`	`model`, `promptImage`, `promptText`, `ratio`, `duration`	Descrivi il movimento in `promptText`.
`gen4_turbo`	`model`, `promptImage`, `ratio`	Facoltativamente, descrivi il movimento in `promptText`, usando da 1 a 1.000 unità di codice UTF-16.

Per una richiesta solo testuale, usa Crea un task Runway da testo a video.

Fornisci il primo frame

Imposta promptImage su un URL HTTPS di un’immagine accessibile o su un URI di dati immagine Base64. Puoi anche fornire un array con un solo elemento contenente uri e position: "first". Questa interfaccia accetta un frame iniziale; non aggiungere una voce per il frame finale. Le immagini HTTPS devono essere direttamente accessibili senza reindirizzamenti e avere intestazioni di contenuto immagine valide. Gli URI di dati immagine codificati possono avere dimensioni fino a 5 MB. Consulta i requisiti di input dei contenuti multimediali Runway per i formati e le dimensioni delle immagini.

Imposta durata e dimensioni

Usa un valore intero duration da 2 a 10 secondi. È obbligatorio per gen4.5 e facoltativo per gen4_turbo. Imposta ratio su 1280:720, 720:1280, 1104:832, 960:960, 832:1104 oppure 1584:672. Si tratta di valori di larghezza e altezza separati da due punti. Per un seed di campionamento esplicito, usa 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.

Scegli un formato di output

gen4.5 accetta outputFormat per MP4, ProRes, sequenze PNG e i formati HDR elencati nello schema della richiesta. Ometti il campo per H.264 MP4. proresProfile si applica solo a prores e hdr_prores; i relativi valori consentiti dipendono dal formato selezionato. Ometti entrambi i campi con gen4_turbo.

Recupera il risultato

Salva il valore id restituito e usa Recupera un task Runway. Quando status è SUCCEEDED, leggi gli URL dei risultati in output.

Autorizzazioni

Authorization

string

header

obbligatorio

Use your CometAPI API key.

Corpo

application/json

gen4.5
gen4_turbo

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

promptImage

obbligatorio

Image to use as the first frame. Supply a media URI or a one-item array with position set to first.

Maximum string length: 2048

Pattern: ^https://

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,

1104:832,

960:960,

832:1104,

1584:672

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.

Show child attributes

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.

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.

Show child attributes

cost

object

Task cost metadata, when returned.

Show child attributes

Ultima modifica il 18 settembre 2026

curl "https://api.cometapi.com/runwayml/v1/image_to_video" \
  --request POST \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "gen4.5",
  "promptImage": "https://upload.wikimedia.org/wikipedia/commons/3/3a/Cat03.jpg",
  "promptText": "The cat turns toward the camera.",
  "ratio": "1280:720",
  "duration": 5
}'

{
  "id": "00000000-0000-4000-8000-000000000001"
}

{
  "code": "<string>",
  "message": "<string>",
  "data": "<unknown>"
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>"
  }
}

Moderazione dei contenuti

Chiavi API

Crea un task Runway da immagine a video

Scegli un modello

Fornisci il primo frame

Imposta durata e dimensioni

Scegli un formato di output

Recupera il risultato

Autorizzazioni

Corpo

Risposta

​Scegli un modello

​Fornisci il primo frame

​Imposta durata e dimensioni

​Scegli un formato di output

​Recupera il risultato

Autorizzazioni

Corpo

Risposta

Scegli un modello

Fornisci il primo frame

Imposta durata e dimensioni

Scegli un formato di output

Recupera il risultato