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