Generare un video a partire da un video

Usa CometAPI Runway POST /runwayml/v1/video_to_video per avviare attività di generazione video-to-video, impostare X-Runway-Version e trasformare clip sorgente.

POST /runwayml/v1/video_to_video

Generate a video from a video

cURL

curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/video_to_video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "videoUri": "https://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.mp4",
  "promptText": "string",
  "seed": 4294967295,
  "model": "gen4_aleph",
  "references": [
    {
      "type": "image",
      "uri": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg"
    }
  ],
  "ratio": "1280:720",
  "contentModeration": {
    "publicFigureThreshold": "auto"
  }
}
'

200

{}

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 soddisfi i requisiti di input del provider
• Includi l’header X-Runway-Version richiesto per il set di funzionalità desiderato
• Inizia con un prompt breve che descriva la modifica, non con uno storyboard completo

​

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 Runway per ottenere i dettagli dell’attività 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.

​

Nota sul wrapper CometAPI

CometAPI mantiene il modello di attività asincrone di Runway e il comportamento delle richieste versionate, ma unifica l’autenticazione e la gestione della base URL con il resto della piattaforma.

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://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.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).

Show child attributes

ratio · string · predefinito: 1280:720 · obbligatorio

Aspect ratio of the output video, e.g. 1280:720.

contentModeration · object · obbligatorio

Show child attributes

Risposta

200 - application/json

success

The response is of type object.