Skip to main content
POST
cURL
Gebruik dit endpoint om een bestaande bronclip te transformeren met Runway’s video-to-video-workflow. Het start een asynchrone taak in plaats van direct de uiteindelijke output terug te geven.

Voordat je het aanroept

  • Bereid een bronvideo voor die voldoet aan de invoervereisten van de provider
  • Voeg de vereiste X-Runway-Version-header toe voor de functieset die je wilt
  • Begin met één korte prompt die de wijziging beschrijft, niet een volledig storyboard

Uitvoer-verhouding

Dit endpoint verwacht dubbelepunt-gescheiden ratio-waarden. Gebruik 1280:720 voor 1280x720-output en 720:1280 voor 720x1280; 1280x720 wordt niet geaccepteerd op elke Runway video-to-video-route.

Taakverloop

1

Dien de bronclip en prompt in

Start de taak vanuit dit endpoint en sla de geretourneerde taak-id op.
2

Poll taakdetails

Gebruik Een Runway-taak ophalen totdat de taak een eindstatus bereikt.
3

Sla het getransformeerde resultaat op

Download of bewaar het voltooide asset via je normale mediapijplijn.

Autorisaties

Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Headers

X-Runway-Version
string
vereist

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

Body

application/json
videoUri
string
standaard:https://your-video-host/source.mp4
vereist

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

promptText
string
standaard:A cat yawning in slow motion.
vereist

Text prompt describing the desired output. Maximum 1000 characters.

seed
integer
standaard:1
vereist

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

model
string
standaard:gen4_aleph
vereist

Model variant to use.

references
object[]
vereist

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

ratio
string
standaard:1280:720
vereist

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
vereist

Respons

200 - application/json

success

id
string
vereist

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