跳到导航
BeatAPIMinimax H3 NormalVideo API

MiniMax H3 Normal

Slower MiniMax H3 generation at half the Fast price. Generate 3–15 second videos with native audio at 480p, 768p, or 1080p.

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, reference_images and/or reference_videosDo not combine images with reference_* inputs.

Normal versus Fast: Normal has a longer processing wait and costs half of Fast at matching resolution and duration: USD 0.0175/s at 480p, USD 0.02/s at 768p, and USD 0.025/s at 1080p. The original minimax-h3 ID remains Fast; minimax-h3-fast is its explicit alias. Normal accepts at most two frame images OR up to four reference images and one reference video. It does not accept audio input, adaptive aspect ratio, 2K, or 4K. Output includes native audio with no audio-off switch. Optional seed must be an integer from 0 to 9007199254740991. Do not confuse speed tiers with a quality parameter: no quality field is exposed here.

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-normal"必需

Must be minimax-h3-normal.

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

One first-frame image or first- and last-frame images in order. Cannot be combined with reference_images or reference_videos.

reference_imageslist of strings可选
Up to four public HTTPS reference images, optionally combined with one reference video. Cannot be combined with images.
reference_videoslist of strings可选
One public HTTPS reference video, optionally combined with up to four reference images. Cannot be combined with images.
durationinteger可选3-15默认为 5
Requested output duration in whole seconds.
aspect_ratioenum可选默认为 16:9
Output aspect ratio. Adaptive is not supported.
resolutionenum可选默认为 768p
Normal output resolution. This model does not offer 2K or 4K.
允许的值:
seedinteger可选0-9007199254740991
Optional integer generation seed from 0 to 9007199254740991. Omit for a random seed.

响应

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