---
title: MiniMax Hailuo 2.3 | Runware Docs
url: https://runware.ai/docs/models/minimax-hailuo-2-3
description: High fidelity AI video generation from text or images
---
# MiniMax Hailuo 2.3

MiniMax Hailuo 2.3 is a cinematic video model for short form production. It accepts text prompts or image inputs and outputs 6 or 10 second clips at 768p or 1080p. It focuses on consistent motion, strong physics, and stable scenes for ads, social content, and creative shots.

- **ID**: `minimax:4@1`
- **Status**: live
- **Creator**: MiniMax
- **Release Date**: October 28, 2025
- **Capabilities**: Text to Video, Image to Video

## Pricing

From $0.28 per generation

- **768p · 6s**: `$0.28`
- **768p · 10s**: `$0.56`
- **1080p · 6s**: `$0.49`

## Compatibility & Validation

Parameter constraints vary based on the configuration:

| Dimensions | duration |
| --- | --- |
| `1920x1080` | `6` |
| `Other` | `6` `10` |

---

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

---

The following dimension combinations are supported:

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

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/minimax-hailuo-2-3#request-tasktype)

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

Identifier for the type of task being performed

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

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

Video output type.

**Allowed values**: `URL`

### [outputFormat](https://runware.ai/docs/models/minimax-hailuo-2-3#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-hailuo-2-3#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-hailuo-2-3#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/minimax-hailuo-2-3#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/minimax-hailuo-2-3#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-hailuo-2-3#request-safety)

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

Content safety checking configuration for video generation.

#### [checkContent](https://runware.ai/docs/models/minimax-hailuo-2-3#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/minimax-hailuo-2-3#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/minimax-hailuo-2-3#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-hailuo-2-3#request-includecost)

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

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/minimax-hailuo-2-3#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-hailuo-2-3#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/minimax-hailuo-2-3#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-hailuo-2-3#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/minimax-hailuo-2-3#request-model)

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

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/minimax-hailuo-2-3#request-positiveprompt)

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

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/minimax-hailuo-2-3#request-width)

- **Type**: `integer`
- **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/minimax-hailuo-2-3#request-height)

- **Type**: `integer`
- **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/minimax-hailuo-2-3#request-duration)

- **Type**: `float`

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-hailuo-2-3#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-hailuo-2-3#request-providersettings-minimax-promptoptimizer)

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

Enable automatic prompt optimization. Affects reproducibility.

## Response Parameters

### [taskType](https://runware.ai/docs/models/minimax-hailuo-2-3#response-tasktype)

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

Type of the task.

### [taskUUID](https://runware.ai/docs/models/minimax-hailuo-2-3#response-taskuuid)

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

UUID of the task.

### [videoUUID](https://runware.ai/docs/models/minimax-hailuo-2-3#response-videouuid)

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

UUID of the output video.

### [videoURL](https://runware.ai/docs/models/minimax-hailuo-2-3#response-videourl)

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

URL of the output video.

### [videoBase64Data](https://runware.ai/docs/models/minimax-hailuo-2-3#response-videobase64data)

- **Type**: `string`

Base64-encoded video data.

### [videoDataURI](https://runware.ai/docs/models/minimax-hailuo-2-3#response-videodatauri)

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

Data URI of the output video.

### [seed](https://runware.ai/docs/models/minimax-hailuo-2-3#response-seed)

- **Type**: `integer`

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

### [NSFWContent](https://runware.ai/docs/models/minimax-hailuo-2-3#response-nsfwcontent)

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

### [cost](https://runware.ai/docs/models/minimax-hailuo-2-3#response-cost)

- **Type**: `float`

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

## Examples

### Submerged Grand Piano Ballroom (Text to Video)

[Watch video](https://assets.runware.ai/examples/minimax-hailuo-2-3/e039c1cb-eb07-424e-b57e-1230afcd7956.mp4)

**Request**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "12c20a98-991b-459f-b3a3-41741a7dfd19",
  "model": "minimax:4@1",
  "positivePrompt": "A vast forgotten ballroom fully submerged underwater, a black grand piano resting on a marble floor while translucent curtains sway gently from tall arched windows. Shafts of pale morning light filter through the water, illuminating floating sheet music, tiny bubbles, and suspended dust. Small silver fish weave between chandeliers overhead. The camera begins with a slow wide glide across cracked checkerboard tiles, then eases closer to the piano as a single white glove drifts past the keys. Rich cinematic realism, graceful motion, stable composition, detailed caustics, elegant atmosphere, strong depth, realistic underwater physics, premium short-film look.",
  "width": 1920,
  "height": 1080,
  "duration": 6,
  "fps": 25,
  "providerSettings": {
    "minimax": {
      "promptOptimizer": false
    }
  }
}
```

**Response**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "12c20a98-991b-459f-b3a3-41741a7dfd19",
  "videoUUID": "bfe8f918-e001-4d15-99ed-57b2abf769b5",
  "videoURL": "https://vm.runware.ai/video/os/a12d13/ws/5/vi/bfe8f918-e001-4d15-99ed-57b2abf769b5.mp4",
  "seed": 552434557,
  "cost": 0.49
}
```

---

### Glasshouse Violin Repair Bench (Image to Video)

[Watch video](https://assets.runware.ai/examples/minimax-hailuo-2-3/45e99d0e-8e5b-41af-a669-eb178c1f7c34.mp4)

**Request**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "97375c0b-7fe1-4361-b9c9-dbe56adbb1ea",
  "model": "minimax:4@1",
  "positivePrompt": "Animate from the provided first frame as a refined cinematic macro-to-medium shot in a sunlit glasshouse workshop. A luthier carefully tightens and tests violin strings with subtle, precise hand motion. The camera performs a gentle slow push-in with slight parallax across tools and wood shavings. Dust motes drift through warm shafts of light, fern leaves sway faintly in the distance, varnish jars catch shifting highlights, and the violin body reflects soft moving glints. Preserve scene layout and subject identity, with stable composition, realistic material response, natural finger articulation, delicate object interaction, and polished short-form commercial quality.",
  "width": 1366,
  "height": 768,
  "duration": 6,
  "fps": 25,
  "providerSettings": {
    "minimax": {
      "promptOptimizer": false
    }
  },
  "inputs": {
    "frameImages": [
      {
        "image": "https://assets.runware.ai/assets/inputs/42669300-03ee-4ffc-838b-725c43d380da.jpg",
        "frame": "first"
      }
    ]
  }
}
```

**Response**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "97375c0b-7fe1-4361-b9c9-dbe56adbb1ea",
  "videoUUID": "18027be8-4589-48cc-bfae-2dd54c39bde2",
  "videoURL": "https://vm.runware.ai/video/os/a09d21/ws/5/vi/18027be8-4589-48cc-bfae-2dd54c39bde2.mp4",
  "seed": 150814442,
  "cost": 0.28
}
```

---

### Windblown Desert Airship Arrival (Text to Video)

[Watch video](https://assets.runware.ai/examples/minimax-hailuo-2-3/a2bb7e14-053b-40d0-920e-146a86892562.mp4)

**Request**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "55eda37a-26c4-4640-bbf1-28985fdb6713",
  "model": "minimax:4@1",
  "positivePrompt": "A cinematic wide shot of a colossal copper-and-canvas airship descending toward an isolated desert outpost built from sun-baked stone and faded fabric canopies, late afternoon light casting long amber shadows across rippled dunes. Wind drives sheets of dust around landing pylons as workers in layered travel garments brace ropes and signal from the ground. The airship’s suspension cables sway realistically, sand spirals outward from the downdraft, fabric awnings snap and flutter, small loose objects skid across the ground, and the vessel settles with believable weight and inertia. Camera language: slow forward tracking shot with slight handheld vibration from the gusts, maintaining clear focus on the descending craft and the settlement below. Rich atmospheric depth, dramatic scale, grounded physics, consistent scene continuity, premium short-form commercial cinematography.",
  "width": 1920,
  "height": 1080,
  "duration": 6,
  "fps": 25,
  "providerSettings": {
    "minimax": {
      "promptOptimizer": false
    }
  }
}
```

**Response**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "55eda37a-26c4-4640-bbf1-28985fdb6713",
  "videoUUID": "d44f3345-bd0d-48ef-8636-93f874d4ec80",
  "videoURL": "https://vm.runware.ai/video/os/a17d13/ws/5/vi/d44f3345-bd0d-48ef-8636-93f874d4ec80.mp4",
  "seed": 291400484,
  "cost": 0.49
}
```

---

### Rain-Slick Arcade Alley (Image to Video)

[Watch video](https://assets.runware.ai/examples/minimax-hailuo-2-3/72214ed4-0317-487a-80ea-fe9a58ac063b.mp4)

**Request**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "0ca5af1b-1ce8-49ba-9838-8808ac1f9730",
  "model": "minimax:4@1",
  "positivePrompt": "Using the provided first frame as the opening shot, create a 6-second cinematic sequence in a rain-slick alley beside an old arcade. The teenager in the yellow raincoat gently releases the paper airplane and watches it glide forward through the damp air. The camera makes a subtle slow push-in while keeping the scene composition stable. Steam curls from the street vent, puddles ripple from light drips overhead, reflected signage shimmers across the pavement, and the arcade doorway flickers with soft colored light. Preserve realistic physics, natural fabric motion, wet-surface reflections, restrained atmosphere, and cohesive live-action cinematography with crisp detail and grounded movement.",
  "width": 1366,
  "height": 768,
  "duration": 6,
  "fps": 25,
  "providerSettings": {
    "minimax": {
      "promptOptimizer": false
    }
  },
  "inputs": {
    "frameImages": [
      {
        "image": "https://assets.runware.ai/assets/inputs/7cb04824-f18d-44be-83ba-55296f82f30b.jpg",
        "frame": "first"
      }
    ]
  }
}
```

**Response**:

```json
{
  "taskType": "videoInference",
  "taskUUID": "0ca5af1b-1ce8-49ba-9838-8808ac1f9730",
  "videoUUID": "8e84991e-503c-4208-8540-087361b38255",
  "videoURL": "https://vm.runware.ai/video/os/a09d21/ws/5/vi/8e84991e-503c-4208-8540-087361b38255.mp4",
  "seed": 441958454,
  "cost": 0.28
}
```