Générer une vidéo à partir d’une vidéo

Utilisez CometAPI Runway POST /runwayml/v1/video_to_video pour démarrer des tâches de génération vidéo-à-vidéo, définir X-Runway-Version et transformer des clips source.

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

{}

Utilisez ce endpoint pour transformer un clip source existant avec le workflow vidéo-à-vidéo de Runway. Il lance une tâche asynchrone au lieu de renvoyer immédiatement le résultat final.

​

Avant de l’appeler

• Préparez une vidéo source conforme aux exigences d’entrée du fournisseur
• Incluez l’en-tête X-Runway-Version requis pour l’ensemble de fonctionnalités souhaité
• Commencez par un prompt court décrivant la modification, pas un storyboard complet

​

Flux de tâche

1. Soumettre le clip source et le prompt

   Démarrez la tâche depuis ce endpoint et enregistrez l’id de tâche renvoyé.

2. Interroger les détails de la tâche

   Utilisez Runway to Get Task Details jusqu’à ce que la tâche atteigne un état terminal.

3. Stocker le résultat transformé

   Téléchargez ou conservez la ressource finale via votre pipeline média habituel.

​

Remarque sur le wrapper CometAPI

CometAPI conserve le modèle de tâche asynchrone de Runway et le comportement des requêtes versionnées, tout en unifiant l’authentification et la gestion de l’URL de base avec le reste de la plateforme.

Autorisations

Authorization · string · header · requis

Bearer token authentication. Use your CometAPI key.

En-têtes

X-Runway-Version · string · requis

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

Corps

application/json

videoUri · string · défaut: https://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.mp4 · requis

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

promptText · string · défaut: A cat yawning in slow motion. · requis

Text prompt describing the desired output. Maximum 1000 characters.

seed · integer · défaut: 1 · requis

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

model · string · défaut: gen4_aleph · requis

Model variant to use.

references · object[] · requis

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

Show child attributes

ratio · string · défaut: 1280:720 · requis

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

contentModeration · object · requis

Show child attributes

Réponse

200 - application/json

success

The response is of type object.