# MiniMax Hailuo 2.3

> High-fidelity video generation optimized for realistic human motion, cinematic VFX, expressive characters, and strong prompt/style adherence. Supports text-to-video and image-to-video workflows.

- **Provider**: replicate
- **Model ID**: minimax/hailuo-2.3
- **Category**: video_generation
- **Credits**: 420 per request
- **Pricing Type**: input_based

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `first_frame_image` (string, optional): First frame image for video generation. Output will match this aspect ratio.
- `duration` (integer, optional): Duration in seconds. 10s only available for 768p. (Default: `6`; Options: `6`, `10`)
- `prompt` (string, **required**): Text prompt for generation
- `resolution` (string, optional): Video resolution. 1080p supports only 6-second duration. (Default: `768p`; Options: `768p`, `1080p`)
- `prompt_optimizer` (boolean, optional): Use prompt optimizer (Default: `True`)

## Example Request

```json
{
  "model": "minimax/hailuo-2.3",
  "input": {
    "duration": 6,
    "prompt": "Two firebenders face off in a dark alley as heavy rain pours. Sparks ignite from soaked fists.",
    "resolution": "768p",
    "prompt_optimizer": true
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

url

## Tags

minimax, hailuo, video-generation, text-to-video, image-to-video, cinematic, realistic-motion, vfx, 1080p

## Documentation

https://replicate.com/minimax/hailuo-2.3