---
title: "MiniMax H3 Max"
method: POST
path: "/generate/video/minimax/h3-max"
tags: ["Video"]
---

# MiniMax H3 Max

`POST /generate/video/minimax/h3-max`

Post-trained H3 variant with stronger prompt adherence, better aesthetics, and image/video/audio references.

## Headers

- `X-Webhook-URL` string, uri

## Request body

- object
  - `prompt` string, required
  - `start_image` string, uri, nullable — Can be an external URL, base64 data URI, or uploaded asset URL.
  - `aspect_ratio` '21:9' | '16:9' | '4:3' | '1:1' | '3:4' | '9:16'
  - `end_image` string, uri, nullable — Can be an external URL, base64 data URI, or uploaded asset URL.
  - `resolution` '480p' | '768p' | '1080p'
  - `duration` integer
  - `seed` integer
  - `prompt_expansion_mode` 'disabled' | 'fast' | 'balanced' | 'quality'
  - `reference_images` string[]
  - `reference_videos` string[]
  - `reference_video_seconds` number
  - `reference_audios` string[]

## Response `200`

The resulting job data. This will be returned in a pending state until the job is completed. See [`/jobs/{id}`](#tag/default/get/jobs/{id}) for retrieving the results.

- object
  - `job_id` string, uuid, required
  - `status` 'backlogged' | 'queued' | 'scheduled' | 'processing' | 'sampling' | 'intermediate-complete' | 'completed' | 'failed' | 'cancelled', required
  - `created_at` string, date-time, required
  - `completed_at` unknown, required
  - `result` unknown, required
  - `error` object
    - `code` string, required
    - `message` string

## Other responses

- `400` — The request body is invalid.
- `401` — You are not authenticated.
- `402` — You have run out of credits.
- `429` — You have reached the maximum number of concurrent jobs.

## Changes

- **2026-09-09** `9c6089ec8477` — 1 info
  - added the new `1080p` enum value to the request property `resolution`
- **2026-09-05** `27a8a554d4fd` — 1 info
  - the `created_at` response's property pattern was changed from `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$` to `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$` for the status `200`
- **2026-09-01** `b13a2d0f6592` — 4 info
  - added the new optional request property `reference_audios`
  - added the new optional request property `reference_images`
  - added the new optional request property `reference_video_seconds`
  - added the new optional request property `reference_videos`
- **2026-08-27** `dd9cc1c73731` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/krea/apis/krea-api/changes/generate/video/minimax/h3-max/post.md)

---

[API](https://skmtc.dev/krea/apis/krea-api.md) · [All operations](https://skmtc.dev/krea/apis/krea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/krea/apis/krea-api/revisions/fe9306f776eb?raw)