Skip to main content
POST
Generate video with MiniMax H3 Max

Authorizations

Authorization
string
header
required

API key as a bearer token: Authorization: Bearer bpx_live_xxx

Body

application/json
prompt
string
required

Text description of the video. In reference mode, address assets by order: "Image 1", "Video 1", "Audio 1". When extending, describe what happens next, not the source.

aspect_ratio
enum<string>

Aspect ratio. Text-to-video uses it directly; image-to-video follows the frame image and ignores it; reference-to-video also accepts "adaptive" (the default there); extension accepts "auto" (follow the source — the default there) or a ratio to crop to. Defaults: 16:9 for text-to-video.

Available options:
16:9,
9:16,
1:1,
4:3,
3:4,
21:9,
adaptive,
auto
audio
string

Optional soundtrack (≥2s, ≤15MB, MP3/WAV) pinned to a text-to-video or image-to-video output: it replaces the generated audio, trimmed to the video length. Provide a public audio URL or an uploaded-file URL from POST /v1/uploads. Not available with reference media or video.

end_image
string

Optional last frame. With image the video interpolates between the two frames; on its own it is an end-keyframe generation. Same input forms as image.

image
string

Optional first frame for image-to-video — the output follows its framing. Provide a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. Can't be combined with reference media or video.

length_seconds
integer
default:5

Output length in seconds (5-15). When extending, the seconds of NEW footage appended to the source.

Required range: 5 <= x <= 15
reference_audios
string[]

Optional reference audio clips (up to 3; each 2-15s, 15s combined; WAV/MP3) for sound/voice guidance, addressed as "Audio 1"… Each item is a public audio URL or an uploaded-file URL from POST /v1/uploads. Free. Can't be combined with image/end_image.

Maximum array length: 3
reference_images
string[]

Optional reference images (up to 5) for subjects/style in reference-to-video mode, addressed in the prompt as "Image 1", "Image 2"… The first two are free; each additional image adds 50 credits. Each item is a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. Can't be combined with image/end_image.

Maximum array length: 5
reference_videos
string[]

Optional reference video clips (up to 3; each 2-15s, 15s combined; MP4/MOV, ≤50MB each) for motion/identity guidance, addressed as "Video 1"… Each item is a public video URL or an uploaded-file URL from POST /v1/uploads (passed by URL, not inlined). Billed at 170 credits per second of INPUT on top of the output — estimate via POST /v1/cost. Can't be combined with image/end_image.

Maximum array length: 3
resolution
enum<string>
default:768p

Output resolution. Pricing varies by resolution — see resolution_pricing in GET /v1/models. 2k is only available when extending a video.

Available options:
480p,
768p,
1080p,
2k
seed
integer

Seed for reproducible generation. Omit for random.

video
string

Optional video to EXTEND (1.6-60s, ≤50MB, aspect ratio between 2:5 and 5:2). The model continues it for length_seconds of new footage guided by prompt, and the output is the source followed by the continuation. Provide a public video URL or an uploaded-file URL from POST /v1/uploads. Can't be combined with any other media input. The source is billed at 170 credits per second (first 15 seconds) — estimate via POST /v1/cost.

Response

Job accepted.

id
string

Opaque job id — use it to poll status.

message
string
model
string
status
enum<string>

Lifecycle state. succeeded/failed/timeout are terminal.

Available options:
pending,
starting,
processing,
completing,
succeeded,
failed,
timeout