# Minimax Hailuo V2.3 | Pro | Image to Video

Choose the minimax hailuo v2 3 pro image to video model for industry-standard realism to design videos that flawlessly render human expressions and atmospheric details.

## API Information

- **Model Slug:** minimax-hailuo-v2-3-pro-image-to-video
- **Branded URL:** https://www.eachlabs.ai/minimax/hailuo-v2-3/minimax-hailuo-v2-3-pro-image-to-video
- **Provider:** MiniMax
- **Category:** Image to Video
- **Output Type:** video
- **Status:** active
- **Version:** 0.0.1
- **Base Cost:** Fixed pricing: $0.49 per request
- **Estimated Processing Time:** 260 seconds
- **Last Updated:** 2026-04-16
- **Interactive Demo:** https://www.eachlabs.ai/ai-models/minimax-hailuo-v2-3-pro-image-to-video

## Pricing

- **Charge Type:** dynamic
- **Estimated Price (default example):** $0.4900
- **Pricing Details:** Fixed pricing: $0.49 per request

### Pricing Rules

| Condition | Pricing |
| --- | --- |
| Rule 1 | Fixed pricing: $0.49 per request |

## Input Schema

| Parameter | Type | Required | Default | Constraints | Description |
|-----------|------|----------|---------|-------------|-------------|
| prompt | string | Yes | - | - | Text prompt for video generation |
| image_url | string | Yes | - | - | URL of the image to use as the first frame |
| prompt_optimizer | boolean | No | true | - | Whether to use the model's prompt optimizer |

## Example Request

```bash
curl -X POST https://api.eachlabs.ai/v1/prediction/ \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "minimax-hailuo-v2-3-pro-image-to-video",
  "input": {
    "prompt": "cinematic macro video of raindrops falling and splashing on vibrant green leaves, droplets sliding slowly across the surface, soft ripples forming in nearby puddles, gentle camera motion, realistic water dynamics, shallow depth of field with smooth bokeh, overcast natural lighting, moody and melancholic tone, high-detail wet textures, slow-motion rainfall, atmospheric nature realism, 4k ultra-realistic film look",
    "image_url": "https://storage.googleapis.com/magicpoint/inputs/minimax-hailuo-2.3-pro-image-to-video-input.png"
  }
}'
```

## Output Schema

Response returned by `GET /v1/prediction/{id}` when the job completes:

```json
{
  "status": "success",
  "predictionID": "string",
  "output": "string (URL of generated video)",
  "metrics": {
    "predict_time": "number (seconds)"
  }
}
```

## Polling

```bash
curl https://api.eachlabs.ai/v1/prediction/{PREDICTION_ID} \
  -H "Authorization: Bearer YOUR_API_KEY"
```

| Status | Meaning |
|--------|---------|
| `processing` | Still running — poll again |
| `success` | Done — read `output` |
| `error` | Failed — read `message` / `details` |

## Webhook (alternative to polling)

Pass `"webhook_url": "https://your.host/path"` in the create request. Eachlabs POSTs this payload when the job ends:

```json
{
  "exec_id": "prediction-uuid",
  "status": "succeeded",
  "output": "https://...",
  "error": ""
}
```

`status` is `"succeeded"` or `"failed"`. `exec_id` equals the `predictionID` from create. Return 2xx within 30 seconds.

## Errors

Error body: `{ "status": "error", "message": "...", "details": "..." }`

| Code | Meaning |
|------|---------|
| `400` | Invalid input |
| `401` | Missing / invalid `Authorization` bearer token |
| `404` | Unknown model or prediction id |
| `429` | Rate limit — 100 creates / min, 10 concurrent per key |
| `5xx` | Retry with backoff |

## Overview

**minimax-hailuo-v2.3-pro-image-to-video — Image-to-Video AI Model**

Transform static images into dynamic, realistic videos with **minimax-hailuo-v2.3-pro-image-to-video**, the pro variant from Minimax's Hailuo v2.3 family designed for industry-leading realism in human expressions and atmospheric details. This **image-to-video AI model** excels at animating uploaded images into short clips with precise motion and temporal stability, solving the challenge of lifelike video generation from single frames for creators and developers seeking **Minimax image-to-video** capabilities. Developed as part of Hailuo 2.3 Pro, it supports high-fidelity outputs up to 1080p, making it ideal for professional workflows in e-commerce and social media content creation.

## Usage Notes

- API Base URL: `https://api.eachlabs.ai/v1`
- Authentication: send `Authorization: Bearer YOUR_API_KEY`. Generate a key from the Eachlabs dashboard at https://www.eachlabs.ai/dashboard/api-keys.
- File-typed parameters (`*_url`, `image_url`, `video_url`, `audio_url`, etc.) accept publicly-reachable HTTPS URLs only. Upload your asset first (GCS / S3 / your CDN) and pass the resulting URL. Data-URIs and localhost URLs are rejected.
- For structured parameters (arrays / objects) send real JSON values, not stringified payloads.
- Monetary values are reported in USD; per-token / per-megapixel rates may be billed in micro-cents internally.
- Prefer `webhook_url` over polling for long-running predictions — see the Webhook Callback section.