Video Generation

MiniMax H3 Max API

MiniMax H3 Max, the cheaper H3 sibling. Text-to-video and image-to-video at 768p (2 credits/sec) or 480p (1.5 credits/sec), 5-15s, native synced audio. No reference inputs. Integrate this model via REST with endpoint docs, parameters, and code examples.

Prompting guide Compare video models Use cases

Img2Vid

Audio

Credit Cost

2 credits/sec

Type

Video

Get API Key

Create auth keys for apps and agents

See Usage

Track requests, credits, and logs

Buy Credits

Top up prepaid API capacity

API Endpoint

POST

/api/v1/models/minimax-h3-max/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

LLM.txt

AI-Ready

For AI assistants

Copy this model's documentation into Claude, GPT, or any AI for instant integration help.

/llm/minimax-h3-max.txt

OpenAPI Spec

Swagger compatible

Import into Postman, Swagger UI, or generate client SDKs in any language.

/api/openapi

Parameters

Input parameters accepted by this model

Parameter	Type	Description	Default
`prompt` required	string	Text description of the video, motion, and sound to generate	-
`image_url`	url	First-frame image. Switches to image-to-video mode.	-
`end_image_url`	url	Last-frame image. Requires image_url.	-
`aspect_ratio`	enum	Output aspect ratio. Ignored in image-to-video mode, where the start frame sets the aspect. `16:94:31:19:163:4`+1 more	`16:9`
`resolution`	enum	Output tier: 768p (2 credits/sec) or 480p (1.5 credits/sec). Honored in every mode, including image-to-video. `768p480p`	`768p`
`duration`	integer	Video duration in seconds (5-15) min: 5 \| max: 15	`5`
`seed`	integer	Random seed for reproducibility	-

Use saved characters (@Name)

Write @Name in the prompt to use a character, product, outfit, location, prop or style saved in the account's Character Studio, for example "@Mara on a beach at sunset". Its photos are added to reference_images automatically, after any images you send yourself, so your own image numbering is unchanged. List saved names with GET /api/v1/characters and save new ones with POST /api/v1/characters. An @word that names nothing saved stays plain text.

Supported Aspect Ratios

16:9

4:3

1:1

9:16

3:4

21:9

Code Examples

Copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/minimax-h3-max/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A lighthouse keeper climbs the spiral stairs at dawn, waves crashing below",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 10,
  "creditsRemaining": 95,
  "expiresAt": "2026-10-30T11:04:08Z"
}

Completed Response

json

{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "video": "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.mp4"
  },
  "creditCost": 10,
  "expiresAt": "2026-10-30T11:04:08Z"
}

LLM Documentation Try in Web UI Get API Key Usage Dashboard Buy Credits