Skip to main content
POST
cURL
Usa questo endpoint per trasformare una clip sorgente esistente con il flusso di lavoro video-to-video di Runway. Avvia un’attività asincrona invece di restituire immediatamente l’output finale.

Prima di chiamarlo

  • Prepara un video sorgente che rispetti i requisiti di input del provider
  • Includi l’header X-Runway-Version richiesto per il set di funzionalità che desideri
  • Inizia con un prompt breve che descriva la modifica, non uno storyboard completo

Rapporto di output

Questo endpoint si aspetta valori ratio separati da due punti. Usa 1280:720 per output 1280x720 e 720:1280 per 720x1280; 1280x720 non è accettato in ogni route video-to-video di Runway.

Flusso dell’attività

1

Invia la clip sorgente e il prompt

Avvia l’attività da questo endpoint e salva il task id restituito.
2

Interroga i dettagli dell'attività

Usa Ottieni un’attività di Runway finché l’attività non raggiunge uno stato terminale.
3

Archivia il risultato trasformato

Scarica o conserva l’asset completato tramite la tua normale pipeline media.

Autorizzazioni

Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Intestazioni

X-Runway-Version
string
obbligatorio

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

Corpo

application/json
videoUri
string
predefinito:https://your-video-host/source.mp4
obbligatorio

HTTPS URL of the source video, or a base64 data URI containing the video.

promptText
string
predefinito:A cat yawning in slow motion.
obbligatorio

Text prompt describing the desired output. Maximum 1000 characters.

seed
integer
predefinito:1
obbligatorio

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

model
string
predefinito:gen4_aleph
obbligatorio

Model variant to use.

references
object[]
obbligatorio

Optional reference images to guide generation. Each item must include type (e.g. image) and uri (HTTPS URL).

ratio
string
predefinito:1280:720
obbligatorio

Requested output frame shape. Use colon-separated values such as 1280:720 or 720:1280; read them as 1280x720 and 720x1280 targets. Do not assume every Runway video-to-video route accepts 1280x720 with an x separator.

contentModeration
object
obbligatorio

Risposta

200 - application/json

success

id
string
obbligatorio

The ID of the task that was created. Use this to retrieve the task later.