Model Router

Routed image generation

Changed on

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

post/v1/generate/image

Request

  • Base URL
    https://api.dev.runwayml.com
  • URL
    https://api.dev.runwayml.com/v1/generate/image
  • 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"
      }
    ]
  }
}

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

  • 48c998a7f98fRevision changes
    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

  • 03955b3cb80cRevision changes
    • breaking

      the response property /// became optional for the status

    • breaking

      the response property /// became optional for the status