MiniMax-H3
minimax/MiniMax-H3Generate video from a text prompt or reference images.
- second
- Plan $0.056
- MiniMax
- 14 min
Overview
Generate video using the supplier configured for your account plan. The pricing table lists each resolution once with your price per second; unsupported resolutions are unavailable. Send provider minimax and endpoint MiniMax-H3. The quality parameter does not override your configured supplier. Supported durations and reference options depend on the configured supplier. Accepted tasks are checkpointed. If a run is RUNNING, poll GET /v1/runs/{runId}; after a network timeout, repeat the identical request with the same Idempotency-Key to recover it.
After COMPLETED, read run.output.video_url, run.output.duration and run.output.resolution. Duration reporting and whole-second billing follow your configured supplier. Download the temporary video URL promptly.
Input
These go in the input object of the run request.
| Field | Type | Required | Description |
|---|---|---|---|
| prompt | string | Yes | Describe the scene and movement. The maximum prompt length depends on the supplier configured for your account plan. |
| duration_s | number | No | Requested duration. Supported values and whole-second billing behavior follow your configured supplier. Default: 4Minimum: 3 Maximum: 15 |
| resolution | string | No | Output resolution. Availability follows your configured supplier; resolution spelling is case-insensitive. Allowed: 480p, 768p, 768P, 1080p, 2K, 4K |
| quality | string | No | Optional quality setting when supported by your configured supplier. This does not select a different supplier. Allowed: low, high |
| aspect_ratio | string | No | Output aspect ratio. Adaptive frame sizing is available when supported by your configured supplier. Allowed: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, adaptive Default: "1:1" |
| first_frame_image_url | string | No | HTTPS first frame image; cannot combine with reference images. |
| last_frame_image_url | string | No | HTTPS last frame image; cannot combine with reference images and may require a first frame. |
| reference_image_url | array | No | HTTPS reference images; the configured supplier determines the maximum count. Cannot combine with frame images. |
Requests up to 1 MB.
Example
Use your own API key and a saved idempotency key for each new job. Replace image or media placeholders with your own publicly reachable HTTPS URLs. Keep the same key and request body when recovering a timeout.
# Set once per job; reuse this key and the identical body after a timeout.
: "${AGENTSKY_IDEMPOTENCY_KEY:?Set a unique, saved key for this job}"
curl --fail-with-body https://gateway.agentsky.dev/v1/run \
-H "authorization: Bearer $AGENTSKY_API_KEY" \
-H "content-type: application/json" \
-H "Idempotency-Key: $AGENTSKY_IDEMPOTENCY_KEY" \
-d '{"provider":"minimax","endpoint":"MiniMax-H3","input":{"prompt":"A small blue sphere slowly rotates on a white background.","duration_s":4,"resolution":"768p"}}'
# If status is READY/RUNNING, poll GET /v1/runs/{runId} with the same API key.Pricing
Prices by resolution. Your account plan controls the supplier, availability, and price. Read the final customer charge from price.amount.value after the run finishes. A RUNNING response is not the final bill.
| Resolution | Availability | Reference | Plan price (USD per second) |
|---|---|---|---|
| 480p | Available | $0.08 | $0.056 |
| 768p (default) | Available | $0.08 | $0.056 |
| 1080p | Available | $0.08 | $0.056 |
| 2K | Available | $0.13 | $0.091 |
| 4K | Available | $0.20 | $0.14 |