ナビゲーションにスキップ
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