minimax/h3-max/text-to-video
H3 Max by MiniMax - generate cinematic videos from text descriptions with AI. Create high-quality video content with natural motion, camera control, and optional audio generation.
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runminimax/h3-max/text-to-videoInput Schema
6 parameters · 1 required · 5 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt | string | Required | Text prompt for video generation · Min length: 1 · Max length: 50000 |
seed | integer | Optional | Random seed. A random seed is selected when omitted. |
duration | integer | Optional | The duration of the video in seconds. · Min: 5 · Max: 15 · Default: 5 |
resolution | string | Optional | The native generation resolution of the video. · Options: 480P, 768P · Default: "768P" 480P768P |
aspect_ratio | string | Optional | The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16 |
prompt_expansion_mode | string | Optional | How much effort to spend rewriting the prompt before generation. 'balanced' returns in about a second. 'quality' spends up to ~30s on a richer prompt. · Default: "balanced" |
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Async Workflow
This model uses asynchronous execution. Submit a request and poll for the result.
- Submit — POST to /v1/run, receive an
id - Poll — GET /v1/run/{id} until status is
completed,failed, ortimeout - Retrieve — Read
outputsfrom the completed response
Code Examples
Ready-to-run snippets
# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "minimax/h3-max/text-to-video",
"prompt": "A white kitten chases a butterfly across a sunlit garden. Gentle camera tracking, natural movement, soft afternoon light filtering through the leaves.",
"duration": 5,
"resolution": "768P",
"prompt_expansion_mode": "balanced"
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
MiniMax H3 Max Text to Video
Generate cinematic videos directly from text with MiniMax H3 Max, a fal post-trained H3 variant optimized for stronger prompt adherence, visual quality, and inference throughput.
The endpoint supports 5–15 second video at 480P or 768P, ten aspect ratios, deterministic seeds, and balanced or quality prompt expansion.
Pricing
Current fal promotional rates are $0.0125 per second at 480P and $0.02 per second at 768P through September 7, 2026. Completed-task duration is used when available; otherwise the requested duration is used.
Technical Specs
- Model ID:
minimax/h3-max/text-to-video - Required input:
prompt - Duration: 5–15 seconds; default 5
- Resolution:
480Por768P; default768P - Aspect ratios:
21:9,16:9,3:2,4:3,5:4,1:1,4:5,3:4,2:3,9:16 - Prompt expansion:
balancedorquality - Output: downloadable video URL
- Execution: asynchronous