---
title: MiniMax Hailuo 2.3
description: A high-fidelity video generation model optimized for realistic human motion, cinematic VFX, expressive characters, and strong prompt and style adherence across text-to-video and image-to-video workflows.
image: https://developers.cloudflare.com/dev-products-preview.png
---

> Documentation Index  
> Fetch the complete documentation index at: https://developers.cloudflare.com/ai/llms.txt  
> Use this file to discover all available pages before exploring further. 

[Skip to content](#%5Ftop) 

![MiniMax logo](https://developers.cloudflare.com/_astro/minimax.DPZX-zZI.svg) 

#  MiniMax Hailuo 2.3 

Text-to-Video • MiniMax 

`minimax/hailuo-2.3` 

A high-fidelity video generation model optimized for realistic human motion, cinematic VFX, expressive characters, and strong prompt and style adherence across text-to-video and image-to-video workflows.

| Model Info          |                                                                                                                      |
| ------------------- | -------------------------------------------------------------------------------------------------------------------- |
| Terms and License   | [link ↗](https://hailuoai.com/terms)                                                                                 |
| More information    | [link ↗](https://hailuoai.com/)                                                                                      |
| Zero data retention | Yes                                                                                                                  |
| Pricing             | [View pricing in the Cloudflare dashboard ↗](https://dash.cloudflare.com/?to=/:account/ai/models/minimax/hailuo-2.3) |

## Usage

* [ TypeScript ](#tab-panel-860)
* [ cURL ](#tab-panel-861)

TypeScript

```
const response = await env.AI.run(  'minimax/hailuo-2.3',  {    prompt: 'A golden retriever playing fetch on a sandy beach at sunset',    duration: 6,    fast_pretreatment: false,    prompt_optimizer: true,    resolution: '768P',  },)console.log(response)
```

Terminal window

```
curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \  --header "Content-Type: application/json" \  --data '{  "model": "minimax/hailuo-2.3",  "input": {    "prompt": "A golden retriever playing fetch on a sandy beach at sunset",    "duration": 6,    "fast_pretreatment": false,    "prompt_optimizer": true,    "resolution": "768P"  }}'
```

* [ Output ](#tab-panel-858)
* [ Raw response ](#tab-panel-859)

```
{  "gatewayMetadata": {    "keySource": "Unified"  },  "result": {    "status": "Success",    "task_id": "388507504709991",    "video": "https://video-product.cdn.minimax.io/inference_output/video/2026-04-17/97d0c2d0-45ab-4ce8-a1f4-177401f43073/output.mp4"  },  "state": "Completed"}
```

## Examples

**High Resolution**  — 1080P video for higher quality output 

* [ TypeScript ](#tab-panel-864)
* [ cURL ](#tab-panel-865)

TypeScript

```
const response = await env.AI.run(  'minimax/hailuo-2.3',  {    prompt:      'A professional chef preparing sushi in a traditional Japanese kitchen, detailed close-up shots',    duration: 6,    fast_pretreatment: false,    prompt_optimizer: true,    resolution: '1080P',  },)console.log(response)
```

Terminal window

```
curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \  --header "Content-Type: application/json" \  --data '{  "model": "minimax/hailuo-2.3",  "input": {    "prompt": "A professional chef preparing sushi in a traditional Japanese kitchen, detailed close-up shots",    "duration": 6,    "fast_pretreatment": false,    "prompt_optimizer": true,    "resolution": "1080P"  }}'
```

* [ Output ](#tab-panel-862)
* [ Raw response ](#tab-panel-863)

```
{  "gatewayMetadata": {    "keySource": "Unified"  },  "result": {    "status": "Success",    "task_id": "388510158565457",    "video": "https://video-product.cdn.minimax.io/inference_output/video/2026-04-17/1ee6a770-eb88-4b6a-86ea-61981f01ed65/output.mp4"  },  "state": "Completed"}
```

**Image to Video**  — Animate a still image with I2V 

* [ TypeScript ](#tab-panel-870)
* [ cURL ](#tab-panel-871)

TypeScript

```
const response = await env.AI.run(  'minimax/hailuo-2.3',  {    prompt: 'Slowly zoom in with subtle parallax movement, gentle atmospheric motion',    duration: 6,    fast_pretreatment: false,    first_frame_image:      'https://replicate.delivery/xezq/MQpUhqkESIIQDlWUxtNcsznZLfUTmhEbCV3vdAZGHGPwwaMLA/tmpgl4gvv5n.jpeg',    prompt_optimizer: true,    resolution: '768P',  },)console.log(response)
```

Terminal window

```
curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \  --header "Content-Type: application/json" \  --data '{  "model": "minimax/hailuo-2.3",  "input": {    "prompt": "Slowly zoom in with subtle parallax movement, gentle atmospheric motion",    "duration": 6,    "fast_pretreatment": false,    "first_frame_image": "https://replicate.delivery/xezq/MQpUhqkESIIQDlWUxtNcsznZLfUTmhEbCV3vdAZGHGPwwaMLA/tmpgl4gvv5n.jpeg",    "prompt_optimizer": true,    "resolution": "768P"  }}'
```

* [ Output ](#tab-panel-866)
* [ Raw response ](#tab-panel-867)

```
{  "gatewayMetadata": {    "keySource": "Unified"  },  "result": {    "status": "Success",    "task_id": "388509844320343",    "video": "https://video-product.cdn.minimax.io/inference_output/video/2026-04-17/a19c7850-6f3b-47dd-b6f1-decb592a11ff/output.mp4"  },  "state": "Completed"}
```

**Fast Processing**  — Enable fast pretreatment for quicker results 

* [ TypeScript ](#tab-panel-872)
* [ cURL ](#tab-panel-873)

TypeScript

```
const response = await env.AI.run(  'minimax/hailuo-2.3',  {    prompt: 'Fireworks exploding over a city skyline at night, colorful reflections on water',    duration: 6,    fast_pretreatment: true,    prompt_optimizer: true,    resolution: '768P',  },)console.log(response)
```

Terminal window

```
curl https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/run \  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \  --header "Content-Type: application/json" \  --data '{  "model": "minimax/hailuo-2.3",  "input": {    "prompt": "Fireworks exploding over a city skyline at night, colorful reflections on water",    "duration": 6,    "fast_pretreatment": true,    "prompt_optimizer": true,    "resolution": "768P"  }}'
```

* [ Output ](#tab-panel-868)
* [ Raw response ](#tab-panel-869)

```
{  "gatewayMetadata": {    "keySource": "Unified"  },  "result": {    "status": "Success",    "task_id": "388509805367378",    "video": "https://video-product.cdn.minimax.io/inference_output/video/2026-04-17/438b5433-5d32-4760-9564-c86da3d22aee/output.mp4"  },  "state": "Completed"}
```

## Parameters

* [ Input ](#tab-panel-874)
* [ Output ](#tab-panel-875)

prompt

`string`maxLength: 2000

first\_frame\_image

`string`

prompt\_optimizer

`boolean`requireddefault: true

fast\_pretreatment

`boolean`requireddefault: false

▶duration

`one of`required

resolution

`string`requireddefault: 768Penum: 768P, 1080P

video

`string`format: uri

task\_id

`string`

status

`string`enum: Preparing, Queueing, Processing, Success, Fail

## API Schemas (Raw)

Input [ ](https://developers.cloudflare.com/ai/models/minimax/hailuo-2.3/schema-input.json "Open") [ ](https://developers.cloudflare.com/ai/models/minimax/hailuo-2.3/schema-input.json "Download") 

Output [ ](https://developers.cloudflare.com/ai/models/minimax/hailuo-2.3/schema-output.json "Open") [ ](https://developers.cloudflare.com/ai/models/minimax/hailuo-2.3/schema-output.json "Download")

```json
{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/ai/models/minimax/hailuo-2.3/#page","headline":"MiniMax Hailuo 2.3 (MiniMax) · Cloudflare AI docs · Cloudflare AI docs","description":"A high-fidelity video generation model optimized for realistic human motion, cinematic VFX, expressive characters, and strong prompt and style adherence across text-to-video and image-to-video workflows.","url":"https://developers.cloudflare.com/ai/models/minimax/hailuo-2.3/","inLanguage":"en","image":"https://developers.cloudflare.com/dev-products-preview.png","publisher":{"@type":"Organization","name":"Cloudflare","url":"https://www.cloudflare.com/"},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"item":{"@id":"/directory/","name":"Directory"}},{"@type":"ListItem","position":2,"item":{"@id":"/ai/","name":"AI"}},{"@type":"ListItem","position":3,"item":{"@id":"/ai/models/","name":"Models"}}]}
```