First-party app
Runway

Runway

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.

stable AI & Machine LearningVideo & Streaming

About

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.

App id
io.w6w.runway
Version
0.1.0
Author
w6w
Licence
MIT
Categories
AI & Machine Learning · Video & Streaming

Overview

Runway 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.

Build with Runway

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 or Delete Task

cancel-task

Cancel a pending, throttled or running task; for a finished task, delete it and its output.

Character Performance

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-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 (Model Router)

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 Avatar

get-avatar

Read one avatar: personality, voice, knowledge documents and status.

Get Organization

get-organization

Read the credit balance, usage tier and per-model usage of the organization that owns the API key. Free.

Get Model Router

get-router

Read one Model Router configuration.

Get Task

get-task

Read a generation task: status, progress, cost and, once SUCCEEDED, the temporary output URLs. Poll no more often than every five seconds.

Query Credit Usage

get-usage

Credit usage per model and day for the API key's organization (up to 90 days).

Get Custom Voice

get-voice

Read one custom voice: status, description and preview URL.

Get Workflow

get-workflow

Read a published workflow version, including its node graph.

Get Workflow Invocation

get-workflow-invocation

Read a workflow run: status, output and per-node errors. A SUCCEEDED run can still carry node errors.

Image to Video

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.

Upscale Image

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-avatars

List the Characters avatars: personality, voice, reference image and status.

List Model Routers

list-routers

List saved Model Router configurations: slug, optimization preference and model rules.

List Custom Voices

list-voices

List the organization's custom voices, with status and preview URL.

List Workflows

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-workflow

Run a published workflow version. Returns an invocation id; read it with Get Workflow Invocation. Spends credits.

Generate Sound Effect

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

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

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

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

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

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

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.

Upscale Video

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

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

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

Here are some of the things you can do

  • Character Performance

    perform
    character-performance
  • Create Upload

    perform
    create-upload
  • Generate Video (Model Router)

    perform
    generate-video
  • Get Avatar

    read
    get-avatar
  • Get Organization

    read
    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.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { 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);
Install the CLI
npm install -g @w6w/cli
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.

What the agent gets

Credentials it can't read

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.

A tool surface scoped to the caller

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.

A durable workflow in one call

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.

Health-aware discovery

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).

Request MCP access

Health checks

Runway declares its own checks, so its health is a property of the app rather than something the host guesses at.

service

Runway Public API status

The "Public API" component of status.runwayml.com decides; the other components are shown as detail.

dependency

API reachable

Unauthenticated GET /v1/organization. Runway's JSON `error` envelope on a 401 passes: it proves the application is answering.

quota

Credit headroom

Credit balance vs the usage tier's monthly spend ceiling, from GET /v1/organization.