Want MiniMax H3 videos in your own app, script or automation? This guide shows how to make them with the AiWings API, step by step. You use one AiWings key, pay per second of video from your AiWings credits, and get back a permanent link to every MP4. It takes about five minutes from no account to a finished video, and the same key also covers Seedance video and a range of image models.
What you need
- An AiWings account. Sign in with Google; new accounts get 10 free credits, enough for a 5-second MiniMax H3 Lite video at 480p.
- An AiWings API key, which you create in the next step.
- Somewhere to run code on a server: a script, a backend route, a serverless function or an automation tool that can send HTTP requests. Keys don’t work from browser or mobile app code, where anyone could read them.
Step 1: Create an API key
- 1Sign in to AiWings and open the API page in your dashboard.
- 2Click Create key, give it a name (for example “my-app production”) and, if you like, a monthly credit limit.
- 3Copy the key. It starts with aiw_live_ and is shown only once.
- 4Save it as an environment variable on the machine or service that will call the API.
export AIWINGS_API_KEY="aiw_live_your_key_here"The API uses the same credits as AiWings in ChatGPT, Claude and the dashboard, so there’s no separate plan to buy. Every request sends the key in the Authorization header as a Bearer token.
Step 2: Choose a MiniMax H3 model
Pick the version with the model field. All three make videos with sound, from text or from an image, and are billed per second:
| Model | model value | Resolutions | Length | 5 seconds from | Best for |
|---|---|---|---|---|---|
| MiniMax H3 Lite | minimax-h3-lite | 480p, 768p | 4–15 seconds | 10 credits ($0.10) | The lowest price, for testing and volume |
| MiniMax H3 Highspeed | minimax-h3-highspeed | 768p | 4–15 seconds | 20 credits ($0.20) | Fast drafts and everyday clips |
| MiniMax H3 | minimax-h3 | 768p, 2K | 4–15 seconds | 50 credits ($0.50) | Polished final cuts, up to 2K |
Prices are at the top-up rate of $0.01 per credit, and plans include more credits per dollar. Each finished video reports exactly what it cost in its credits field, and GET /v1/models lists every price.
H3 Lite and H3 Highspeed are on a launch price until Dec 31. From January 1, H3 Lite is 4 credits per second at 480p and 6 at 768p, and H3 Highspeed is 8 credits per second at 768p.
Step 3: Make your first video
Send a POST request to /v1/videos with a prompt and the model you picked. This one makes a 5-second vertical clip with MiniMax H3 Lite at 480p, which costs 10 credits ($0.10):
1# 1. Start the job2curl https://aiwings.io/api/v1/videos \3-H "Authorization: Bearer $AIWINGS_API_KEY" \4-H "Content-Type: application/json" \5-d '{6"prompt": "A paper boat sails down a rainy street at night, streetlights reflecting in the puddles, with the sound of rain and distant traffic",7"model": "minimax-h3-lite",8"resolution": "480p",9"duration": 5,10"aspect_ratio": "9:16"11}'1213# 2. Check it until status is "succeeded" (or "failed")14curl "https://aiwings.io/api/v1/videos/VIDEO_ID?wait=30" \15-H "Authorization: Bearer $AIWINGS_API_KEY"
Creating a video returns right away with an id and status "processing". Videos usually take one to a few minutes, so you check back with GET /v1/videos/{id}. Adding ?wait=30 holds each check open for up to 30 seconds and returns the moment the video is ready, so the loop above makes only a handful of requests.
When status is "succeeded", output.url is a permanent link to the MP4. If a video fails, status is "failed", error.message says why, and the credits are refunded automatically. Every video you make through the API also shows up in your AiWings library.
Step 4: Animate an image
To bring a still image to life, pass a public image URL as first_frame and describe only the motion. You can also add last_frame, and MiniMax moves from the first picture to the second. Already made the image with AiWings? Pass its id as source_generation_id instead of a URL.
1# 1. Start the job2curl https://aiwings.io/api/v1/videos \3-H "Authorization: Bearer $AIWINGS_API_KEY" \4-H "Content-Type: application/json" \5-d '{6"prompt": "Slow camera push-in, steam rising from the cup, soft cafe sounds",7"model": "minimax-h3",8"resolution": "768p",9"duration": 6,10"first_frame": "https://example.com/coffee-cup.jpg"11}'1213# 2. Check it until status is "succeeded" (or "failed")14curl "https://aiwings.io/api/v1/videos/VIDEO_ID?wait=30" \15-H "Authorization: Bearer $AIWINGS_API_KEY"
When you give MiniMax H3 or H3 Highspeed a first frame, the video takes the shape of your image, so you don’t need to set aspect_ratio. To guide the look without fixing the first frame, send up to 9 reference_images instead and mention them in the prompt as [Image1], [Image2] and so on.
Step 5: Draft in Lite, finish in H3
The three versions share the same request, so you can test cheaply and only pay the higher price for the clip you keep. Run a few short drafts with MiniMax H3 Lite, then send the winning prompt again with MiniMax H3 at a higher resolution. Only these two fields change:
Draft: "model": "minimax-h3-lite", "resolution": "480p" (10 credits ($0.10) for 5 seconds)
Final: "model": "minimax-h3", "resolution": "2k" (85 credits ($0.85) for 5 seconds)See what MiniMax can make
Real, unedited 15-second videos made with MiniMax H3 at 768p, each from a single prompt. MiniMax adds sound too; it is muted here.
More models with the same key
Your key isn’t limited to MiniMax H3. The same key, balance and request format cover every video and image model on AiWings. To switch, change the model field: video models go to POST /v1/videos and image models to POST /v1/images.
| Model | model value | Endpoint | From |
|---|---|---|---|
| Seedance 2.0 | seedance-2.0 | /v1/videos | 50 credits ($0.50) for 5 seconds at 480p |
| Seedance 2.5 | seedance-2.5 | /v1/videos | 65 credits ($0.65) for 5 seconds at 480p |
| MiniMax H3 | minimax-h3 | /v1/videos | 50 credits ($0.50) for 5 seconds at 768p |
| MiniMax H3 Highspeed | minimax-h3-highspeed | /v1/videos | 20 credits ($0.20) for 5 seconds at 768p |
| MiniMax H3 Lite | minimax-h3-lite | /v1/videos | 10 credits ($0.10) for 5 seconds at 480p |
| GPT Image 2.6 Flare | gpt-image-2.6-flare | /v1/images | 7 credits ($0.07) per image |
| GPT Image 2.6 Sunburst | gpt-image-2.6-sunburst | /v1/images | 7 credits ($0.07) per image |
| GPT Image 2.5 Flare | gpt-image-2.5-flare | /v1/images | 2 credits ($0.02) per image |
| GPT Image 2.5 Sunburst | gpt-image-2.5-sunburst | /v1/images | 2 credits ($0.02) per image |
| GPT Image 2 | gpt-image-2 | /v1/images | 2 credits ($0.02) per image |
| GPT Image 1.5 | gpt-image-1.5 | /v1/images | 2 credits ($0.02) per image |
| Nano Banana | nano-banana | /v1/images | 5 credits ($0.05) per image |
| Nano Banana 2 | nano-banana-2 | /v1/images | 8 credits ($0.08) per image |
| Nano Banana Pro | nano-banana-pro | /v1/images | 19 credits ($0.19) per image |
| Seedream 5 Lite | seedream-5-lite | /v1/images | 5 credits ($0.05) per image |
| Grok Imagine | grok-imagine | /v1/images | 3 credits ($0.03) per image |
| Flux Fast | flux-fast | /v1/images | 1 credit ($0.01) per image |
GET /v1/models returns the same list with every price, size and option, so your code can check what’s available instead of hard-coding it.
Things to know
- MiniMax always adds sound to its videos, so the audio field has no effect. Describe what you want to hear in the prompt, and mute the video in your player if you don’t need it.
- Videos can be 4 to 15 seconds. For longer one-take stories, write the beats with timestamps in the prompt (0–3s, 3–6s and so on).
- Aspect ratios: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9.
- Send an Idempotency-Key header with each new job (the JavaScript and Python examples do). If a request times out and you retry with the same key, you get the same job back instead of paying twice.
- Each key has its own rate limit, and you can give each key a monthly credit cap so a bug in one app can’t spend your whole balance.
- Output URLs are public but unguessable, like a share link. Download the file to your own storage if you need to control who can see it.
If something goes wrong
- 401 authentication_failed: the key is missing, mistyped or revoked. Check the Authorization header reads Bearer followed by your key.
- 400 invalid_request: a field isn’t allowed for that model, for example a resolution or length it doesn’t support. The error’s param names the field to fix.
- 402 insufficient_credits: your balance can’t cover the video. Top up in the dashboard and send the request again.
- 403 spend_limit_reached: this key hit its monthly credit limit. Raise or remove the limit on the API page.
- 429 rate_limited or too_many_jobs: you’re sending too fast or have too many jobs rendering at once. Wait for the Retry-After time, or for a video to finish.
- The video failed with a content error: the prompt or image was blocked by the model’s safety filter. Reword it; the credits were already refunded.
Bottom line
You don’t need a separate account with each model maker to put MiniMax H3 in your product. One AiWings key gives your code all three H3 versions, Seedance and the image models, billed from one balance, with permanent links and automatic refunds on failures. Prefer no code? The same models work in ChatGPT and Claude.
FAQ
Is this the official MiniMax API?
No. AiWings is an independent service that runs MiniMax H3 for you. You use an AiWings key and AiWings credits, with no MiniMax account or separate billing.
How much does a MiniMax H3 video cost through the API?
It’s billed per second. A 5-second clip is 10 credits ($0.10) with H3 Lite at 480p, 20 credits ($0.20) with H3 Highspeed at 768p, and 50 credits ($0.50) with MiniMax H3 at 768p. Failed videos are refunded.
How long does a video take?
Usually one to a few minutes. Your code starts the job and checks back with ?wait=30, which returns as soon as the video is ready.
Can I use it from n8n, Make or Zapier?
Yes, any tool that can send an HTTP request works. Send the POST request from Step 3, then check the video with a GET request until its status is succeeded.
Can the same key make images?
Yes. POST /v1/images makes images with GPT Image, Nano Banana, Seedream, Flux and more, from the same key and balance.
