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

# Minimax-Hailuo-2.3-Fast

> API usage guide for Minimax-Hailuo-2.3-Fast.

{/* source_model_id: Minimax-Hailuo-2.3-Fast */}

{/* source_updated_at: 1761596410 */}

**Model ID**

```bash theme={null}
Minimax-Hailuo-2.3-Fast
```

**Calling method:** async

# Minimax-Hailuo-2.3-Fast API Usage Guide

## Overview

**Minimax-Hailuo-2.3-Fast** is a video generation model that creates high-quality short videos from text prompts, optionally guided by first-frame images. It supports camera movement instructions (e.g., \[Tilt Left], \[Pan Right]) and offers flexible control over duration, resolution, and prompt optimization.

### Key Features:

* Exceptional human physics, enabling dynamic and fluid movements such as flips, dancing sequences (including belly dancing and waltz), and more.
* Powerful VFX capabilities, delivering cinematic realism and immersive visual effects.
* Seamless style transformation, allowing for versatile and creative aesthetic shifts.
* Advanced stylization options, offering transformations like Pixar-style visuals and surrealist effects (e.g., water light).

## Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Submit Video Generation Request

### Base URL

```
https://console.gmicloud.ai
```

### Endpoint

```
POST /api/v1/ie/requestqueue/apikey/requests
```

### Request Format

```bash theme={null}
curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Minimax-Hailuo-2.3-Fast",
    "payload": {
      "prompt": "A serene ocean scene with waves under a pink sunset [Pan Right]",
      "duration": 6,
      "resolution": "768P",
      "prompt_optimizer": true,
      "fast_pretreatment": false
    }
  }'
```

### Request Parameters

| Parameter           | Type    | Required | Description                                                                                                                  | Default | Constraints                                                       |
| ------------------- | ------- | -------- | ---------------------------------------------------------------------------------------------------------------------------- | ------- | ----------------------------------------------------------------- |
| `prompt`            | string  | Yes      | Text description of the video to generate (max 2000 chars). Supports camera movement tags like `[Tilt Left]`, `[Pan Right]`. | ""      | Required                                                          |
| `first_frame_image` | image   | No       | A string containing an image URL. This image will be used as the first frame in the generated video.                         | ""      | Required for `512P`; optional for `768P` and `1080P`. Max 1 image |
| `duration`          | enum    | No       | Video duration in seconds.                                                                                                   | 6       | Options: 6, 10                                                    |
| `resolution`        | enum    | No       | Output resolution.                                                                                                           | "768P"  | For 6s: `512P`, `768P`, `1080P`; For 10s: `512P`, `768P`          |
| `prompt_optimizer`  | boolean | No       | Automatically optimize prompt for better quality.                                                                            | true    | true / false                                                      |
| `fast_pretreatment` | boolean | No       | Reduce processing time during prompt optimization.                                                                           | false   | true / false                                                      |

### Response

```json theme={null}
{
  "request_id": "7a99e510-3b20-48d1-89a1-0cd72b6242fb",
  "model": "Minimax-Hailuo-2.3-Fast",
  "status": "queued",
  "created_at": 1750442925,
  "updated_at": 1750442925,
  "queued_at": 1750442925
}
```

## Check Request Status

### Endpoint

```
GET /api/v1/ie/requestqueue/apikey/requests/{request_id}
```

### Example

```bash theme={null}
curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response

```json theme={null}
{
  "request_id": "7a99e510-3b20-48d1-89a1-0cd72b6242fb",
  "org_id": "your-org-id",
  "model": "Minimax-Hailuo-2.3-Fast",
  "status": "success",
  "is_public": false,
  "payload": {
    "prompt": "A serene ocean scene with waves under a pink sunset [Pan Right]",
    "duration": 6,
    "resolution": "768P",
    "first_frame_image": "",
    "prompt_optimizer": true,
    "fast_pretreatment": false
  },
  "outcome": {
    "video_url": "https://storage.googleapis.com/bucket/generated-video.mp4",
    "thumbnail_image_url": "https://storage.googleapis.com/bucket/thumbnail.jpg"
  },
  "created_at": 1750442925,
  "updated_at": 1750442930,
  "queued_at": 1750442925
}
```

## Request Status Values

| Status       | Description                             |
| ------------ | --------------------------------------- |
| `queued`     | Request is waiting to be processed      |
| `processing` | Video generation is in progress         |
| `success`    | Video generation completed successfully |
| `failed`     | Video generation failed                 |
| `cancelled`  | Request was cancelled                   |

## List Your Requests

### Endpoint

```
GET api/v1/ie/requestqueue/apikey/requests?model_id=Minimax-Hailuo-2.3-Fast
```

### Example

```bash theme={null}
curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=Minimax-Hailuo-2.3-Fast" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Get Model Information

### Endpoint

```
GET /api/v1/ie/requestqueue/apikey/models/Minimax-Hailuo-2.3-Fast
```

### Example

```bash theme={null}
curl -X GET "https://api.example.com/api/v1/apikey/models/Minimax-Hailuo-2.3-Fast" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## List Available Models

### Endpoint

```
GET /api/v1/apikey/models
```

### Example

```bash theme={null}
curl -X GET "https://api.example.com/api/v1/apikey/models" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response

```json theme={null}
{
    "model_ids": [
        "Kling-Image2Video-V2.1-Master",
        "Kling-Text2Video-V2.1-Master",
        "Luma-Ray2",
        "Veo3",
        "Veo3-Fast",
        "Wan-AI_Wan2.1-T2V-14B",
        "Wan-AI_Wan2.1-FLF2V-14B-720P",
        "Wan-AI_Wan2.1-I2V-14B-720P",
        "Minimax-Hailuo-2.3-Fast"
    ]
}
```

## Examples

### Quick Ocean Scene

```bash theme={null}
curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Minimax-Hailuo-2.3-Fast",
    "payload": {
      "prompt": "A calm beach with seagulls flying across the sky [Pan Left]",
      "duration": 6,
      "resolution": "512P",
      "prompt_optimizer": true
    }
  }'
```

### Animated with First Frame

```bash theme={null}
curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Minimax-Hailuo-2.3-Fast",
    "payload": {
      "prompt": "Extend this scene into a mystical forest journey",
      "duration": 10,
      "resolution": "768P",
      "first_frame_image": "https://example.com/frame.jpg",
      "fast_pretreatment": true
    }
  }'
```