Skip to main content
POST
Minimax H3 Text-to-Video

Authorizations

Authorization
string
header
required

##All endpoints require Bearer Token authentication##

Get API Key:

Visit the API Key Management Page to obtain your API Key

Add to request header:

Body

application/json
model
enum<string>
default:minimax-h3-text-to-video
required

Video generation model name

Available options:
minimax-h3-text-to-video
Example:

"minimax-h3-text-to-video"

prompt
string
required

Describe the video you want to generate.

Prompt requirements:

  • Required and cannot be empty
  • Chinese and English are supported
  • We recommend no more than 500 Chinese characters or 1000 English words; the model may ignore some details in an overly long prompt

Input restrictions:

  • This is a text-to-video model and accepts text input only
  • image_start, image_end, image_urls, video_urls, and audio_urls are not supported
  • Supplying any of these media fields returns a parameter error
Minimum string length: 1
Example:

"Epic space-opera theatrical teaser: a female captain stands alone before a massive observation window as the last fleet gathers outside. The fleet jumps away in a blinding flash and the bridge shakes; when the light fades, she is left alone in silent deep space. Cinematic lighting, slow dolly-in, grand yet restrained mood."

duration
integer
default:5

Output video duration in seconds. Defaults to 5 seconds.

Value restrictions:

  • Only integers from 5 through 15, inclusive, are supported
  • Decimals, numeric strings, auto, and -1 are not supported
  • Output duration directly affects billing
Required range: 5 <= x <= 15
Example:

5

quality
enum<string>
default:2k

Output video resolution. Defaults to 2k.

Available value:

  • 2k: the only resolution currently supported

Notes:

  • 768p is not yet available and returns a parameter error
  • Output bitrate, frame rate, video codec, and audio codec are selected by the platform and are not configurable
Available options:
2k
Example:

"2k"

aspect_ratio
enum<string>
default:adaptive

Output video aspect ratio. Defaults to adaptive.

Available values:

  • adaptive: the model selects a suitable ratio from the prompt
  • 21:9: ultrawide
  • 16:9: landscape
  • 4:3: standard landscape
  • 1:1: square
  • 3:4: standard portrait
  • 9:16: portrait
Available options:
adaptive,
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
Example:

"adaptive"

callback_url
string<uri>

HTTPS callback URL for task completion

Callback timing:

  • Triggered when the task is completed or failed
  • Sent after billing confirmation is complete

Security restrictions:

  • Only HTTPS protocol is supported
  • Callbacks to private IP addresses are prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
  • URL length must not exceed 2048 characters

Callback mechanism:

  • Timeout: 10 seconds
  • Up to 3 retries after failure (at 1/2/4 seconds after failure respectively)
  • Callback response body format is consistent with the task query endpoint response format
  • A 2xx status code is considered successful; other status codes trigger retries
Pattern: ^https://
Example:

"https://your-domain.com/webhooks/video-task-completed"

Response

Video generation task created successfully

created
integer

Task creation timestamp

Example:

1761313744

id
string

Task ID

Example:

"task-unified-1774857405-abc123"

model
string

Actual model name used

Example:

"minimax-h3-text-to-video"

object
enum<string>

Specific type of the task

Available options:
video.generation.task
progress
integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100
Example:

0

status
enum<string>

Task status

Available options:
pending,
processing,
completed,
failed
Example:

"pending"

task_info
object

Video task details

type
enum<string>

Output type of the task

Available options:
text,
image,
audio,
video
Example:

"video"

usage
object

Usage and billing information