Skip to navigation
BeatAPIMinimax H3 FastVideo API

MiniMax H3 Fast

The explicit Fast alias of minimax-h3, with the same prices, input contract, and speed tier and 4–15 second output up to 2K.

Supported modes

ModeRequired inputRules
Text to videomodel, promptOmit all media arrays.
First framemodel, prompt, imagesProvide one image URL.
First and last framesmodel, prompt, imagesProvide two image URLs in first-to-last order.
Multimodal referencesmodel, prompt, one reference_* arrayDo not combine images with reference_* inputs.

The explicit Fast contract exposes 768P and 2K. The separate minimax-h3-normal model covers 480p, 768p, and 1080p at a slower half-price tier.

Async flow: Create the task, save data.id, then poll the Task with GET /v1/tasks/{task_id}. On succeeded, read data.output.media. On failed, read data.error_code and data.error_message, then follow the error and retry policy.

Using a local file? upload a local input first and pass the returned data.url.

Authentication

AuthorizationBearer

Send your API key as Authorization: Bearer <BEATAPI_API_KEY>.

Headers

Idempotency-KeystringOptional<=255 characters

Request

This endpoint expects an object.
model"minimax-h3-fast"Required

Must be minimax-h3-fast. This is the explicit Fast alias of minimax-h3.

promptstringRequired1-5000 characters
Video generation instructions.
imageslist of stringsOptional

One first-frame image or first- and last-frame images as public HTTPS URLs. First and last frames need 768P or 2K.

reference_imageslist of stringsOptional
Public HTTPS image references for multimodal reference generation.
reference_videoslist of stringsOptional
Public HTTPS video references for multimodal reference generation. Available at 768P and 2K only.
reference_audioslist of stringsOptional
Public HTTPS audio references for multimodal reference generation. Audio also requires at least one reference image or video.
durationintegerOptional4-15Defaults to 5
Requested output duration in seconds.
aspect_ratioenumOptional

Text mode defaults to 16:9 and does not accept adaptive. Frame mode always uses adaptive at 768P and 2K. Reference mode defaults to adaptive and also accepts a concrete ratio.

resolutionenumOptionalDefaults to 768P
Output resolution tier. The explicit Fast H3 contract exposes 768P and 2K.
Allowed values:

Response

Video generation task accepted

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error