Passer au contenu principal
POST
/
runwayml
/
v1
/
video_to_video
Generate a video from a video
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://media.w3.org/2010/05/sintel/trailer.mp4",
  "promptText": "Make the motion feel cinematic.",
  "model": "gen4_aleph",
  "references": [
    {
      "type": "image",
      "uri": "https://res.cloudinary.com/demo/image/upload/dog.jpg"
    }
  ],
  "ratio": "1280:720"
}
'
{
  "id": "12a01a5e-ab55-4aa7-b002-7b873546cf76"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Utilisez ce endpoint pour transformer un clip source existant avec le workflow vidéo-vers-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 qui décrit la modification, et non un storyboard complet

​
Flux de la 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 pour obtenir les détails de la tâche jusqu’à ce que la tâche atteigne un état terminal.
3

Stocker le résultat transformé

Téléchargez ou conservez l’asset finalisé via votre pipeline média habituel.

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).

​
ratio
string
défaut:1280:720
requis

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

​
contentModeration
object
requis

Réponse

200 - application/json

success

​
id
string
requis

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