BeatAPIMinimax H3Video API

MiniMax H3

Generate 4–15 second videos from text, first/last frames, or multimodal references, with output up to 2K. ### Supported modes | Mode | Required input | Rules | | --- | --- | --- | | Text to video | `model`, `prompt` | Omit all media arrays. | | First frame | `model`, `prompt`, `images` | Provide one image URL. | | First and last frames | `model`, `prompt`, `images` | Provide two image URLs in first-to-last order. | | Multimodal references | `model`, `prompt`, one `reference_*` array | Do not combine `images` with `reference_*` inputs. | **Async flow:** Create the task, save `data.id`, then [poll the Task](/quick-guide#get-task-status) 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](/quick-guide#errors-and-retry-policy). **Using a local file?** [upload a local input](/quick-guide#upload-an-input-file) 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.

reference_imageslist of strings可选
Public HTTPS image references for multimodal reference generation.
reference_videoslist of strings可选
Public HTTPS video references for multimodal reference generation.
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. Reference mode defaults to adaptive and also accepts a concrete ratio.

resolutionenum可选默认为 768P
Output resolution tier.

响应

Video generation task accepted

错误

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
409
Conflict Error
429
Too Many Requests Error