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

# Minimax H3 Image to Video API

> MiniMax Hailuo-03 — 2K image-to-video with optional first-to-last keyframe.

[← MiniMax](https://docs.creatify.ai/api-documentation/ai-generation/models/minimax.md)

**Model name:** `minimax/h3/image-to-video`\
**Generation type:** `image_to_video`\
**Endpoint:** [`POST /api/asset_generator/`](https://docs.creatify.ai/api-reference/ai-generation/post-ai-generation)

## Pricing

| Duration | 768P | 2K |
| - | - | - |
| 4s | **3.5** | **5.5** |
| 5s | **4.0** | **6.5** |
| 6s | **5.0** | **8.0** |
| 7s | **6.0** | **9.5** |
| 8s | **6.5** | **10.5** |
| 9s | **7.5** | **12.0** |
| 10s | **8.0** | **13.0** |
| 11s | **9.0** | **14.5** |
| 12s | **10.0** | **16.0** |
| 13s | **10.5** | **17.0** |
| 14s | **11.5** | **18.5** |
| 15s | **12.0** | **19.5** |

Prices are per output. When a request asks for several outputs, the charge is this price times the number of outputs.

## Quick start

The example uses sample media from our CDN. Swap in publicly accessible URLs for your own files.

```bash cURL theme={null}
curl --request POST \
  --url https://api.creatify.ai/api/asset_generator/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-ID: your-api-id' \
  --header 'X-API-KEY: your-api-key' \
  --data '{
    "model_name": "minimax/h3/image-to-video",
    "input_params": {
      "prompt": "She looks up from her laptop and smiles at the camera.",
      "image_url": "https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
    }
  }'
```

```python Python theme={null}
import requests

response = requests.post(
    "https://api.creatify.ai/api/asset_generator/",
    headers={"X-API-ID": "your-api-id", "X-API-KEY": "your-api-key"},
    json={
        "model_name": "minimax/h3/image-to-video",
        "input_params": {
            "prompt": "She looks up from her laptop and smiles at the camera.",
            "image_url": "https://d35ghwdno3nak3.cloudfront.net/tutorial/avatar-aurora/recommendation-4.jpg"
        },
    },
)
print(response.json()["id"])
```

## Input parameters

Send these fields in `input_params`.

**prompt** `string` *required*

Text prompt for video generation.

Minimum characters: `1`.
Maximum characters: `7000`.

**image\_url** `string` *required*

URL of the image to use as the first frame. The output aspect ratio follows this image.

**end\_image\_url** `string`

Optional URL of the image to use as the last frame (first-to-last keyframe).

**duration** `integer` (default: 5)

The duration of the video in seconds.

Allowed values: `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`.

**resolution** `string` (default: 2K)

768P or 2K resolution.

Allowed values: `"768P"`, `"2K"`.

> [accordion] Complete JSON schema
>
> ```json theme={null}
> {
>   "$schema": "http://json-schema.org/draft-07/schema#",
>   "required": [
>     "prompt",
>     "image_url"
>   ],
>   "properties": {
>     "prompt": {
>       "type": "string",
>       "title": "Prompt",
>       "minLength": 1,
>       "maxLength": 7000,
>       "description": "Text prompt for video generation."
>     },
>     "image_url": {
>       "type": "string",
>       "title": "Image Url",
>       "x-ui-name": "start_image",
>       "timeout": 20,
>       "min_width": 256,
>       "min_height": 256,
>       "max_width": 5760,
>       "max_height": 5760,
>       "max_file_size": 31457280,
>       "max_aspect_ratio": 2.5,
>       "min_aspect_ratio": 0.4,
>       "description": "URL of the image to use as the first frame. The output aspect ratio follows this image."
>     },
>     "end_image_url": {
>       "type": "string",
>       "title": "End Image Url",
>       "x-ui-name": "end_image",
>       "timeout": 20,
>       "min_width": 256,
>       "min_height": 256,
>       "max_width": 5760,
>       "max_height": 5760,
>       "max_file_size": 31457280,
>       "max_aspect_ratio": 2.5,
>       "min_aspect_ratio": 0.4,
>       "description": "Optional URL of the image to use as the last frame (first-to-last keyframe)."
>     },
>     "duration": {
>       "enum": [
>         4,
>         5,
>         6,
>         7,
>         8,
>         9,
>         10,
>         11,
>         12,
>         13,
>         14,
>         15
>       ],
>       "type": "integer",
>       "title": "Duration",
>       "default": 5,
>       "description": "The duration of the video in seconds."
>     },
>     "resolution": {
>       "enum": [
>         "768P",
>         "2K"
>       ],
>       "type": "string",
>       "title": "Resolution",
>       "default": "2K",
>       "description": "768P or 2K resolution.",
>       "x-advance-settings": true
>     }
>   }
> }
> ```

## Response

The request returns the task with `status: "initializing"`. Poll [GET /api/asset\_generator/\{id}/](https://docs.creatify.ai/api-reference/ai-generation/get-ai-generation-.md) until `status` is `done` or `failed`, or pass a `webhook_url` to be notified. A finished task lists its files in `assets` and the credits it charged in `credits_used`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.