v50

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

Model Router

Routed audio generation

Start an audio generation task using a saved Model Router config instead of naming a model. Set input.type to speech to speak promptText verbatim, or audio to generate audio described by promptText.

post/v1/generate/audio

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": {
    "voice": {
      "audioUri": "https://example.com/audio.mp3"
    },
    "referenceAudios": [
      {
        "uri": "https://example.com/audio.mp3"
      }
    ]
  }
}

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.