MiniMaxvideoAccelerated

MiniMax H3 Fast Reference to Video API

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

Reference to Video with MiniMax H3 Fast by MiniMax. MiniMax H3 in seconds, not minutes — an accelerated build of the open weights.

minimax/h3-fast/reference-to-video

FromUp to −32%

$0.037/s$0.05vs. official MiniMax H3 API

per second of video · 480P

With Max: from $0.034/s →Operational99.91% uptime (30 days)median 14s

Create with MiniMax H3 Fast Get API key

API docs →Compare models →

Try MiniMax H3 Fast Reference to Video

Prompt*

Type @ to point at a reference image, video, or audio0/5000

Reference images

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.

Reference videos

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.

Reference audio

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.

Aspect ratio

Output frame shape.

Resolution

Output resolution. Higher resolutions cost more per second.

Duration

Length of the generated clip in seconds (4–15s). You pay per second.

Enable Safety Checker

Always on here. Set enable_safety_checker to false over the API to turn it off.

If set to true, the safety checker will be enabled. Content our Acceptable Use Policy prohibits stays blocked either way.

Estimated cost…

Create a free account with Google or email — pay only for what you generate.

Your video will appear here

Write a prompt, pick your settings and hit Run. You only pay for successful generations.

Also available: MiniMax H3 Fast Text to Video · MiniMax H3 Fast Image to Video

See the MiniMax H3 Fast examples and prompts

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"
}

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.