Hailuo 3 Text To Video

curl -X POST https://api.vibetool.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-text-to-video",
    "prompt": "a chef plating a colorful dessert in a modern kitchen, shallow depth of field",
    "duration": 6,
    "aspect_ratio": "16:9"
  }'

import requests

url = "https://api.vibetool.ai/v1/videos/generations"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "model": "minimax-h3-text-to-video",
    "prompt": "a chef plating a colorful dessert in a modern kitchen, shallow depth of field",
    "duration": 6,
    "aspect_ratio": "16:9"
}

r = requests.post(url, json=payload, headers=headers, timeout=60)
print(r.status_code, r.json())

const response = await fetch("https://api.vibetool.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "minimax-h3-text-to-video",
    prompt: "a chef plating a colorful dessert in a modern kitchen, shallow depth of field",
    duration: 6,
    aspect_ratio: "16:9"
  })
});
const data = await response.json();
console.log(data);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	payload := map[string]interface{}{
		"model":        "minimax-h3-text-to-video",
		"prompt":       "a chef plating a colorful dessert in a modern kitchen, shallow depth of field",
		"duration":     6,
		"aspect_ratio": "16:9",
	}
	b, _ := json.Marshal(payload)

	req, _ := http.NewRequest("POST", "https://api.vibetool.ai/v1/videos/generations", bytes.NewReader(b))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var result map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&result)
	fmt.Println(result)
}

{
  "id": "gen_vid_h3_001",
  "object": "video.generation",
  "model": "minimax-h3-text-to-video",
  "created_at": 1786549095,
  "status": "pending",
  "task_id": "vid_202608130137_9a1b2c3d"
}

{
  "error": {
    "message": "The prompt field is required",
    "type": "invalid_request_error",
    "param": "prompt",
    "code": 400
  }
}

POST

videos

generations

curl -X POST https://api.vibetool.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-text-to-video",
    "prompt": "a chef plating a colorful dessert in a modern kitchen, shallow depth of field",
    "duration": 6,
    "aspect_ratio": "16:9"
  }'

import requests

url = "https://api.vibetool.ai/v1/videos/generations"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "model": "minimax-h3-text-to-video",
    "prompt": "a chef plating a colorful dessert in a modern kitchen, shallow depth of field",
    "duration": 6,
    "aspect_ratio": "16:9"
}

r = requests.post(url, json=payload, headers=headers, timeout=60)
print(r.status_code, r.json())

const response = await fetch("https://api.vibetool.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "minimax-h3-text-to-video",
    prompt: "a chef plating a colorful dessert in a modern kitchen, shallow depth of field",
    duration: 6,
    aspect_ratio: "16:9"
  })
});
const data = await response.json();
console.log(data);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	payload := map[string]interface{}{
		"model":        "minimax-h3-text-to-video",
		"prompt":       "a chef plating a colorful dessert in a modern kitchen, shallow depth of field",
		"duration":     6,
		"aspect_ratio": "16:9",
	}
	b, _ := json.Marshal(payload)

	req, _ := http.NewRequest("POST", "https://api.vibetool.ai/v1/videos/generations", bytes.NewReader(b))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var result map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&result)
	fmt.Println(result)
}

{
  "id": "gen_vid_h3_001",
  "object": "video.generation",
  "model": "minimax-h3-text-to-video",
  "created_at": 1786549095,
  "status": "pending",
  "task_id": "vid_202608130137_9a1b2c3d"
}

{
  "error": {
    "message": "The prompt field is required",
    "type": "invalid_request_error",
    "param": "prompt",
    "code": 400
  }
}

Pricing: See vibetool.ai/pricing for current rates.

Hailuo 3 (MiniMax H3) is MiniMax’s flagship video generation model, exposed through Vibetool as a text-to-video endpoint. It produces 2K-resolution video from a natural-language prompt, with durations of 4–15 seconds and aspect ratios from vertical 9:16 to cinematic 21:9. Generation is billed per second of output video.

Input Modalities

Text – a prompt describing the subject, action, setting, camera movement, and style

Output Modality

Video – a 2K MP4 file, 4–15 seconds long

Authorization

string

required

All APIs require Bearer Token authentication. Format: Bearer YOUR_API_KEY

Request Body

string

required

The model identifier. Use "minimax-h3-text-to-video".

string

required

Text description of the video to generate, including subject, motion, scene, camera work, and style.

integer

default:"4"

Video duration in seconds — any integer from 4 to 15. Defaults to 4 when omitted.

string

Output aspect ratio: "21:9", "16:9", "4:3", "1:1", "3:4", or "9:16".

Hailuo 3 generates one video per request — the n parameter is not supported. Output resolution is fixed at 2K.

Response Schema

string

required

Unique identifier for the generation task.

string

required

Type of object, always "video.generation".

string

required

The model used, e.g., "minimax-h3-text-to-video".

integer

required

Unix timestamp (seconds) of task creation.

string

required

Initial status: "pending" or "processing". Use the Get Video Status endpoint to poll for completion.

string

required

The task ID to query in the status endpoint.

curl -X POST https://api.vibetool.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-text-to-video",
    "prompt": "a chef plating a colorful dessert in a modern kitchen, shallow depth of field",
    "duration": 6,
    "aspect_ratio": "16:9"
  }'

import requests

url = "https://api.vibetool.ai/v1/videos/generations"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "model": "minimax-h3-text-to-video",
    "prompt": "a chef plating a colorful dessert in a modern kitchen, shallow depth of field",
    "duration": 6,
    "aspect_ratio": "16:9"
}

r = requests.post(url, json=payload, headers=headers, timeout=60)
print(r.status_code, r.json())

const response = await fetch("https://api.vibetool.ai/v1/videos/generations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "minimax-h3-text-to-video",
    prompt: "a chef plating a colorful dessert in a modern kitchen, shallow depth of field",
    duration: 6,
    aspect_ratio: "16:9"
  })
});
const data = await response.json();
console.log(data);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	payload := map[string]interface{}{
		"model":        "minimax-h3-text-to-video",
		"prompt":       "a chef plating a colorful dessert in a modern kitchen, shallow depth of field",
		"duration":     6,
		"aspect_ratio": "16:9",
	}
	b, _ := json.Marshal(payload)

	req, _ := http.NewRequest("POST", "https://api.vibetool.ai/v1/videos/generations", bytes.NewReader(b))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var result map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&result)
	fmt.Println(result)
}

{
  "id": "gen_vid_h3_001",
  "object": "video.generation",
  "model": "minimax-h3-text-to-video",
  "created_at": 1786549095,
  "status": "pending",
  "task_id": "vid_202608130137_9a1b2c3d"
}

{
  "error": {
    "message": "The prompt field is required",
    "type": "invalid_request_error",
    "param": "prompt",
    "code": 400
  }
}

Once the task is created, poll the Get Video Status endpoint with the returned task_id until status is "completed" and the generated video URL is available.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

model

enum<string>

required

Use minimax-h3-text-to-video.

Available options:

minimax-h3-text-to-video

prompt

string

required

Text description of the video to generate

duration

integer

default:4

Duration in seconds (4-15)

Required range: 4 <= x <= 15

aspect_ratio

enum<string>

Available options:

21:9,

16:9,

4:3,

1:1,

3:4,

9:16

Response

Task created

string

Unique identifier for the generation task

object

string

Example:

"video.generation"

model

string

created_at

integer

Unix timestamp (seconds)

status

enum<string>

Initial task status

Available options:

pending,

processing

task_id

string

Task ID for the status polling endpoint

Getting Started

Text Generation

Image Generation

Video Generation

Hailuo 3 Text To Video

Input Modalities

Output Modality

Authorization

Request Body

Response Schema

Authorizations

Body

Response

​Input Modalities

​Output Modality

​Authorization

​Request Body

​Response Schema

Authorizations

Body

Response

Input Modalities

Output Modality

Authorization

Request Body

Response Schema