---
title: Runway Gen-4.5 | Runware Docs
url: https://runware.ai/docs/models/runway-gen-4-5
description: Advanced multimodal video generation with text and image input
---
# Runway Gen-4.5

Runway Gen-4.5 is an AI video generation model that creates short video clips from text prompts or static images with high visual fidelity and smooth motion. It supports both text-to-video and image-to-video generation with a range of aspect ratios and clip durations. Gen-4.5 emphasizes realistic motion, strong prompt adherence, and controllable composition, making it suitable for cinematic sequences and creative video workflows.

- **ID**: `runway:1@2`
- **Status**: live
- **Creator**: Runway
- **Release Date**: December 1, 2025
- **Capabilities**: Text to Video, Image to Video

## Pricing

- **720p · 5s**: `$0.6`

## Compatibility & Validation

Either provide `inputs.frameImages`, or specify `positivePrompt`.

---

`width` and `height` must be used together.

---

The following dimension combinations are supported:

| Configuration | Dimensions |
| --- | --- |
| `720p (16:9)` | `1280x720` |
| `720p (9:16)` | `720x1280` |
| `720p (4:3)` | `1104x832` |
| `720p (3:4)` | `832x1104` |
| `720p (1:1)` | `960x960` |

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/runway-gen-4-5#request-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `videoInference`

Identifier for the type of task being performed

### [taskUUID](https://runware.ai/docs/models/runway-gen-4-5#request-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

### [outputType](https://runware.ai/docs/models/runway-gen-4-5#request-outputtype)

- **Type**: `string`
- **Default**: `URL`

Video output type.

**Allowed values**: `URL`

### [outputFormat](https://runware.ai/docs/models/runway-gen-4-5#request-outputformat)

- **Type**: `string`
- **Default**: `MP4`

Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.

- \`MP4\`: Widely supported video container (H.264), recommended for general use.
- \`WEBM\`: Optimized for web delivery.
- \`MOV\`: QuickTime format, common in professional workflows (Apple ecosystem).

**Allowed values**: `MP4` `WEBM` `MOV`

### [outputQuality](https://runware.ai/docs/models/runway-gen-4-5#request-outputquality)

- **Type**: `integer`
- **Min**: `20`
- **Max**: `99`
- **Default**: `95`

Compression quality of the output. Higher values preserve quality but increase file size.

### [webhookURL](https://runware.ai/docs/models/runway-gen-4-5#request-webhookurl)

- **Type**: `string`
- **Format**: `URI`

Specifies a webhook URL where JSON responses will be sent via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.

**Learn more** (1 resource):

- [Webhooks](https://runware.ai/docs/platform/webhooks) (platform)

### [deliveryMethod](https://runware.ai/docs/models/runway-gen-4-5#request-deliverymethod)

- **Type**: `string`
- **Default**: `async`

Determines how the API delivers task results.

**Allowed values**:

- `async` Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse. Required for long-running tasks like video generation.

**Learn more** (1 resource):

- [Task Polling](https://runware.ai/docs/platform/task-polling) (platform)

### [uploadEndpoint](https://runware.ai/docs/models/runway-gen-4-5#request-uploadendpoint)

- **Type**: `string`
- **Format**: `URI`

Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.

**Common use cases:**

- **Cloud storage**: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- **CDN integration**: Upload to content delivery networks for immediate distribution.

```text
// S3 presigned URL for secure upload
https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600

// Google Cloud Storage presigned URL
https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789

// Custom storage endpoint
https://storage.example.com/uploads/generated-image.jpg
```

The content data will be sent as the request body to the specified URL when generation is complete.

### [safety](https://runware.ai/docs/models/runway-gen-4-5#request-safety)

- **Path**: `safety.checkContent`
- **Type**: `object (2 properties)`

Content safety checking configuration for video generation.

#### [checkContent](https://runware.ai/docs/models/runway-gen-4-5#request-safety-checkcontent)

- **Path**: `safety.checkContent`
- **Type**: `boolean`
- **Default**: `false`

Enable or disable content safety checking. When enabled, defaults to `fast` mode.

#### [mode](https://runware.ai/docs/models/runway-gen-4-5#request-safety-mode)

- **Path**: `safety.mode`
- **Type**: `string`
- **Default**: `none`

Safety checking mode for video generation.

**Allowed values**:

- `none` Disables checking.
- `fast` Checks key frames.
- `full` Checks all frames.

### [ttl](https://runware.ai/docs/models/runway-gen-4-5#request-ttl)

- **Type**: `integer`
- **Min**: `60`

Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.

### [includeCost](https://runware.ai/docs/models/runway-gen-4-5#request-includecost)

- **Type**: `boolean`
- **Default**: `false`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/runway-gen-4-5#request-numberresults)

- **Type**: `integer`
- **Min**: `1`
- **Max**: `4`
- **Default**: `1`

Number of results to generate. Each result uses a different seed, producing variations of the same parameters.

**Inputs**

Input resources for the task (images, audio, etc). These must be nested inside the \`inputs\` object.

### [frameImages](https://runware.ai/docs/models/runway-gen-4-5#request-inputs-frameimages)

- **Path**: `inputs.frameImages`
- **Type**: `array of strings or objects`

An array of frame-specific image inputs to guide video generation. Each item can be either a plain image input (UUID, URL, Data URI, or Base64) or an object that pairs an image with a target frame position.

The `frameImages` parameter allows you to constrain specific frames within the video sequence, ensuring that particular visual content appears at designated points. This is different from `referenceImages`, which provide overall visual guidance without constraining specific timeline positions.

When the `frame` parameter is omitted, automatic distribution rules apply:

- **1 image**: Used as the first frame.

**Examples**:

**Shorthand format:** When you don't need to specify a frame position, you can pass a plain image input directly.

```json
"frameImages": [
  "aac49721-1964-481a-ae78-8a4e29b91402"
]
```

**Object format:** When you need to specify a frame position, use an object with `image` and `frame`.

```json
"frameImages": [
  {
    "image": "aac49721-1964-481a-ae78-8a4e29b91402",
    "frame": "first"
  }
]
```

**Format 1: string[]**:

- **Type**: `string`

Image input (UUID, URL, Data URI, or Base64).

**Format 2: object[]**:

#### [image](https://runware.ai/docs/models/runway-gen-4-5#request-inputs-frameimages-format-2-image)

- **Path**: `inputs.frameImages.image`
- **Type**: `string`
- **Required**: true

Image input (UUID, URL, Data URI, or Base64).

#### [frame](https://runware.ai/docs/models/runway-gen-4-5#request-inputs-frameimages-format-2-frame)

- **Path**: `inputs.frameImages.frame`
- **Type**: `object`

Target frame position for the image. This model only supports the first frame.

**Allowed values**:

- `first` First frame of the video.
- `0` Frame index 0 (first frame).

**Generation Parameters**

Core parameters for controlling the generated content.

### [model](https://runware.ai/docs/models/runway-gen-4-5#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `runway:1@2`

Identifier of the model to use for generation.

**Learn more** (3 resources):

- [Text To Image: Model Selection The Foundation Of Generation](https://runware.ai/docs/guides/text-to-image#model-selection-the-foundation-of-generation) (guide)
- [Image Inpainting: Model Specialized Inpainting Models](https://runware.ai/docs/guides/image-inpainting#model-specialized-inpainting-models) (guide)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/guides/image-outpainting#other-critical-parameters) (guide)

### [positivePrompt](https://runware.ai/docs/models/runway-gen-4-5#request-positiveprompt)

- **Type**: `string`
- **Required**: true
- **Min**: `1`
- **Max**: `1000`

Text prompt describing elements to include in the generated output.

**Learn more** (2 resources):

- [Text To Image: Prompts Guiding The Generation](https://runware.ai/docs/guides/text-to-image#prompts-guiding-the-generation) (guide)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/guides/image-outpainting#other-critical-parameters) (guide)

### [width](https://runware.ai/docs/models/runway-gen-4-5#request-width)

- **Type**: `integer`
- **Required**: true
- **Paired with**: height

Width of the generated media in pixels.

**Learn more** (2 resources):

- [Image To Image: Dimensions Changing Aspect Ratio](https://runware.ai/docs/guides/image-to-image#dimensions-changing-aspect-ratio) (guide)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/guides/image-outpainting#dimensions-critical-for-outpainting) (guide)

### [height](https://runware.ai/docs/models/runway-gen-4-5#request-height)

- **Type**: `integer`
- **Required**: true
- **Paired with**: width

Height of the generated media in pixels.

**Learn more** (2 resources):

- [Image To Image: Dimensions Changing Aspect Ratio](https://runware.ai/docs/guides/image-to-image#dimensions-changing-aspect-ratio) (guide)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/guides/image-outpainting#dimensions-critical-for-outpainting) (guide)

### [duration](https://runware.ai/docs/models/runway-gen-4-5#request-duration)

- **Type**: `float`
- **Default**: `10`

Length of the generated video in seconds. The total number of frames produced is determined by duration multiplied by the model's frame rate (fps).

**Allowed values**: `5` `8` `10`

### [seed](https://runware.ai/docs/models/runway-gen-4-5#request-seed)

- **Type**: `integer`
- **Min**: `0`
- **Max**: `4294967295`

Random seed for reproducible generation. When not provided, a random seed is generated in the unsigned 32-bit range.

**Provider Settings**

Parameters specific to this model provider. These must be nested inside the \`providerSettings.runway\` object.

### [contentModeration](https://runware.ai/docs/models/runway-gen-4-5#request-providersettings-runway-contentmoderation)

- **Path**: `providerSettings.runway.contentModeration`
- **Type**: `object (1 property)`

Content moderation settings.

#### [publicFigureThreshold](https://runware.ai/docs/models/runway-gen-4-5#request-providersettings-runway-contentmoderation-publicfigurethreshold)

- **Path**: `providerSettings.runway.contentModeration.publicFigureThreshold`
- **Type**: `string`
- **Default**: `auto`

Public figure filtering strictness.

**Allowed values**:

- `auto` Automatic filtering.
- `low` Less strict filtering.

## Response Parameters

### [taskType](https://runware.ai/docs/models/runway-gen-4-5#response-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `videoInference`

Type of the task.

### [taskUUID](https://runware.ai/docs/models/runway-gen-4-5#response-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the task.

### [videoUUID](https://runware.ai/docs/models/runway-gen-4-5#response-videouuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the output video.

### [videoURL](https://runware.ai/docs/models/runway-gen-4-5#response-videourl)

- **Type**: `string`
- **Format**: `URI`

URL of the output video.

### [videoBase64Data](https://runware.ai/docs/models/runway-gen-4-5#response-videobase64data)

- **Type**: `string`

Base64-encoded video data.

### [videoDataURI](https://runware.ai/docs/models/runway-gen-4-5#response-videodatauri)

- **Type**: `string`
- **Format**: `URI`

Data URI of the output video.

### [seed](https://runware.ai/docs/models/runway-gen-4-5#response-seed)

- **Type**: `integer`

The seed used for generation. If none was provided, shows the randomly generated seed.

### [NSFWContent](https://runware.ai/docs/models/runway-gen-4-5#response-nsfwcontent)

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

### [cost](https://runware.ai/docs/models/runway-gen-4-5#response-cost)

- **Type**: `float`

Task cost in USD. Present when `includeCost` is set to `true` in the request.

## Examples

### Bioluminescent Mangrove River Journey (Text to Video)

[Watch video](https://assets.runware.ai/examples/runway-gen-4-5/2779e2cd-14d8-4166-9e02-57b2d5e4357f.mp4)

**Request**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "fc8f53de-cc6f-4188-b718-c811a106fece",
  "model": "runway:1@2",
  "positivePrompt": "A slow cinematic glide down a narrow mangrove river at night, roots arching overhead like a natural cathedral, bioluminescent moss and tiny glowing insects illuminating the scene in teal, violet, and amber. A small weathered wooden boat drifts ahead with hanging lanterns, ripples spreading across black mirror-like water. Mist curls between the trees, distant luminous birds lift off from branches, and soft rain begins to fall, creating delicate concentric patterns on the surface. The camera moves smoothly forward with realistic parallax through dense foliage, rich atmospheric depth, highly detailed textures, natural water physics, moody magical realism, elegant color contrast, filmic lighting, ultra high visual fidelity.",
  "width": 1280,
  "height": 720,
  "duration": 8,
  "seed": 48281,
  "providerSettings": {
    "runway": {
      "contentModeration": {
        "publicFigureThreshold": "auto"
      }
    }
  }
}
```

**Response**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "fc8f53de-cc6f-4188-b718-c811a106fece",
  "videoUUID": "6dba7728-9f04-40bf-bb0e-8c36b9aec934",
  "videoURL": "https://vm.runware.ai/video/os/a17d13/ws/5/vi/6dba7728-9f04-40bf-bb0e-8c36b9aec934.mp4",
  "seed": 48281,
  "cost": 0.965
}
```

---

### Bioluminescent Mangrove Research Expedition (Text to Video)

[Watch video](https://assets.runware.ai/examples/runway-gen-4-5/5c8e60fa-b0c3-4c5f-af37-281ba956c11e.mp4)

**Request**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "01ea41c5-2561-43cd-90d3-b7ce085a72fc",
  "model": "runway:1@2",
  "positivePrompt": "A cinematic night expedition drifting through a bioluminescent mangrove forest on a narrow wooden research skiff. Two field scientists in subtle waterproof gear glide between arching roots while electric-blue plankton ripple in the dark water with every movement of the boat. Firefly-like insects hover among glossy leaves, soft mist hangs low above the surface, and distant storm clouds flicker on the horizon. The camera begins close to the glowing wake beside the boat, then slowly tracks forward and slightly upward to reveal the dense maze of roots, reflective water, and luminous wildlife. Realistic water physics, gentle paddling motion, intricate foliage detail, believable cloth movement, moody natural lighting, high visual fidelity, atmospheric depth, serene wonder, cinematic documentary style.",
  "width": 1280,
  "height": 720,
  "duration": 8,
  "seed": 97986,
  "providerSettings": {
    "runway": {
      "contentModeration": {
        "publicFigureThreshold": "auto"
      }
    }
  }
}
```

**Response**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "01ea41c5-2561-43cd-90d3-b7ce085a72fc",
  "videoUUID": "53a9d1d6-079d-40ae-a547-da2c29c3d744",
  "videoURL": "https://vm.runware.ai/video/os/a15d18/ws/5/vi/53a9d1d6-079d-40ae-a547-da2c29c3d744.mp4",
  "seed": 97986,
  "cost": 0.965
}
```

---

### Bioluminescent Jungle Temple Dawn (Image to Video)

[Watch video](https://assets.runware.ai/examples/runway-gen-4-5/8730103f-16d5-4677-89c2-356b453f2cef.mp4)

**Request**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "17eef945-22c7-4160-b2ae-cddb468f0953",
  "model": "runway:1@2",
  "positivePrompt": "Animate this first-frame scene into a lush cinematic sequence: the camera slowly pushes forward toward the ancient jungle temple as morning mist curls across the ground, bioluminescent flowers pulse softly in blue and violet, dew glistens on leaves, hanging vines sway gently, tiny glowing insects drift through the air, reflections ripple subtly in the foreground pool, and warm dawn light strengthens through the canopy with realistic volumetric rays. Preserve the temple composition from the frame image, maintain high realism, smooth natural motion, rich texture detail, and an awe-filled mystical mood.",
  "width": 1280,
  "height": 720,
  "duration": 8,
  "seed": 1554,
  "providerSettings": {
    "runway": {
      "contentModeration": {
        "publicFigureThreshold": "auto"
      }
    }
  },
  "inputs": {
    "frameImages": [
      {
        "image": "https://assets.runware.ai/assets/inputs/5c6cc9ed-a385-4fed-8e7b-e90fc31b080c.jpg",
        "frame": "first"
      }
    ]
  }
}
```

**Response**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "17eef945-22c7-4160-b2ae-cddb468f0953",
  "videoUUID": "12705e23-36d1-49f1-bac3-a04c4dc6f06d",
  "videoURL": "https://vm.runware.ai/video/os/a03d21/ws/5/vi/12705e23-36d1-49f1-bac3-a04c4dc6f06d.mp4",
  "seed": 1554,
  "cost": 0.965
}
```

---

### Bioluminescent Mangrove Research Voyage (Text to Video)

[Watch video](https://assets.runware.ai/examples/runway-gen-4-5/c728472f-8740-4603-854e-ac33a9f99e0e.mp4)

**Request**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "f290d937-a356-4d27-b855-397a95324784",
  "model": "runway:1@2",
  "positivePrompt": "A small wooden research skiff glides slowly through a flooded mangrove forest at blue hour, roots arching like cathedral columns over dark water alive with turquoise bioluminescence. Two scientists in practical weathered field gear examine glowing samples in glass jars while soft mist drifts between the trees. The camera begins low at water level following ripples and reflections, then gently rises and orbits the boat as schools of tiny luminous fish scatter beneath the surface. Firefly-like spores float in the air, distant thunderheads pulse faintly on the horizon, and wet leaves shimmer with subtle rain. Cinematic realism, rich natural textures, moody color contrast, believable motion, elegant parallax, immersive atmosphere, high visual fidelity.",
  "width": 1280,
  "height": 720,
  "duration": 8,
  "seed": 82229,
  "providerSettings": {
    "runway": {
      "contentModeration": {
        "publicFigureThreshold": "auto"
      }
    }
  }
}
```

**Response**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "f290d937-a356-4d27-b855-397a95324784",
  "videoUUID": "3bee3aad-6bc1-424c-92e4-7c791416bb7b",
  "videoURL": "https://vm.runware.ai/video/os/a09d21/ws/5/vi/3bee3aad-6bc1-424c-92e4-7c791416bb7b.mp4",
  "seed": 82229,
  "cost": 0.965
}
```

---

### Bioluminescent Mangrove Night Passage (Image to Video)

[Watch video](https://assets.runware.ai/examples/runway-gen-4-5/63f57628-ff7c-4090-ae40-c99633dc600e.mp4)

**Request**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "d822bbf0-d681-42f5-b659-df573b7681ef",
  "model": "runway:1@2",
  "positivePrompt": "Using the provided first-frame image as the opening composition, create a cinematic night journey through a flooded bioluminescent mangrove tunnel. The skiff glides slowly forward through dark reflective water while glowing blue root systems shimmer beneath the surface. Luminous insects swirl gently around the lantern, soft teal mist drifts between tangled branches, and subtle ripples trail behind the boat. Emphasize realistic motion, atmospheric depth, wet textures, delicate parallax through the mangrove roots, and a calm mysterious mood with high visual fidelity and smooth camera travel.",
  "width": 1280,
  "height": 720,
  "duration": 8,
  "seed": 4790,
  "providerSettings": {
    "runway": {
      "contentModeration": {
        "publicFigureThreshold": "auto"
      }
    }
  },
  "inputs": {
    "frameImages": [
      {
        "image": "https://assets.runware.ai/assets/inputs/e3ec74bf-6597-4f82-80ca-457e2f089161.jpg",
        "frame": "first"
      }
    ]
  }
}
```

**Response**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "d822bbf0-d681-42f5-b659-df573b7681ef",
  "videoUUID": "3d96a59f-68cc-437b-9992-9caa9c467463",
  "videoURL": "https://vm.runware.ai/video/os/a23d05/ws/5/vi/3d96a59f-68cc-437b-9992-9caa9c467463.mp4",
  "seed": 4790,
  "cost": 0.965
}
```