---
title: API Documentation
description: Access complete Runway API documentation. Find guides, references and resources to integrate AI video generation into your applications and products.
---

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](https://dev.runwayml.com/).

<div class="announcement-banner">
  <span class="announcement-text">
    <strong>New:</strong> Aleph 2.0 is now available. Edit existing videos with
    text prompts and keyframe images.
  </span>
  <a href="/api#tag/Start-generating/paths/~1v1~1video_to_video/post">Get started with Aleph 2.0 →</a>
</div>

# Models

<div class="welcome-cards-container">
  <div class="welcome-card">
    <a href="/guides/models">
      <img
        src="https://d3phaj0sisr2ct.cloudfront.net/devportal/models-v2/seedance-2.jpeg"
        alt="Seedance 2.0"
      />
    </a>
  </div>
  <div class="welcome-card">
    <a href="/api#tag/Start-generating/paths/~1v1~1image_to_video/post">
      <img
        src="https://d3phaj0sisr2ct.cloudfront.net/devportal/models-v2/gen4.5.jpeg"
        alt="Gen 4.5"
      />
    </a>
  </div>
  <div class="welcome-card">
    <a href="/api/#tag/Start-generating/paths/~1v1~1video_to_video/post">
      <img
        src="https://d3phaj0sisr2ct.cloudfront.net/devportal/models-v2/aleph-2.0-v2.jpeg"
        alt="Aleph 2.0"
      />
    </a>
  </div>
  <div class="welcome-card">
    <a href="/api#tag/Start-generating/paths/~1v1~1text_to_image/post">
      <img
        src="https://d3phaj0sisr2ct.cloudfront.net/devportal/models-v2/gpt-image-2.jpg"
        alt="GPT Image 2"
      />
    </a>
  </div>
</div>

View available models and details [here](guides/models).

# Start Building

<CardGrid>
  <LinkCard
    title="Using the API"
    href="/guides/using-the-api"
    description="Create your first generation with Runway's API"
  />
  <LinkCard
    title="API Reference"
    href="/api"
    description="Read about how to interact with the API"
  />
  <LinkCard
    title="Go-live checklist"
    href="/guides/go-live"
    description="Prepare your integration for launch"
  />
  <LinkCard
    title="Runway Agent Skills"
    href="https://github.com/runwayml/skills"
    description="Community tools, examples, and agent skills for the Runway API"
  />
</CardGrid>

# Quickstart

Get started by following our [API guide](/guides/using-the-api) or jump right into the example of using the Gen-4.5 model below:

<Tabs>
  <TabItem label="Node">
    <Code code={codeSample`
    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);
  }
}
`.trim()} lang="ts" />
```

  </TabItem>
  <TabItem label="Python">
    <Code code={codeSample`
    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)
`.trim()} lang="python" />
```

  </TabItem>
</Tabs>

# 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](./usage/tiers#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