Skip to main content
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "A cat running in a garden, camera slowly pushing in, cinematic feel",
    "duration": 6,
    "resolution": "1080P"
  }'

{
  "id": "vid_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ",
  "object": "generation.task",
  "model": "MiniMax-Hailuo-2.3",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}
  • Async task API, returns task ID upon submission
  • Supported models: MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3-Fast
  • MiniMax-Hailuo-2.3: Supports text-to-video and image-to-video, best quality
  • MiniMax-Hailuo-2.3-Fast: Image-to-video only (first frame image required), faster generation
Please provide publicly accessible image URLs. Do not pass base64 image data directly in image_urls; upload local images first using the Upload Image API to get URLs.

​
Authentication

​
Authorization
string
required
All endpoints require Bearer Token authentication.
Authorization: Bearer YOUR_API_KEY

​
Request Parameters

​
model
string
required
Model name.Options:
  • MiniMax-Hailuo-2.3 - Supports text-to-video and image-to-video
  • MiniMax-Hailuo-2.3-Fast - Image-to-video only (image_urls required)
​
prompt
string
required
Video content description, max 2000 characters.Supports 15 camera directives (e.g., [Push in], [Pull out], [Pan left, Pedestal up]), see the Camera Directives table below.Example: "A cat running in a garden [Push in], then stops and looks at the camera [Static shot]"
​
duration
integer
default:"6"
Video duration in seconds.Options: 6 or 10
When using 1080P resolution, only 6 seconds is supported.
​
resolution
string
default:"768P"
Video resolution.Options:
  • 768P - HD (default)
  • 1080P - Full HD (6-second duration only)
​
image_urls
string[]
First frame image URL array.
  • Not provided: text-to-video (MiniMax-Hailuo-2.3-Fast does not support this, must provide)
  • 1 image: image-to-video, image used as video starting frame
Image requirements:
  • Format: JPG, JPEG, PNG, WebP
  • Size: under 20MB
  • Dimensions: short side > 300px, aspect ratio between 2:5 and 5:2
Example: ["https://example.com/first-frame.jpg"]
​
metadata
object
Extended parameters.

​
Model Comparison

ModelText-to-VideoImage-to-VideoResolutionDuration
MiniMax-Hailuo-2.3✅✅768P / 1080P6s / 10s
MiniMax-Hailuo-2.3-Fast❌✅ (first frame required)768P / 1080P6s / 10s

​
Resolution and Duration Combinations

ResolutionSupported DurationsNote
768P6s, 10sDefault resolution
1080P6s10s not supported

​
Camera Directives

Use [directive] syntax in prompt to control camera movement:
CategoryDirectives
Pan[Pan left] [Pan right]
Tilt[Tilt up] [Tilt down]
Push/Pull[Push in] [Pull out]
Pedestal[Pedestal up] [Pedestal down]
Truck[Truck left] [Truck right]
Zoom[Zoom in] [Zoom out]
Other[Shake] [Tracking shot] [Static shot]
Usage rules:
  • Combine up to 3 directives in one bracket for simultaneous movement, e.g., [Pan left, Pedestal up]
  • Sequence directives in the prompt for ordered camera moves, e.g., "...[Push in], then...[Pull out]"

​
Response

​
id
string
Task ID for querying task status.
​
object
string
Object type, always generation.task.
​
model
string
Model name used for this request.
​
status
string
Task status: queued, in_progress, completed, or failed.
​
created_at
integer
Task creation timestamp.

​
Examples

​
Text-to-Video

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "A cat running in a garden, camera slowly pushing in, cinematic feel",
  "duration": 6,
  "resolution": "1080P"
}

​
Image-to-Video

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "The person in the image slowly turns around and smiles",
  "image_urls": ["https://example.com/portrait.jpg"],
  "duration": 6,
  "resolution": "1080P"
}

​
Image-to-Video (Fast Mode)

{
  "model": "MiniMax-Hailuo-2.3-Fast",
  "prompt": "Person starts walking from a still position",
  "image_urls": ["https://example.com/person.jpg"],
  "duration": 6,
  "resolution": "768P"
}

​
Camera Control

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

​
10-Second Long Video

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "Waves crashing on the beach at sunset, golden light shimmering on the water",
  "duration": 10,
  "resolution": "768P",
  "metadata": {
    "prompt_optimizer": true,
    "fast_pretreatment": true
  }
}
Video generation is an async task. Use Get Video Task Status to query progress and results.
curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "A cat running in a garden, camera slowly pushing in, cinematic feel",
    "duration": 6,
    "resolution": "1080P"
  }'

{
  "id": "vid_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ",
  "object": "generation.task",
  "model": "MiniMax-Hailuo-2.3",
  "status": "queued",
  "progress": 0,
  "created_at": 1768380224,
  "metadata": {}
}