MiniMax H3 Fast API documentation

Name: MiniMax H3 Fast API
Brand: MiniMax
SKU: minimax/h3-fast
Availability: InStock

Everything you need to call MiniMax H3 Fast from your code. Base URL https://cheapergen.com/api/v1. Try it first in the playground.

Using a coding agent?

Paste this into Claude Code, Cursor, Codex or any coding agent. It adds the API to your project, keeps the key in CHEAPERGEN_API_KEY and tests with a free quote before anything is spent.

Add MiniMax H3 Fast (CheaperGen endpoint minimax/h3-fast/text-to-video) to this project by following https://cheapergen.com/agents/integrate.md

What your agent reads

Authentication

Create a key in Dashboard → API keys and send it as a bearer token. Keep keys server-side.

export CHEAPERGEN_API_KEY="cg_live_…"

# every request
Authorization: Bearer $CHEAPERGEN_API_KEY

MiniMax H3 Fast Text to Video API

POST/api/v1/run/minimax/h3-fast/text-to-video

Submits an asynchronous job and returns 202 with a generation id. Poll GET /api/v1/generations/{id} or pass webhook_url. See job lifecycle.

Input parameters

Name	Type	Description	Affects price
`prompt`required	string	Describe the shot: subject, action, camera movement, lighting and style.	No
`aspect_ratio`	string (enum)	Output frame shape. Values: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 Default: 16:9	Yes
`resolution`	string (enum)	Output resolution. Higher resolutions cost more per second. Values: 480P · 768P Default: 768P	Yes
`duration`	integer	Length of the generated clip in seconds (4–15s). You pay per second. Range: 4–15s Default: 6	Yes
`seed`	integer	Use the same seed and settings to reproduce a result. Leave empty for random.	No
`enable_safety_checker`	boolean	If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way. Default: true	No
`webhook_url`	string (URL)	Optional. We POST the finished generation here, signed with your webhook secret. Webhooks	No

Request

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/minimax/h3-fast/text-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "A paper boat drifts down a rain-filled gutter at dusk, the patter of rain and a distant tram bell",
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/minimax/h3-fast/text-to-video", headers=headers, json={
    "prompt": "A paper boat drifts down a rain-filled gutter at dusk, the patter of rain and a distant tram bell",
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

curl -X POST https://cheapergen.com/api/v1/run/minimax/h3-fast/text-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "A paper boat drifts down a rain-filled gutter at dusk, the patter of rain and a distant tram bell",
  "aspect_ratio": "16:9",
  "resolution": "768P",
  "duration": 6
}'

Response

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3-fast",
  "endpoint": "minimax/h3-fast/text-to-video",
  "mode": "text-to-video",
  "status": "queued",
  "input": {
    "prompt": "A paper boat drifts down a rain-filled gutter at dusk, the patter of rain and a distant tram bell",
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "reference",
    "list_price_label": "Official MiniMax H3 API",
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3-fast",
  "endpoint": "minimax/h3-fast/text-to-video",
  "mode": "text-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "A paper boat drifts down a rain-filled gutter at dusk, the patter of rain and a distant tram bell",
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "reference",
    "list_price_label": "Official MiniMax H3 API",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

MiniMax H3 Fast Image to Video API

POST/api/v1/run/minimax/h3-fast/image-to-video

Submits an asynchronous job and returns 202 with a generation id. Poll GET /api/v1/generations/{id} or pass webhook_url. See job lifecycle.

Input parameters

Name	Type	Description	Affects price
`prompt`required	string	Describe the shot: subject, action, camera movement, lighting and style.	No
`image_url`required	string (URL)	Image used as the opening frame. JPG/PNG/WebP, URL or upload.	No
`end_image_url`	string (URL)	Optional closing frame — the model animates between the two.	No
`aspect_ratio`	string (enum)	Output frame shape. Pick the one closest to your first frame. Values: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 Default: 16:9	Yes
`resolution`	string (enum)	Output resolution. Higher resolutions cost more per second. Values: 480P · 768P Default: 768P	Yes
`duration`	integer	Length of the generated clip in seconds (4–15s). You pay per second. Range: 4–15s Default: 6	Yes
`seed`	integer	Use the same seed and settings to reproduce a result. Leave empty for random.	No
`enable_safety_checker`	boolean	If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way. Default: true	No
`webhook_url`	string (URL)	Optional. We POST the finished generation here, signed with your webhook secret. Webhooks	No

Request

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/minimax/h3-fast/image-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "The flower opens slowly in the morning light, birdsong in the background",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/minimax/h3-fast/image-to-video", headers=headers, json={
    "prompt": "The flower opens slowly in the morning light, birdsong in the background",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

curl -X POST https://cheapergen.com/api/v1/run/minimax/h3-fast/image-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "The flower opens slowly in the morning light, birdsong in the background",
  "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
  "aspect_ratio": "16:9",
  "resolution": "768P",
  "duration": 6
}'

Response

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3-fast",
  "endpoint": "minimax/h3-fast/image-to-video",
  "mode": "image-to-video",
  "status": "queued",
  "input": {
    "prompt": "The flower opens slowly in the morning light, birdsong in the background",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "reference",
    "list_price_label": "Official MiniMax H3 API",
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3-fast",
  "endpoint": "minimax/h3-fast/image-to-video",
  "mode": "image-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "The flower opens slowly in the morning light, birdsong in the background",
    "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "reference",
    "list_price_label": "Official MiniMax H3 API",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

MiniMax H3 Fast Reference to Video API

POST/api/v1/run/minimax/h3-fast/reference-to-video

Submits an asynchronous job and returns 202 with a generation id. Poll GET /api/v1/generations/{id} or pass webhook_url. See job lifecycle.

Input parameters

Name	Type	Description	Affects price
`prompt`required	string	Describe the shot: subject, action, camera movement, lighting and style.	No
`reference_image_urls`	string[] (URLs)	Up to 9 images for characters, products, style or scene. Refer to them as @Image1, @Image2… The first 5 are included; each extra image adds a small fee. Max items: 9	No
`reference_video_urls`	string[] (video URLs)	Up to 3 MP4/MOV clips for motion, camera moves or effects (2–15 s each, 15 s in total, ≤ 50 MB each). Refer to them as @Video1, @Video2… Reference-video seconds are billed like output seconds. Max items: 3	Yes
`reference_audio_urls`	string[] (audio URLs)	Up to 3 MP3/WAV clips for voice, music or sound (2–15 s each, 15 s in total, ≤ 15 MB each). Refer to them as @Audio1, @Audio2… Needs at least one reference image or video. Max items: 3	No
`aspect_ratio`	string (enum)	Output frame shape. Values: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 Default: 16:9	Yes
`resolution`	string (enum)	Output resolution. Higher resolutions cost more per second. Values: 480P · 768P Default: 768P	Yes
`duration`	integer	Length of the generated clip in seconds (4–15s). You pay per second. Range: 4–15s Default: 6	Yes
`seed`	integer	Use the same seed and settings to reproduce a result. Leave empty for random.	No
`enable_safety_checker`	boolean	If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way. Default: true	No
`webhook_url`	string (URL)	Optional. We POST the finished generation here, signed with your webhook secret. Webhooks	No

Request

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/minimax/h3-fast/reference-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "The singer from @Image1 performs on the rooftop, following the camera move in @Video1, with the vocals from @Audio1",
    "reference_image_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "reference_audio_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp3"
    ],
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);

import os, time, requests

API = "https://cheapergen.com/api/v1"
headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}

# 1. Submit the job
job = requests.post(f"{API}/run/minimax/h3-fast/reference-to-video", headers=headers, json={
    "prompt": "The singer from @Image1 performs on the rooftop, following the camera move in @Video1, with the vocals from @Audio1",
    "reference_image_urls": [
        "https://cdn.cheapergen.com/samples/reference-1.jpg"
    ],
    "reference_video_urls": [
        "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "reference_audio_urls": [
        "https://cdn.cheapergen.com/samples/reference-1.mp3"
    ],
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
}).json()

# 2. Poll until it finishes (or pass "webhook_url" and skip polling)
while job["status"] in ("queued", "running"):
    time.sleep(3)
    job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()

print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

curl -X POST https://cheapergen.com/api/v1/run/minimax/h3-fast/reference-to-video \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "The singer from @Image1 performs on the rooftop, following the camera move in @Video1, with the vocals from @Audio1",
  "reference_image_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.jpg"
  ],
  "reference_video_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.mp4"
  ],
  "reference_audio_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.mp3"
  ],
  "aspect_ratio": "16:9",
  "resolution": "768P",
  "duration": 6
}'

Response

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3-fast",
  "endpoint": "minimax/h3-fast/reference-to-video",
  "mode": "reference-to-video",
  "status": "queued",
  "input": {
    "prompt": "The singer from @Image1 performs on the rooftop, following the camera move in @Video1, with the vocals from @Audio1",
    "reference_image_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "reference_audio_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp3"
    ],
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  },
  "output": null,
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": true,
    "official_usd": null,
    "list_price_source": "reference",
    "list_price_label": "Official MiniMax H3 API",
    "saved_usd": null
  },
  "source": "api",
  "started_at": null,
  "completed_at": null,
  "urls": {
    "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4",
    "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4/cancel"
  },
  "created_at": "2026-10-15T09:21:04Z"
}

{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "minimax/h3-fast",
  "endpoint": "minimax/h3-fast/reference-to-video",
  "mode": "reference-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "The singer from @Image1 performs on the rooftop, following the camera move in @Video1, with the vocals from @Audio1",
    "reference_image_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.jpg"
    ],
    "reference_video_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp4"
    ],
    "reference_audio_urls": [
      "https://cdn.cheapergen.com/samples/reference-1.mp3"
    ],
    "aspect_ratio": "16:9",
    "resolution": "768P",
    "duration": 6
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "reference",
    "list_price_label": "Official MiniMax H3 API",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}

Get the result

Generations are asynchronous. Poll until status is succeeded, failed or canceled — or pass webhook_url when you submit. Failed generations are refunded automatically.

curl https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4 \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY"

More: job lifecycle · webhooks · errors

MiniMax H3 Fast pricing

Pay per second of video as you go, with no subscription required. Failed generations are refunded automatically.

Tier	Official MiniMax H3 API	CheaperGen	You save
480P per second · audio included · vs. MiniMax H3 Max 480P	~~$0.05~~/s	$0.0369/s With a monthly plan: Pro $0.0352Max $0.0335	−26%
768P per second · audio included · vs. MiniMax H3 768P	~~$0.08~~/s	$0.0546/s With a monthly plan: Pro $0.0518Max $0.049	−32%

Monthly plans lower prices on most models (shown under each price); you can still pay as you go. Pro $499/month · Max $4,999/month.

Official MiniMax H3 API: MiniMax's official H3 API price at the same resolution, platform.minimax.io (MiniMax sells no H3 Fast, so this is the reference: MiniMax H3 768P $0.08 / s; at 480P, MiniMax H3 Max 480P $0.05 / s, MiniMax's only official 480P H3 tier). Prices verified October 18, 2026.
Reference-to-video: reference-video seconds are billed like output seconds; the first 5 reference images are included, each extra image adds about one second's price; first / last frames and reference audio are free.
Accelerated variant: the struck-through price is the official MiniMax H3 API price at the same resolution (H3 at 768P, H3 Max at 480P). MiniMax has no price for H3 Fast itself.