跳到导航
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.

身份验证

AuthorizationBearer

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

请求头

Idempotency-Keystring可选<=255 characters

请求

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

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

promptstring必需1-5000 characters
Video generation instructions.
imageslist of strings可选

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 strings可选
Public HTTPS image references for multimodal reference generation.
reference_videoslist of strings可选
Public HTTPS video references for multimodal reference generation. Available at 768P and 2K only.
reference_audioslist of strings可选
Public HTTPS audio references for multimodal reference generation. Audio also requires at least one reference image or video.
durationinteger可选4-15默认为 5
Requested output duration in seconds.
aspect_ratioenum可选

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.

resolutionenum可选默认为 768P
Output resolution tier. The explicit Fast H3 contract exposes 768P and 2K.
允许的值:

响应

Video generation task accepted

错误

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