MiniMax H3 Max Turbo API

Half-price, faster MiniMax H3 Max: 5–15 s clips with first/last frame and a driving soundtrack.

MiniMax·VideoAvailable

from$0.015/ second$0.01610% off

Model IDminimax-h3-max-turbo

text-to-videoimage-to-videofast

Input

Text · Image · Audio

Output

Video

Provider

2 providers

Duration (s)

5 – 15

Resolution

480p · 768p · 1080p

Aspect ratio

16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9

MiniMax H3 Max Turbo pricing

Prices are per unit; requests without a provider are routed to the cheapest provider that supports your parameters.

Modes
Text-to-Video
Standard
from $0.015 / second
2 providers
Image-to-Video
First / last frame
from $0.015 / second
2 providers
Option480p768p1080p
Text-to-Video
Standard
$0.015 / second
2 Credits$0.01610% off
$0.023 / second
3 Credits$0.02610% off
$0.047 / second
5 Credits$0.05210% off
Image-to-Video
First / last frame
$0.015 / second
2 Credits$0.01610% off
$0.023 / second
3 Credits$0.02610% off
$0.047 / second
5 Credits$0.05210% off

Try MiniMax H3 Max Turbo before you integrate

Test output quality, compare provider prices and estimate cost before writing any code.

Provider
Video
Estimated cost$0.1310% off12 credits$0.1170

Input

prompt
audio_url
duration
resolution
aspect_ratio

Estimates use the current price catalog; prices are checked again on submission. Automatic routing may select another provider. Usage-based tasks settle after completion.

Result

Idle
Your generation will appear here.

Provider estimates for this request

MiniMax H3 Max Turbo API reference

Endpoints, request fields and runnable examples for this model.

Base URL

https://01router.com/api/v1
llms.txt

Quick start

Set API_KEY to your project key, then run a sample from your server. Replace example media URLs with your own public URLs.

Auto-routing chooses a provider that supports the request. Select a provider to see its input constraints and pinned request examples.

curl https://01router.com/api/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "minimax-h3-max-turbo",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "duration": 5,
    "resolution": "768p",
    "aspect_ratio": "16:9"
  }
}
JSON

# Replace GENERATION_ID with the id returned above; poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/GENERATION_ID -H "Authorization: Bearer $API_KEY"

Endpoints

Only endpoints relevant to this model are listed. Paths below include /api/v1. Click an endpoint to read its usage.

Authentication

Send your API key as a Bearer token. Requests are billed to the key owner's credits.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Get an API key

Input

Send JSON with Content-Type: application/json. Model parameters belong inside input; model, provider and callback_url are top-level fields.

Request body

NameTypeRequiredDescription
modelstringYes"minimax-h3-max-turbo"
providerstringNoPin a provider; omit to auto-route to the cheapest. One of: fal | atlascloud
inputobjectYesModel parameters, see the input fields below.
callback_urlstringNoOptional public HTTPS webhook URL. The final task result is signed and delivered here; polling remains available.

input · input fields

Required fields are marked explicitly. Other fields use the listed defaults when omitted.

NameTypeRequiredValuesDefault
prompt*stringYes——
image_url
Optional start image (image-to-video)
stringNo——
end_image_urlstringNo——
audio_url
Audio the video follows (2–15 s)
stringNo——
durationintegerNomin: 5 · max: 155
resolutionstringNo480p | 768p | 1080p768p
aspect_ratiostringNo16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:916:9
Callbacks →

Output

Creating a task does not mean generation has finished. Keep its id, poll until succeeded or failed, then read outputs or error. Amounts below are illustrative; actual charges depend on the request.

queued→processing→succeeded / failed

Task submitted

{
  "id": "gen_example",
  "object": "generation",
  "model": "minimax-h3-max-turbo",
  "type": "video",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "duration": 5,
    "resolution": "768p",
    "aspect_ratio": "16:9"
  },
  "outputs": [],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}

Task completed

{
  "id": "gen_example",
  "object": "generation",
  "model": "minimax-h3-max-turbo",
  "type": "video",
  "provider": "fal",
  "status": "succeeded",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "duration": 5,
    "resolution": "768p",
    "aspect_ratio": "16:9"
  },
  "outputs": [
    "https://example.com/output.mp4"
  ],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": "2026-10-25T08:01:00.000Z"
}

Response fields

NameTypeRequiredDescription
idstringYesGeneration ID. Use it to query or cancel this task.
objectstringYesgeneration
modelstringYesminimax-h3-max-turbo
typestringYesvideo
providerstringYesProvider
statusstringYesqueued → processing → succeeded / failed. Stop polling at either terminal state.
inputobjectYesModel parameters, see the input fields below.
outputsstring[]YesResult URLs. Empty while processing; read after succeeded and save the files promptly.
errorstring | nullYesFailure reason, or null when no failure is reported.
creditsnumberYesCredits charged for this request.
price_usdnumberYesRequest price in USD.
created_atstringYesCreation time in ISO 8601 format.
completed_atstring | nullYesCompletion time in ISO 8601 format; null before completion.

Get the result

Poll every few seconds until status is succeeded or failed. Output URLs are provider-hosted and may expire — download them promptly. Or pass callback_url to get the result pushed.

curl "https://01router.com/api/v1/generations/GENERATION_ID" \
  -H "Authorization: Bearer $API_KEY"

queued → processing → succeeded / failed. Stop polling at either terminal state. Result URLs. Empty while processing; read after succeeded and save the files promptly.

Cancel a task

Cancellation depends on provider support and task state. A confirmed cancellation returns status: failed and error: Canceled by user. Unsupported or completed tasks return 409 not_cancelable.

curl -X POST "https://01router.com/api/v1/generations/GENERATION_ID/cancel" \
  -H "Authorization: Bearer $API_KEY"

Quote

Choose API quotes or frontend quotes: the API returns costs for currently available providers; frontend quotes read prices and billing fields from models and recalculate locally when inputs change.

curl "https://01router.com/api/v1/quote" -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "minimax-h3-max-turbo",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "duration": 5,
    "resolution": "768p",
    "aspect_ratio": "16:9"
  }
}
JSON

Prompt API

Public read-only endpoints: no API key or credits required. Browse published examples for active models using combined model, source and scene filters.

curl "https://01router.com/api/v1/prompts?model=minimax-h3-max-turbo&locale=en&page=1"
curl "https://01router.com/api/v1/prompts/PROMPT_ID?locale=en"

Use modelSlug and prompt to construct the request body below for POST /generations. Generation still requires an API key and incurs model charges. Query GET /models/minimax-h3-max-turbo for any additional required inputs.

Model schema

This public endpoint returns the model parameters and each provider’s supported constraints and prices.

curl "https://01router.com/api/v1/models/minimax-h3-max-turbo"

Errors

Check the HTTP status and error.message. Fix the request before retrying validation or authentication errors. A failed generation is reported in status and error on the task itself.

{
  "error": {
    "message": "Invalid or missing API key",
    "code": "unauthorized"
  }
}

400Invalid body or parameter value

401Missing or invalid API key

402Not enough credits

404Unknown model or generation

409The task cannot be canceled (already finished, or the provider does not support canceling)

429Too many requests — retry after the given seconds

502Every provider rejected the task (credits refunded)

Auth, routing, billing and error codes are covered in →

Use with AI

Give your coding assistant this model reference: endpoints, input constraints, output fields and request examples in plain text.

Open llms.txt

How does MiniMax H3 Max Turbo compare?

Specs and starting prices side by side. Test with the same prompt before you choose.

MiniMax H3 Max TurboMiniMax H3 MaxMiniMax H3Grok Imagine Video 1.5
VendorMiniMaxMiniMaxMiniMaxxAI
Starting price$0.015 / second$0.029 / second$0.036 / second$0.011 / second
InputText · Image · AudioText · Image · AudioText · Image · Video · AudioText · Image
Provider2 providers6 providers8 providers10 providers
Duration (s)5 – 155 – 155 – 151 – 15
Resolution480p · 768p · 1080p480p · 768p · 1080p768p · 2k480p · 720p · 1080p
Aspect ratio16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:916:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:916:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:916:9 · 4:3 · 3:2 · 1:1 · 2:3 · 3:4 · 9:16

Related models

Other models you can call with the same API key.