v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01600974.4 KB
Start generating

Text to video

This endpoint will start a new task to generate a video from a text prompt.

post/v1/text_to_video

Headers

X-Runway-Version'2024-11-06' required

The version of the RunwayML API being used. You can read more about versioning here.

Request body

OR
OR
OR
OR
OR
OR
OR
OR

Example request

{
  "references": [
    {
      "uri": "https://example.com/image.jpg"
    }
  ],
  "referenceVideos": [
    {
      "uri": "https://example.com/video.mp4"
    }
  ],
  "referenceAudio": [
    {
      "uri": "https://example.com/audio.mp3"
    }
  ]
}

Response

The task that was created.

idstring uuid required

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