API Documentation

The Runway API allows you to bring our most powerful and popular generative models directly into your apps, products, platforms and websites. Get started today.

Models

View available models and details here.

Start Building

Using the API Create your first generation with Runway's API

API Reference Read about how to interact with the API

Go-live checklist Prepare your integration for launch

Runway Agent Skills Community tools, examples, and agent skills for the Runway API

Quickstart

Get started by following our API guide or jump right into the example of using the Gen-4.5 model below:

Node
Python

import RunwayML, { TaskFailedError } from '@runwayml/sdk';

const client = new RunwayML();

try {
  // Create a new text-to-video task using the "gen4.5" model
  const task = await client.imageToVideo
    .create({
      model: 'gen4.5',
      promptText: 'A serene mountain landscape at sunrise with mist rolling through the valleys',
      ratio: '1280:720',
      duration: 5,
    })
    .waitForTaskOutput();

  console.log('Task complete:', task);
  console.log('Video URL:', task.output[0]);
} catch (error) {
  if (error instanceof TaskFailedError) {
    console.error('The video failed to generate.');
    console.error(error.taskDetails);
  } else {
    console.error(error);
  }
}

from runwayml import RunwayML, TaskFailedError

client = RunwayML()

try:
  task = client.image_to_video.create(
    model='gen4.5',
    prompt_text='A serene mountain landscape at sunrise with mist rolling through the valleys',
    ratio='1280:720',
    duration=5,
  ).wait_for_task_output()

  print('Task complete:', task)
  print('Video URL:', task.output[0])
except TaskFailedError as e:
  print('The video failed to generate.')
  print(e.task_details)

Enterprise Scale

The Runway API has been used by the world’s largest consumer technology companies to reliably generate millions of videos for their users.

To request higher usage than the self-serve tiers, you can submit an exception request on the usage page of your developer portal.

Enterprise Benefits

In addition to higher rate limits, enterprise customers receive:

Faster support via Slack (or email) channels
Earliest access to new features
Direct access to provide product feedback and request features
Implementation and usage tips
Custom payment terms