Video Generation

MiniMax H3 Fast API

MiniMax H3 Fast, the speed-optimized H3. Text-to-video, image-to-video and reference-to-video (images, video and audio references) at 480p, 1.5 credits/sec plus 1.75 credits per second of reference video (at most 15s) and 1 per reference image past the fifth, 5-15s, native synced audio. Integrate this model via REST with endpoint docs, parameters, and code examples.

Prompting guide Compare video models Use cases

Img2Vid

Audio

Credit Cost

1.5 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-fast/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-fast.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 1.75 credits, at most 15s in total (see reference_video_seconds).	-
`reference_video_seconds`	number	Combined length of reference_videos in seconds, billed at 1.75 credits per second (rounded up, at most 15s in total: Fast takes 15s of reference video per job). 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, where the start frame sets the aspect. `16:94:31:19:163:4`+1 more	`16:9`
`resolution`	enum	Output tier. Fast renders 480p only (1.5 credits/sec). `480p`	`480p`
`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-fast/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": 7.5,
  "creditsRemaining": 95,
  "expiresAt": "2026-11-16T17:22:21Z"
}

Completed Response

json

{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "video": "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.mp4"
  },
  "creditCost": 7.5,
  "expiresAt": "2026-11-16T17:22:21Z"
}

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