---
title: MiniMax 01 Director | Runware Docs
url: https://runware.ai/docs/models/minimax-01-director
description: Cinematic text to video with precise camera control
---
# MiniMax 01 Director

![MiniMax 01 Director](https://assets.runware.ai/covers/minimax-01-director.jpg)

MiniMax 01 Director generates short cinematic video clips from text prompts with director level control. It supports detailed camera movement instructions, stable framing, and reduced motion randomness. Ideal for film previz, ads, and story beats inside production tools.

- **Status**: live
- **ID**: `minimax:2@1`
- Try in Playground
- **Creator**: MiniMax
- **Release Date**: January 28, 2025
- **Zero Data Retention**: Yes
- **Capabilities**: Text to Video, Image to Video, Checkpoint

## Pricing

$0.056 per second · ~2m 46s per request

**4 example generations**

- [first-frame](https://runware.ai/docs/models/minimax-01-director/examples#example-tidal-workwear-fashion-showcase): `$0.28` (~2m 56s)
- [first-frame](https://runware.ai/docs/models/minimax-01-director/examples#example-geothermal-control-room-presenter-clip): `$0.28` (~2m 47s)
- [text-to-video](https://runware.ai/docs/models/minimax-01-director/examples#example-veterinary-blood-bank-symbol-loop): `$0.28` (~2m 45s)
- [text-to-video](https://runware.ai/docs/models/minimax-01-director/examples#example-rooftop-apiary-honey-social-ad): `$0.28` (~2m 33s)

times vary, measured end to end · [How pricing works](https://runware.ai/docs/models-api/pricing)

## Compatibility & Validation

Either provide `inputs.frameImages`, or specify `width/height`.

---

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

---

The following dimension combinations are supported:

| Configuration | Dimensions |
| --- | --- |
| `720p (16:9)` | `1366x768` |

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/minimax-01-director#request-tasktype)

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

Identifier for the type of task being performed.

### [taskUUID](https://runware.ai/docs/models/minimax-01-director#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/minimax-01-director#request-outputtype)

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

Video output type.

**Allowed values**: `URL`

### [outputFormat](https://runware.ai/docs/models/minimax-01-director#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/minimax-01-director#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/minimax-01-director#request-webhookurl)

- **Type**: `string`
- **Format**: `uri`

Webhook URL that receives JSON responses 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/models-api/webhooks) (platform)

### [deliveryMethod](https://runware.ai/docs/models/minimax-01-director#request-deliverymethod)

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

Determines how the API delivers task results.

**Allowed values**:

- `sync` Returns results directly in the API response. Over HTTP, a task still running after 120 seconds continues as an async task and comes back with status 'processing'. Poll for its results using getResponse.
- `async` Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.

**Learn more** (1 resource):

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

### [uploadEndpoint](https://runware.ai/docs/models/minimax-01-director#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/minimax-01-director#request-safety)

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

Content safety checking configuration for video generation.

#### [checkContent](https://runware.ai/docs/models/minimax-01-director#request-safety-checkcontent)

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

Enable or disable content safety checking. Increases total generation time and adds a small charge on top of the generation cost.

#### [mode](https://runware.ai/docs/models/minimax-01-director#request-safety-mode)

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

Safety checking mode for video generation.

**Allowed values**:

- `fast` Checks key frames.
- `full` Checks all frames.

### [ttl](https://runware.ai/docs/models/minimax-01-director#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/minimax-01-director#request-includecost)

- **Type**: `boolean`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/minimax-01-director#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/minimax-01-director#request-inputs-frameimages)

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

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 position in the video.

The `frameImages` parameter allows you to constrain specific frames within the video sequence, ensuring that particular visual content appears at designated points. Position can be specified using `frame` (named positions or frame indices) or `timestamp` (seconds), depending on model support. 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 position, use an object with `image` and either `frame` or `timestamp` (model-dependent).

```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/minimax-01-director#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/minimax-01-director#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).

**Core Parameters**

Primary parameters that define the task output.

### [model](https://runware.ai/docs/models/minimax-01-director#request-model)

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

Send `auto` instead of an AIR identifier to have the model router choose the model for this task. The rest of the request is unchanged, every value you send is kept, and only the parameters you leave out are filled in. See [Model Router](https://runware.ai/docs/models-api/model-router).

**Learn more** (3 resources):

- [Text To Image: Model Selection](https://runware.ai/docs/learn/text-to-image#model-selection) (learn)
- [Image Inpainting: Model Specialized Inpainting Models](https://runware.ai/docs/learn/image-inpainting#model-specialized-inpainting-models) (learn)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/learn/image-outpainting#other-critical-parameters) (learn)

### [positivePrompt](https://runware.ai/docs/models/minimax-01-director#request-positiveprompt)

- **Type**: `string`
- **Required**: true
- **Min**: `2`
- **Max**: `2000`

Text prompt describing elements to include in the generated output.

**Learn more** (1 resource):

- [Prompts](https://runware.ai/docs/learn/prompts) (learn)

### [width](https://runware.ai/docs/models/minimax-01-director#request-width)

- **Type**: `integer`
- **Required**: conditional — Required when inputs.frameImages is not provided
- **Paired with**: height

Width of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

### [height](https://runware.ai/docs/models/minimax-01-director#request-height)

- **Type**: `integer`
- **Required**: conditional — Required when inputs.frameImages is not provided
- **Paired with**: width

Height of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

### [duration](https://runware.ai/docs/models/minimax-01-director#request-duration)

- **Type**: `integer`
- **Value**: `6`

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

### [fps](https://runware.ai/docs/models/minimax-01-director#request-fps)

- **Type**: `integer`
- **Value**: `25`

Frames per second for video generation. Higher values create smoother motion but require more processing time.

**Provider Settings**

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

### [promptOptimizer](https://runware.ai/docs/models/minimax-01-director#request-providersettings-minimax-promptoptimizer)

- **Path**: `providerSettings.minimax.promptOptimizer`
- **Type**: `boolean`

Automatic prompt optimization. Affects reproducibility.

## Response Parameters

### [taskType](https://runware.ai/docs/models/minimax-01-director#response-tasktype)

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

Identifier for the type of task this response belongs to.

### [taskUUID](https://runware.ai/docs/models/minimax-01-director#response-taskuuid)

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

UUID v4 identifier echoed from the original request, used to match async responses to their tasks.

### [videoUUID](https://runware.ai/docs/models/minimax-01-director#response-videouuid)

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

UUID of the output video.

### [videoURL](https://runware.ai/docs/models/minimax-01-director#response-videourl)

- **Type**: `string`
- **Format**: `uri`

URL of the output video.

### [videoBase64Data](https://runware.ai/docs/models/minimax-01-director#response-videobase64data)

- **Type**: `string`

Base64-encoded video data.

### [videoDataURI](https://runware.ai/docs/models/minimax-01-director#response-videodatauri)

- **Type**: `string`
- **Format**: `uri`

Data URI of the output video.

### [NSFWContent](https://runware.ai/docs/models/minimax-01-director#response-nsfwcontent)

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

### [cost](https://runware.ai/docs/models/minimax-01-director#response-cost)

- **Type**: `float`

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

## Examples

### text-to-video (text-to-video)

[Watch video](https://assets.runware.ai/examples/minimax-01-director/f5391a95-8b3a-4c45-90f1-6f14eb5a070a.mp4)

```json
{
  "taskType": "videoInference",
  "taskUUID": "c0d3cb4a-5936-4cf9-a5b1-09083805aee3",
  "model": "minimax:2@1",
  "positivePrompt": "A six-second seamless animated identity loop for a veterinary blood bank. On a warm ivory matte cyclorama, one polished ruby-red glass droplet floats at the exact center of the wide frame, casting a soft oval shadow. The camera begins in a precise overhead medium close-up and makes a slow, controlled push forward. A gentle heartbeat pulse travels through the droplet; four smaller coral-red droplets bud outward above it in smooth liquid motion, forming a clean, instantly readable paw-print logo. The completed paw symbol holds briefly with subtle internal refraction and a reassuring luminous glow. The motion then reverses elegantly: the four toe droplets merge back into the central ruby droplet as the camera pulls back along the identical path, ending on exactly the opening composition for a perfect loop. Premium medical-brand art direction, tactile glass material, oxblood and coral palette, diffuse studio lighting, restrained shadows, crisp silhouette, calm and compassionate mood. Stable symmetrical framing, no cuts, no splashes, no gore, no animals, no lettering or additional objects.",
  "width": 1366,
  "height": 768,
  "duration": 6,
  "fps": 25,
  "providerSettings": {
    "minimax": {
      "promptOptimizer": true
    }
  }
}
```

---

### text-to-video (text-to-video)

[Watch video](https://assets.runware.ai/examples/minimax-01-director/bd740fac-bd28-4bfd-8b6b-ef04b1d6896a.mp4)

```json
{
  "taskType": "videoInference",
  "taskUUID": "d1f702e0-6948-4386-9a6a-2d66afba1876",
  "model": "minimax:2@1",
  "positivePrompt": "A cinematic six-second social media ad for locally harvested rooftop honey, presented as one continuous photorealistic shot. At blue-hour sunrise on a city rooftop apiary, a beekeeper in a clean cream canvas suit slowly tilts a wooden honeycomb frame above an open, unbranded glass jar. Thick golden honey gathers along the comb and falls in one luminous ribbon into the jar while a few bees drift naturally through the air. Begin with an extreme macro view of the glowing hexagonal comb and honey catching the first warm sunlight. The camera performs a smooth, controlled slider pullback with a slight arc, gradually revealing the beekeeper, neat wooden hives, herb planters, and a softly defocused skyline. Rack focus from the flowing honey to the beekeeper and rooftop setting, then settle on a polished medium hero composition with the jar in the foreground. Rich amber honey contrasted with cool cyan dawn, soft rim light, subtle lens bloom, premium documentary realism, restrained motion, stable framing, shallow depth of field, natural bee behavior. No logos, labels, captions, or on-screen text.",
  "width": 1366,
  "height": 768,
  "duration": 6,
  "fps": 25,
  "providerSettings": {
    "minimax": {
      "promptOptimizer": true
    }
  }
}
```

---

### first-frame (first-frame)

[Watch video](https://assets.runware.ai/examples/minimax-01-director/38d4f23f-136b-462d-9b0b-e4546de62c94.mp4)

```json
{
  "taskType": "videoInference",
  "taskUUID": "da5e1e9d-76a1-4bf1-b97f-d2f791d303a7",
  "model": "minimax:2@1",
  "positivePrompt": "Continue directly from the supplied first frame as one controlled fashion showcase shot. The model takes two deliberate strides through the shallow tidal water, keeping a poised editorial posture while the mercury-gray waders flex naturally at the knees and the sculptural storm shell responds to the wind. Each bootfall sends a clean fan of droplets outward; concentric ripples travel across the reflective surface. The shell's back vent lifts and settles, hood tabs flutter, and the single safety-orange seam briefly catches the amber rim light. Eelgrass streams in the same crosswind and low clouds drift subtly behind the model. Use a smooth low-angle lateral tracking move that curves from the model's front three-quarter view toward their side, maintaining full-body framing before easing closer to a knee-up product hero composition. Stable horizon, restrained slow-motion feel, realistic fabric weight, consistent garment construction and facial identity, crisp waterproof textures, cool steel-blue grading with a narrow warm sunrise edge. End with the model planted confidently as droplets fall and the fabric settles. No cuts, text, logos, wardrobe changes, morphing or camera shake.",
  "width": 1366,
  "height": 768,
  "duration": 6,
  "fps": 25,
  "inputs": {
    "frameImages": [
      "https://assets.runware.ai/assets/inputs/c79ac226-3f01-4411-97d7-9964ffc64c96.jpg"
    ]
  }
}
```

---

### first-frame (first-frame)

[Watch video](https://assets.runware.ai/examples/minimax-01-director/3b588cc6-c8a3-4a22-ad07-4b1997af0131.mp4)

```json
{
  "taskType": "videoInference",
  "taskUUID": "9ce13494-6f5c-4a09-a3a7-fa1e4b7c3999",
  "model": "minimax:2@1",
  "positivePrompt": "Continue seamlessly from the supplied first frame as a polished industrial documentary presenter clip. The geothermal engineer speaks directly to the audience with natural, clearly articulated mouth movement and confident eye contact. She raises the basalt core slightly while explaining it, turns it once between her gloved fingers, then makes one concise open-hand gesture before settling both hands. Preserve her face, clothing, proportions, and the core sample consistently. Behind her, wind pushes layered white steam slowly across the observation window while small cyan indicator lights pulse softly and reflections shift over the glass. The camera performs a very slow, stable dolly-in from a waist-up medium shot toward a chest-up framing, with subtle documentary handheld breathing but no shake. Warm key light remains steady on her face against the cool control-room glow. Serious, credible, calm scientific tone; realistic motion and restrained performance. Single continuous take, no cuts, no captions, no logos, no added graphics.",
  "width": 1366,
  "height": 768,
  "duration": 6,
  "fps": 25,
  "inputs": {
    "frameImages": [
      "https://assets.runware.ai/assets/inputs/0cc873b7-72ab-4e45-bb00-339c4c9c34de.jpg"
    ]
  }
}
```