MiniMax H3
MiniMax Hailuo H3 with native 768p and 2K output, 4–15 s, first/last frame.
Model ID: minimax-h3
Playground
5 – 15
Use the same request from code — API docs
Provider prices for this request
Enter a prompt to compare provider prices.
Result
Your generation will appear here.
Pricing by provider
Prices are per unit; requests without a provider are routed to the cheapest provider that supports your parameters.
| Provider | Option | Price (USD) | Credits |
|---|---|---|---|
| fal.ai | resolution: 2k | 30 / second | |
| resolution: 768p | 14 / second | ||
| Replicate | resolution: 2k | 30 / second | |
| resolution: 768p | 18 / second | ||
| WaveSpeedAI | resolution: 768p | 23 / second | |
| resolution: 2k | 32 / second | ||
| KIE AI | resolution: 768p | 9 / second | |
| resolution: 2k | 15 / second | ||
| APIMart | resolution: 2k | 21 / second | |
| resolution: 768p | 13 / second | ||
| Vercel AI Gateway | resolution: 768p | 18 / second | |
| resolution: 2k | 30 / second |
API reference
Endpoints
Base URL: https://01router.com/api/v1
/generationsCreate a generation (charges credits)/generations/{id}Get a generation; polls the provider while running/quotePrice a request on every provider (no charge, no key needed)Authentication
Send your API key as a Bearer token. Requests are billed to the key owner's credits.
Authorization: Bearer sk_xxxxxxxxxxxxxxxxRequest body
| Name | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | "minimax-h3" |
| provider | string | No | Pin a provider; omit to auto-route to the cheapest. One of: fal | replicate | wavespeed | kie | apimart | vercel |
| input | object | Yes | Model parameters, see the input fields below. |
input fields
Unified parameters work on every provider; some providers support a narrower range — check the quote endpoint or the playground.
| Name | Type | Values | Default |
|---|---|---|---|
| prompt* | text | — | — |
| image_url Optional start image (image-to-video) | image | — | — |
| end_image_url | image | — | — |
| duration | integer | 5 – 15 | 5 |
| resolution | enum | 768p | 2k | 768p |
| aspect_ratio | enum | 16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:9 | 16:9 |
Example request
curl https://01router.com/api/v1/generations \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "minimax-h3",
"provider": "fal",
"input": {
"prompt": "A cinematic shot of a red fox running through snow",
"duration": 5,
"resolution": "768p",
"aspect_ratio": "16:9"
}
}'
# poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/<id> -H "Authorization: Bearer $API_KEY"Response
Pass the model id, its unified input parameters and optionally a provider slug. The response returns immediately with the task id; image models on synchronous providers may already be succeeded.
{
"id": "gen_6f1c…",
"object": "generation",
"model": "minimax-h3",
"type": "video",
"provider": "fal",
"status": "processing",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "768p",
"aspect_ratio": "16:9"
},
"outputs": [],
"error": null,
"credits": 0,
"price_usd": 0,
"created_at": "2026-10-23T08:00:00.000Z",
"completed_at": null
}Get the result
Poll every few seconds until status is succeeded or failed. Output URLs are provider-hosted and may expire — download them promptly.
curl https://01router.com/api/v1/generations/gen_6f1c… -H "Authorization: Bearer $API_KEY"
{ "id": "gen_6f1c…", "model": "minimax-h3", "status": "succeeded", "outputs": ["https://…"], … }Quote
Same body as creating a generation. Returns every available provider sorted by price, plus the ones that cannot serve the request and why.
curl https://01router.com/api/v1/quote -H "Content-Type: application/json" \
-d '{"model":"minimax-h3","input":{"prompt":"…","duration":5,"resolution":"768p","aspect_ratio":"16:9"}}'Auth, routing, billing and error codes are covered in Gateway API reference