Skip to main content
POST
cURL
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 qui correspond 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 le changement, et non un storyboard complet

Ratio de sortie

Ce endpoint attend des valeurs ratio séparées par des deux-points. Utilisez 1280:720 pour une sortie 1280x720 et 720:1280 pour 720x1280 ; 1280x720 n’est pas accepté sur toutes les routes Runway de vidéo vers vidéo.

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 Obtenir une tâche Runway 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://your-video-host/source.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

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