# MiniMax H3 Max Image to Video

> MiniMax H3 Max image-to-video via Fal.AI. fal's post-trained variant of MiniMax Hailuo-03 (H3), tuned for stronger prompt adherence and better aesthetics — animates a first-frame image (optional last frame for keyframe control) into 5-15 second clips with native audio at 480P/768P native or 1080P refined output.

- **Provider**: fal
- **Model ID**: minimax/h3-max/image-to-video
- **Category**: video_generation
- **Credits**: 930 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

- `duration` (integer, optional): The duration of the video in seconds (billed per second). (Default: `5`; Range: min: 5, max: 15)
- `enable_safety_checker` (boolean, optional): If set to true, the safety checker will be enabled. (Default: `True`)
- `prompt_expansion_mode` (string, optional): How much effort to spend rewriting the prompt before generation. 'disabled' skips prompt expansion, 'balanced' returns in about a second, 'quality' spends up to ~30s on a richer prompt. (Default: `balanced`; Options: `disabled`, `balanced`, `quality`)
- `seed` (integer, optional): Random seed. A random seed is selected when omitted.
- `image_url` (string, **required**): URL of the image to use as the first frame. The output canvas follows this image.
- `prompt` (string, **required**): Text prompt for video generation
- `end_image_url` (string, optional): Optional URL of the image to use as the last frame, for first-to-last keyframe generation.
- `resolution` (string, optional): The native generation resolution (480P or 768P), or 1080P latent refinement from a native 768P source. (Default: `768P`; Options: `480P`, `768P`, `1080P`)

## Example Request

```json
{
  "model": "minimax/h3-max/image-to-video",
  "input": {
    "duration": 5,
    "prompt": "The camera slowly pulls back from the scene, revealing the full landscape as clouds drift overhead and light shifts across the terrain.",
    "resolution": "768P",
    "image_url": "https://storage.googleapis.com/falserverless/example_inputs/hailuo23/pro_i2v_in.jpg"
  }
}
```

## 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

json

## Tags

video-generation, image-to-video, minimax, hailuo

## Documentation

https://fal.ai/models/minimax/h3-max/image-to-video