Text-to-Image Video Generation Task

POST https://www.kkiai.com/minimax/v1/video_generation

Request Parameters

Authorization

Add the Authorization parameter to the Header. Its value is the Token concatenated after Bearer.

Example: Authorization: Bearer ********************

Header Parameters

Parameter Name	Type	Required	Description	Example
Authorization	string	Optional		sk-

Body Parameters (application/json)

Parameter Name	Type	Required	Description
model	string	Required	Model name. Available values: MiniMax-Hailuo-2.3, MiniMax-Hailuo-02
prompt	string	Required	Text description of the video, maximum 2000 characters. Supports [Instruction] syntax for camera movement control, such as [Pan Left], [Pan Right], [Push In], [Pull Out], [Rise], [Lower], [Pan Left], [Pan Right], [Tilt Up], [Tilt Down], [Zoom In], [Zoom Out], [Shake], [Follow], [Static] and 15 other camera movement instructions
duration	integer	Required	Video duration (seconds). Available values: 6 or 10 (10 seconds only supports 768P resolution for Hailuo series models)
resolution	string	Required	Video resolution. Available values: 720P (default for other models), 768P (default for Hailuo series), 1080P (only supports 6 seconds)
prompt_optimizer	boolean	Required	Whether to automatically optimize the prompt. Set to false for more precise control
fast_pretreatment	boolean	Required	Whether to shorten the optimization time of prompt_optimizer. Only effective for MiniMax-Hailuo-2.3 and MiniMax-Hailuo-02 models
callback_url	string	Required	Callback URL to receive task status update notifications. Once configured, you will receive asynchronous notifications of task status changes (processing/success/failed)
aigc_watermark	boolean	Required	Whether to add an AIGC watermark to the generated video
first_frame_image	string	Required	Use the specified image as the starting frame of the video. Supports public URLs or Base64-encoded Data URLs (data:image/jpeg;base64,...)

Request Example

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "A man picks up a book [Pedestal up], then reads [Static shot].",
  "duration": 6,
  "resolution": "1080P"
}

cURL Example

curl --location --request POST 'https://www.kkiai.com/minimax/v1/video_generation' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "MiniMax-Hailuo-02",
  "prompt": "A man picks up a book [Pedestal up], then reads [Static shot].",
  "duration": 6,
  "resolution": "1080P"
}'

Response

🟢 200 Success

Response Body

Parameter Name	Type	Required	Description
task_id	string	Required
base_resp	object	Required
└ status_code	integer	Required
└ status_msg	string	Required

Response Example

{
  "task_id": "106916112212032",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}