Video Generation

MiniMax H3 API

MiniMax H3 — text-to-video, image-to-video, and reference-to-video (images, video and audio references) in one model. 2K or 768p output, 5-15s, native synced audio. Also carries H3 Max (cheaper 768p/480p, frames only), H3 Max Turbo (faster, tiered 768p/480p, frames only) and H3 Fast (480p, references). Integrate this model via REST with endpoint docs, parameters, and code examples.

Prompting guide Compare video models Use cases

Img2Vid

Audio

Credit Cost

4 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/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.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.	-
`reference_images`	string	Up to 9 image URLs that guide subject and scene identity. The first 5 are included; each one past that adds 1 credit. Cannot be combined with image_url / end_image_url.	-
`reference_videos`	string	Up to 3 video URLs (2-15s each, max 50MB) that guide motion and scene identity. Cannot be combined with image_url / end_image_url. Each second of reference video adds 4.5 credits (see reference_video_seconds).	-
`reference_video_seconds`	number	Combined length of reference_videos in seconds, billed at 4.5 credits per second (rounded up, at most 15s per clip). Applies only when every reference video was uploaded to PixelDojo (a temp.pixeldojo.ai or cdn.pixeldojo.ai URL, e.g. from POST /api/v1/upload); with any other link, or when omitted, each clip bills as 15s. Declare lengths for standard MP4 or MOV clips only: a clip we cannot read as one (WebM, MKV, fragmented MP4) counts as 15s, and an under-declared length is refused. min: 1	-
`reference_audios`	string	Up to 3 audio URLs (2-15s each, max 15MB) that guide voice and sound. Cannot be combined with image_url / end_image_url.	-
`aspect_ratio`	enum	Output aspect ratio. Ignored in image-to-video mode — the start frame sets the aspect. `16:94:31:19:163:4`+1 more	`16:9`
`resolution`	enum	Output tier: 2k (4 credits/sec) or 768p (2.5 credits/sec). Ignored in image-to-video mode — a start frame forbids explicit dimensions, so those jobs render and bill as 2k. `2k768p`	`2k`
`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

Example Outputs

Real outputs generated by this model

View Details

She grabs a bag of candy from the shelf and turns to the camera with a big, delighted smile. Handheld camera, warm shop light.

0 credits

Code Examples

Copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/minimax-h3/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": 20,
  "creditsRemaining": 95,
  "expiresAt": "2026-10-09T01:13:52Z"
}

Completed Response

json

{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "video": "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.mp4"
  },
  "creditCost": 20,
  "expiresAt": "2026-10-09T01:13:52Z"
}

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