MiniMax H3 · 2K AI video generator

MiniMax H3 APImade simple for 2K video creation

Create 4–15 second 2K videos from text or images. Use the online generator directly, or create a minimax3.com API key to connect MiniMax H3 to your own server or application.

Start generating View site pricing

2K output

4–15 seconds

Native audio

Private job history

Developer quickstart

Call the MiniMax H3 API in a few minutes

Verified customers can create a minimax3.com API key and use the same site credits from a server, script, or application. The API is asynchronous: create a task first, then poll its status until the video is ready.

Create an API key

1. Create a key

Open API Keys in your account and copy the secret when it is shown.

2. Submit a job

Send a POST request with a unique Idempotency-Key header.

3. Poll the result

Request the task URL about every 5 seconds until status changes to succeeded.

Endpoints

POST/api/v1/videos

Create a video task

GET/api/v1/videos/{task_id}

Get a task or list tasks

GET/api/v1/videos

Get a task or list tasks

GET/api/v1/videos/{task_id}/content

Download the finished video with the same Bearer API key

Default limits

5 create requests per minute
2 active video jobs per account
60 status requests per minute
Up to 3 active API keys

Working examples

Always send a unique Idempotency-Key when creating a video. Repeating the same request with the same key returns the original task without charging credits twice. The returned video_url is private, so include the same Bearer API key when downloading it.

cURL · Create a 2K video

curl -X POST https://minimax3.com/api/v1/videos \
  -H "Authorization: Bearer mmx_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: product-demo-001" \
  -d '{
    "model": "minimax-h3",
    "mode": "text-to-video",
    "prompt": "A cinematic product reveal with a slow camera move",
    "duration": 5,
    "aspect_ratio": "16:9",
    "resolution": "2K"
  }'

JavaScript · Create a 2K video

const response = await fetch('https://minimax3.com/api/v1/videos', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MINIMAX3_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
  },
  body: JSON.stringify({
    model: 'minimax-h3',
    mode: 'text-to-video',
    prompt: 'A cinematic product reveal with a slow camera move',
    duration: 5,
    aspect_ratio: '16:9',
    resolution: '2K',
  }),
});

const task = await response.json();
console.log(task.id, task.status);

Python · Create a 2K video

import os
import uuid
import requests

response = requests.post(
    "https://minimax3.com/api/v1/videos",
    headers={
        "Authorization": f"Bearer {os.environ['MINIMAX3_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "model": "minimax-h3",
        "mode": "text-to-video",
        "prompt": "A cinematic product reveal with a slow camera move",
        "duration": 5,
        "aspect_ratio": "16:9",
        "resolution": "2K",
    },
)

task = response.json()
print(task["id"], task["status"])

cURL · Check the task status

curl https://minimax3.com/api/v1/videos/TASK_ID \
  -H "Authorization: Bearer mmx_live_YOUR_API_KEY"

cURL · Download the finished video

curl -L https://minimax3.com/api/v1/videos/TASK_ID/content \
  -H "Authorization: Bearer mmx_live_YOUR_API_KEY" \
  --output minimax-h3.mp4

Request parameters

Field	Required	Description
model	Yes	Use minimax-h3.
mode	Yes	text-to-video, image-to-video, or reference-to-video.
prompt	Yes	Video description, up to 7,000 characters.
duration	No	Whole number from 4 to 15 seconds. Default: 5.
aspect_ratio	No	21:9, 16:9, 4:3, 1:1, 3:4, or 9:16.
resolution	No	2K.
image_url	By mode	HTTPS starting image URL for image-to-video.
last_frame_url	No	Optional HTTPS ending-frame URL.
reference_image_urls	By mode	Up to nine HTTPS reference-image URLs.

What you can create

What can you create with the MiniMax H3 API?

Choose the input that fits your idea. MiniMax H3 can build a scene from a prompt, animate an existing image, or use references to keep the look consistent.

Text to video

Describe the subject, action, camera, lighting, and sound. H3 turns those details into a complete video scene.

Image to video

Upload a starting image and tell H3 how the scene should move. You can also add an ending frame for more control.

Reference-guided creation

Add reference images when a character, product, composition, or visual style needs to stay recognizable.

How it works

How to use the MiniMax H3 API on this site

You focus on the creative choices. We handle the generation job, progress tracking, result storage, and eligible credit refunds in the background.

1. Prepare

Choose text or image mode and write the prompt.

2. Generate

Choose a 4–15 second duration and start your 2K video.

3. Track

Check the progress and finished video in My Creations.

4. Reuse

Download your video, refine the prompt, or explore more ideas.

Protected account access

Site credits with failed-job refunds

Prompt recipe

Tell H3 what the shot should feel like

A useful prompt combines subject, action, environment, camera, lighting, pacing, and sound. Keep the most important constraints early and avoid conflicting instructions.

A brushed-silver smartwatch rotates above a dark reflective table, slow dolly-in, soft violet rim light, premium product-film pacing, subtle mechanical ambience, 16:9.

MiniMax H3 API questions

Is MiniMax H3 available on minimax3.com?

Yes. You can create 2K text-to-video and image-to-video jobs with MiniMax H3, with durations from 4 to 15 seconds.

Do I need a separate model API key?

Website generation does not need an API key. Developers can create a minimax3.com API key from account settings and use the same site credits programmatically.

How much does the MiniMax H3 API cost?

On this site, H3 generations use credits based mainly on video duration. Check the pricing page before generating to see the current credit plans and choose the option that fits your usage.

Can I call a public developer endpoint?

Yes. Verified customers with a payment history can create an API key and call POST /api/v1/videos, then query GET /api/v1/videos/{task_id}.

What happens when a generation fails?

We record the failed job and automatically try to return the credits it used, according to the site credit rules.

Ready to make your first H3 video?

Write a prompt or upload an image, choose the length, and let H3 create the first version.

Open the H3 generator