Da immagine a video

Usa CometAPI per chiamare image_to_video di Runway e convertire l’URL di un’immagine statica in output video raw, con supporto X-Runway-Version per la compatibilità.

POST /runwayml/v1/image_to_video

Create a Runway image-to-video task

cURL

curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/image_to_video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "promptImage": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
  "model": "gen3a_turbo"
}
'

200

{
  "id": "3d957031-9a2a-45e2-9dc7-bc8513059c50"
}

Usa questo endpoint per animare un’immagine sorgente in un video Runway.

​

Prima di chiamarlo

• Invia l’header X-Runway-Version richiesto, ad esempio 2024-11-06
• Usa model: gen3a_turbo
• Fornisci un promptImage HTTPS stabile
• Inizia con duration: 5 e un rapporto comune come 1280:720

​

Flusso dell’attività

1. Invia la richiesta image-to-video

   Crea l’attività con un’immagine sorgente e un breve Prompt di movimento facoltativo.

2. Memorizza l'id restituito

   Salva l’id dell’attività per interrogarlo in seguito.

3. Controlla lo stato dell'attività

   Usa Get Task Details. Se il primo controllo restituisce task_not_exist, attendi qualche secondo e riprova.

La validazione live del 2026-03-13 ha confermato che una richiesta minima gen3a_turbo è stata accettata e ha restituito un id. Dopo un breve ritardo, sia i dettagli ufficiali dell’attività sia il feed reverse hanno restituito lo stesso stato queued incapsulato per quell’attività.

Autorizzazioni

Authorization · string · header · obbligatorio

Bearer token authentication. Use your CometAPI key.

Intestazioni

X-Runway-Version · string · obbligatorio

Runway version header, for example 2024-11-06.

Corpo

application/json

promptImage · string · predefinito: https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg · obbligatorio

Source image URL.

model · string · predefinito: gen3a_turbo · obbligatorio

Runway image-to-video model ID. Choose a current model from the Models page.

seed · integer

Random seed for reproducible results. Range: 0–999999999.

promptText · string

Text prompt describing the desired motion or scene. Maximum 512 characters.

watermark · boolean · predefinito: false

Whether to add a watermark to the output video.

duration · integer · predefinito: 5

Video duration in seconds. Accepted values: 5 or 10.

ratio · enum<string> · predefinito: 1280:720

Aspect ratio of the output video.

Opzioni disponibili: 1280:720, 720:1280, 1104:832, 832:1104, 960:960, 1584:672, 1280:768, 768:1280

Risposta

200 - application/json

Task accepted.

id · string · obbligatorio