ナビゲーションにスキップ
BeatAPIMinimax H3Video API

MiniMax H3

The original MiniMax H3 model ID keeps the Fast speed tier, prices, and request contract. For half-price slower generation at 480p, 768p, or 1080p, use minimax-h3-normal.

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 legacy/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"必須

Must be 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 legacy/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