Generate video, images, speech and sound with Runway: start generation tasks, poll them to completion, run saved workflows and model routers, and read credits and usage.
Runway ships in the w6w first-party pack. It declares 29 actions, 3 health checks, and the host runs its code in a sandbox that never sees the credential.
io.w6w.runwayRunway is a generative media platform. Its developer API starts video, image, audio and speech generations on Runway’s own and partner models and returns a task id that is polled to completion.
A workflow can start a text-to-video, image-to-video or video-to-video generation, make an image from a prompt and reference images, upscale an image or video, convert a video to HDR, drive a character with a reference performance, speak a script, convert, dub or isolate a voice, or generate a sound effect. Every generation returns a task id; Get Task reads its status, progress, cost and (once it has SUCCEEDED) the temporary output URLs, and Cancel Task stops or deletes it. A saved Model Router can pick the model for a video generation instead of naming one, a published Runway workflow can be run and its invocation read back, and the account’s credit balance, usage tier and per-model credit usage are readable for free. Avatars, custom voices and routers can be listed and read.
The connection holds a Runway API secret (Developer Portal, key_…), sent as a bearer token. Generation spends credits; request fields differ per model, so each generation action takes the model id plus the commonly used fields and an extra JSON object for any model-specific field.
Three routes to the same 29 actions. The Workflow tab is generated from Runway's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.
cancel-task Cancel a pending, throttled or running task; for a finished task, delete it and its output.
character-performance Animate a character image or video with the performance in a reference video. Asynchronous: returns a task id; read the result with Get Task. Spends credits.
create-upload Create an ephemeral upload slot. Returns the presigned upload form and the runway:// URI to use as media input once the file has been POSTed to it.
generate-video Start a video generation through a saved Model Router instead of naming a model. With Dry run, only previews which model would run and what it would cost.
get-organization Read the credit balance, usage tier and per-model usage of the organization that owns the API key. Free.
get-task Read a generation task: status, progress, cost and, once SUCCEEDED, the temporary output URLs. Poll no more often than every five seconds.
get-usage Credit usage per model and day for the API key's organization (up to 90 days).
get-workflow-invocation Read a workflow run: status, output and per-node errors. A SUCCEEDED run can still carry node errors.
image-to-video Start a video generation that animates a first frame (or keyframes). Asynchronous: returns a task id; read the result with Get Task. Spends credits.
image-upscale Start an image upscale (Magnific precision upscaler). Asynchronous: returns a task id; read the result with Get Task. Spends credits.
list-avatars List the Characters avatars: personality, voice, reference image and status.
list-routers List saved Model Router configurations: slug, optimization preference and model rules.
list-workflows List the published Runway workflows, each with its published versions (newest first). The version `id` is what Run Workflow takes.
run-workflow Run a published workflow version. Returns an invocation id; read it with Get Workflow Invocation. Spends credits.
sound-effect Start a sound effect generation from a text description. Asynchronous: returns a task id; read the result with Get Task. Spends credits.
speech-to-speech Re-voice the dialogue in an audio or video file with a preset voice. Asynchronous: returns a task id; read the result with Get Task. Spends credits.
text-to-image Start an image generation from a prompt and optional reference images. Asynchronous: returns a task id; read the result with Get Task. Spends credits.
text-to-speech Start a speech generation from a script. Asynchronous: returns a task id; read the result with Get Task. Spends credits.
text-to-video Start a video generation from a text prompt. Asynchronous: returns a task id; read the result with Get Task. Spends credits.
video-to-hdr Start an SDR to HDR conversion of a video. Asynchronous: returns a task id; read the result with Get Task. Spends credits.
video-to-video Start a generation that transforms or extends an input video. Asynchronous: returns a task id; read the result with Get Task. Spends credits.
video-upscale Start a video upscale or frame-rate enhancement. Asynchronous: returns a task id; read the result with Get Task. Spends credits.
voice-dubbing Dub the speech in an audio file into another language. Asynchronous: returns a task id; read the result with Get Task. Spends credits.
voice-isolation Isolate the voice in an audio file from background sound. Asynchronous: returns a task id; read the result with Get Task. Spends credits.
A workflow step names the app and the action, and the editor fills in the
connection when you pick one. This is the Step shape from the
workflow spec, carrying Runway's real ids.
{
"manifestVersion": "2",
"name": "runway-example",
"steps": [
{
"id": "character-performance",
"uses": {
"app": "io.w6w.runway",
"action": "character-performance",
"connection": "conn_YOUR_CONNECTION_ID"
},
"with": {
"model": "<model>",
"characterType": "<characterType>",
"characterUri": "<characterUri>"
}
}
]
}character-performance create-upload generate-video get-avatar get-organization +24 more actions available
Every app-specific value here is a blank you have to fill in. An
app action is reached through the connection that authenticates it, so the
address is a connection id, not the app id — and connections belong to your account,
so a public page cannot know yours. Create one for Runway, then fill in
the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the
parameters that action declares. The call itself is real — the shape is transcribed
from the studio's own snippet builder, which prints the same kind of blanks — but
nothing in it is specific to Runway. The Workflow tab is where this app's
real ids are.
npm install @w6w/sdkyarn add @w6w/sdkpnpm add @w6w/sdkdeno add npm:@w6w/sdkimport { W6wClient, isActionRun } from "@w6w/sdk";
// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();
const envelope = await client.run({
urn: "conn_YOUR_CONNECTION_ID",
action: "character-performance",
payload: {
model: "<value>",
characterType: "<value>",
characterUri: "<value>",
referenceUri: "<value>",
// bodyControl: "<value>",
// expressionIntensity: "<value>",
// ratio: "<value>",
// seed: "<value>",
// publicFigureThreshold: "<value>",
// extra: "<value>",
},
});
if (isActionRun(envelope)) console.log(envelope.value); npm install -g @w6w/cli w6w run conn_YOUR_CONNECTION_ID --action character-performance --payload '{"model":"<value>","characterType":"<value>","characterUri":"<value>","referenceUri":"<value>"}' Give an AI agent Runway — without giving it Runway's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.
One tool call{
"name": "w6w_invoke",
"arguments": {
"ref": "app:io.w6w.runway#character-performance",
"input": {
"model": "<model>",
"characterType": "<characterType>",
"characterUri": "<characterUri>"
}
}
}
Every tool names its target with a single ref. The
app: form above doesn't name a connection at all — the
host resolves which of the caller's Runway connections to sign
with, and refuses rather than guesses when the answer is ambiguous.
The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.
Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.
Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.
Runway's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.
The MCP surface is part of the hosted platform. Runway itself is MIT, and the runtime that executes it is source-available (FSL).
Runway declares its own checks, so its health is a property of the app rather than something the host guesses at.
The "Public API" component of status.runwayml.com decides; the other components are shown as detail.
Unauthenticated GET /v1/organization. Runway's JSON `error` envelope on a 401 passes: it proves the application is answering.
Credit balance vs the usage tier's monthly spend ceiling, from GET /v1/organization.