v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01600974.4 KB
Model Router

Routed image generation

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

post/v1/generate/image

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"
      }
    ]
  }
}

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.