MiniMax-Hailuo-02 Video Generation

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-02",
    "prompt": "City night scene, neon lights flickering, traffic flowing",
    "duration": 6,
    "resolution": "1080P"
  }'

import requests

response = requests.post(
    "https://toapis.com/v1/videos/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json",
    },
    json={
        "model": "MiniMax-Hailuo-02",
        "prompt": "City night scene, neon lights flickering, traffic flowing",
        "duration": 6,
        "resolution": "1080P",
    },
)

print(response.json())

const response = await fetch("https://toapis.com/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer your-ToAPIs-key",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "MiniMax-Hailuo-02",
    prompt: "City night scene, neon lights flickering, traffic flowing",
    duration: 6,
    resolution: "1080P"
  })
});

console.log(await response.json());

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

POST

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-02",
    "prompt": "City night scene, neon lights flickering, traffic flowing",
    "duration": 6,
    "resolution": "1080P"
  }'

import requests

response = requests.post(
    "https://toapis.com/v1/videos/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json",
    },
    json={
        "model": "MiniMax-Hailuo-02",
        "prompt": "City night scene, neon lights flickering, traffic flowing",
        "duration": 6,
        "resolution": "1080P",
    },
)

print(response.json())

const response = await fetch("https://toapis.com/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer your-ToAPIs-key",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "MiniMax-Hailuo-02",
    prompt: "City night scene, neon lights flickering, traffic flowing",
    duration: 6,
    resolution: "1080P"
  })
});

console.log(await response.json());

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

Async task API, returns task ID upon submission
Supported model: MiniMax-Hailuo-02
Three generation modes: text-to-video, image-to-video, first-last-frame generation
Supports 512P / 768P / 1080P resolution, 6-second and 10-second duration

Please provide publicly accessible image URLs. Do not pass base64 image data directly in image_urls or metadata; upload local images first using the Upload Image API to get URLs.

Authentication

string

required

All endpoints require Bearer Token authentication.

Authorization: Bearer YOUR_API_KEY

Request Parameters

string

required

Model name, fixed as MiniMax-Hailuo-02.

string

Video content description, max 2000 characters.

Required for text-to-video mode
Optional for image-to-video and first-last-frame modes (can describe desired motion)

Supports 15 camera directives (e.g., [Push in], [Pull out], [Pan left, Pedestal up]), see the Camera Directives table below.Example: "A mouse runs toward the camera, smiling and blinking"

integer

default:"6"

Video duration in seconds.Options: 6 or 10

When using 1080P resolution, only 6 seconds is supported.

string

default:"768P"

Video resolution.Options:

512P - Standard definition (available for image-to-video)
768P - HD (default)
1080P - Full HD (6-second duration only)

string[]

First frame image URL array.

Not provided: text-to-video
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"]

object

Extended parameters.

Show Show metadata fields

string

Last frame image URL for first-last-frame generation mode.When provided, the system generates a transition video from the first frame to the last frame.

When both image_urls (first frame) and last_frame_image (last frame) are provided, video dimensions follow the first frame
If first and last frame sizes differ, the model crops the last frame based on the first frame
First-last-frame mode does not support 512P resolution

Image requirements are the same as image_urls.Example: "https://example.com/last-frame.jpg"

boolean

default:"true"

Auto-optimize prompt. Set to false for more precise control.

boolean

default:"false"

Shorten prompt optimization time. Speeds up processing when enabled.

boolean

default:"false"

Whether to add watermark to the generated video.

string

ToAPIs final Task Webhook. Configure the Token URL and signing secret first; see Task Webhooks.

Three Generation Modes

Mode	image_urls	metadata.last_frame_image	Description
Text-to-Video	Not provided	Not provided	Generate video from text description
Image-to-Video	✅ 1 image	Not provided	Generate video with image as first frame
First-Last-Frame	✅ 1 image (first frame)	✅ Provided (last frame)	Generate transition video from first to last frame

Resolution and Duration Combinations

Resolution	Supported Durations	Text-to-Video	Image-to-Video	First-Last-Frame
512P	6s, 10s	✅	✅	❌
768P	6s, 10s	✅	✅	✅
1080P	6s	✅	✅	✅

Camera Directives

Use [directive] syntax in prompt to control camera movement:

Category	Directives
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

string

Task ID for querying task status.

string

Object type, always generation.task.

string

Model name used for this request.

string

Task status: queued, in_progress, completed, or failed.

integer

Task creation timestamp.

Examples

Text-to-Video

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "City night scene, neon lights flickering, traffic flowing [Push in]",
  "duration": 6,
  "resolution": "1080P"
}

Image-to-Video

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "Person slowly turns around, smiling",
  "image_urls": ["https://example.com/portrait.jpg"],
  "duration": 6,
  "resolution": "768P"
}

First-Last-Frame Generation

{
  "model": "MiniMax-Hailuo-02",
  "prompt": "A little girl grows up",
  "image_urls": ["https://example.com/child.jpg"],
  "duration": 6,
  "resolution": "1080P",
  "metadata": {
    "last_frame_image": "https://example.com/adult.jpg"
  }
}

Camera Control

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

10-Second Long Video + Fast Preprocessing

{
  "model": "MiniMax-Hailuo-02",
  "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-02",
    "prompt": "City night scene, neon lights flickering, traffic flowing",
    "duration": 6,
    "resolution": "1080P"
  }'

import requests

response = requests.post(
    "https://toapis.com/v1/videos/generations",
    headers={
        "Authorization": "Bearer your-ToAPIs-key",
        "Content-Type": "application/json",
    },
    json={
        "model": "MiniMax-Hailuo-02",
        "prompt": "City night scene, neon lights flickering, traffic flowing",
        "duration": 6,
        "resolution": "1080P",
    },
)

print(response.json())

const response = await fetch("https://toapis.com/v1/videos/generations", {
  method: "POST",
  headers: {
    Authorization: "Bearer your-ToAPIs-key",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "MiniMax-Hailuo-02",
    prompt: "City night scene, neon lights flickering, traffic flowing",
    duration: 6,
    resolution: "1080P"
  })
});

console.log(await response.json());

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

Veo3 Official Wan2.6

Overview

Quick Start

Chat API

Image API

Video API

Task Management

File Uploads

Account

FAQs

Authentication

Request Parameters

Three Generation Modes

Resolution and Duration Combinations

Camera Directives

Response

Examples

Text-to-Video

Image-to-Video

First-Last-Frame Generation

Camera Control

10-Second Long Video + Fast Preprocessing

​Authentication

​Request Parameters

​Three Generation Modes

​Resolution and Duration Combinations

​Camera Directives

​Response

​Examples

​Text-to-Video

​Image-to-Video

​First-Last-Frame Generation

​Camera Control

​10-Second Long Video + Fast Preprocessing

Authentication

Request Parameters

Three Generation Modes

Resolution and Duration Combinations

Camera Directives

Response

Examples

Text-to-Video

Image-to-Video

First-Last-Frame Generation

Camera Control

10-Second Long Video + Fast Preprocessing