Model Router

Routed video generation

Changed on

Start a video generation task using a saved Model Router config instead of naming a model.

post/v1/generate/video

Request

  • Base URL
    https://api.dev.runwayml.com
  • URL
    https://api.dev.runwayml.com/v1/generate/video
  • Auth
    HTTP bearer

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

configIdstring required

The slug of a saved Model Router config to route this request with.

Example request

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

Response

The routing decision. Includes a task id for real requests; dry runs return the decision only.

idstring uuid required

The ID of the created task. Poll GET /v1/tasks/:id for the result.

Changes