Hailuo-02-Fast - Text To Video - gptproto

POST

api

minimax

hailuo-02-fast

text-to-video

hailuo-02-fast (Text To Video)

curl --request POST \
  --url https://gptproto.com/api/v3/minimax/hailuo-02-fast/text-to-video

const options = {method: 'POST'};

fetch('https://gptproto.com/api/v3/minimax/hailuo-02-fast/text-to-video', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gptproto.com/api/v3/minimax/hailuo-02-fast/text-to-video",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://gptproto.com/api/v3/minimax/hailuo-02-fast/text-to-video"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://gptproto.com/api/v3/minimax/hailuo-02-fast/text-to-video")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

Authentication

Sign up for a GPTProto account at https://gptproto.com
Navigate to the API Keys section in your dashboard
Generate a new API key (sk-xxxxx)
Copy and securely store your API key For authentication details, please refer to the Authentication section.

Initiate Request

curl --location 'https://gptproto.com/api/v3/minimax/hailuo-02-fast/text-to-video' \
--header 'Authorization: GPTPROTO_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "duration": 6,
  "enable_prompt_expansion": true,
  "prompt": "a act"
}'

const axios = require('axios');
let data = JSON.stringify({
  "duration": 6,
  "enable_prompt_expansion": true,
  "prompt": "a act"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://gptproto.com/api/v3/minimax/hailuo-02-fast/text-to-video',
  headers: { 
    'Authorization': 'GPTPROTO_API_KEY', 
    'Content-Type': 'application/json'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

import requests
import json

url = "https://gptproto.com/api/v3/minimax/hailuo-02-fast/text-to-video"

payload = json.dumps({
  "duration": 6,
  "enable_prompt_expansion": True,
  "prompt": "a act"
})
headers = {
  'Authorization': 'GPTPROTO_API_KEY',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://gptproto.com/api/v3/minimax/hailuo-02-fast/text-to-video"
  method := "POST"

  payload := strings.NewReader(`{
  "duration": 6,
  "enable_prompt_expansion": true,
  "prompt": "a act"
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Authorization", "GPTPROTO_API_KEY")
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Query Result

If the request that generated your content includes the parameter enable_sync_mode set to true (some models do not support this parameter, but you still need to query the result by id), you must call the Query Result endpoint to retrieve the final output.

curl -X GET "https://gptproto.com/api/v3/predictions/{id}/result" \
  -H "Authorization: GPTPROTO_API_KEY" \
  -H "Content-Type: application/json"

import requests
import json

url = "https://gptproto.com/api/v3/predictions/{id}/result"
headers = {
    "Authorization: GPTPROTO_API_KEY",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
result = response.json()
print(json.dumps(result, indent=2))

const url = "https://gptproto.com/api/v3/predictions/{id}/result";
const headers = {
  "Authorization: GPTPROTO_API_KEY",
  "Content-Type": "application/json"
};

fetch(url, {
  method: "GET",
  headers: headers
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

package main

import (
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    url := "https://gptproto.com/api/v3/predictions/{id}/result"

    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("Authorization", "GPTPROTO_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()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

After submitting your prediction request, the response will contain the id you need.
You can find it in either:

data.id – the unique identifier of the prediction
data.urls[0].get – a ready-to-use GET URL that already embeds the id

Response Example

{
    "data": {
        "id": "abc",
        "model": "model_name",
        "outputs": [],
        "urls": {
            "get": "https://gptproto.com/api/v3/predictions/abc/result"
        },
        "status": "completed",
        "error": null,
        "executionTime": 0,
        "timings": {
            "inference": 0
        },
        "has_nsfw_contents": [],
        "created_at": "2026-01-01 00:00:00"
    },
    "message": "success",
    "code": 200
}

Parameters

Path Parameters

Endpoint: https://gptproto.com/api/v3/minimax/{model}/{scene}

Body parameters may vary depending on the scene. Incorrect scene selection may cause parameters to fail. Please choose the appropriate scene based on your actual needs.

scene	example
`text-to-video`	`https://gptproto.com/api/v3/minimax/hailuo-02-fast/text-to-video`
`image-to-video`	`https://gptproto.com/api/v3/minimax/hailuo-02-fast/image-to-video`

Request Body

Parameter	Type	Required	Default	Range	Description
`prompt`	string	✅ Yes	-	-	Prompt parameter
`image`	string	✅ Yes (required in image-to-video scene)	-	-	The model generates video with the picture passed in as the first frame.Base64 encoded strings in data:image/jpeg; base64, format for incoming images, or URLs accessible via the public network. The uploaded image needs to meet the following conditions: Format is JPG/JPEG/PNG; The aspect ratio is greater than 2:5 and less than 5:2; Short side pixels greater than 300px; The image file size cannot exceed 20MB.
`end_image`	string	❌ No	-	-	The model generates video with the picture passed in as the first frame.Base64 encoded strings in data:image/jpeg; base64, format for incoming images, or URLs accessible via the public network. The uploaded image needs to meet the following conditions: Format is JPG/JPEG/PNG; The aspect ratio is greater than 2:5 and less than 5:2; Short side pixels greater than 300px; The image file size cannot exceed 20MB.
`duration`	integer	❌ No	`6`	`6`, `10`	The duration of the generated media in seconds. See Duration & Resolution for more details.
`resolution`	string	❌ No	`768P`	`512P`, `720P`, `768P`, `1080P`	Resolution parameter. See Resolution & Duration for more details.
`enable_prompt_expansion`	boolean	❌ No	`true`	-	The model automatically optimizes incoming prompts to enhance output quality. This also activates the safety checker, which ensures content safety by detecting and filtering potential risks.

Duration & Resolution

Available video duration (seconds) and resolution combinations. Default duration is 6 seconds. Values vary by model:

Model	768P	1080P
MiniMax-Hailuo-2.3-fast	`6` or `10`	`6`
MiniMax-Hailuo-2.3-standard	`6` or `10`	-
MiniMax-Hailuo-2.3-pro	-	`6`
MiniMax-Hailuo-02-fast	`6` or `10`	-
MiniMax-Hailuo-02-standard	`6` or `10`	-
MiniMax-Hailuo-02-pro	-	`6`

Error Codes

Common Error Codes

Error Code	Error Name	Description
401	Unauthorized	API key is missing or invalid
403	Forbidden	Your API key doesn’t have permission to access this resource, or insufficient balance for the requested operation
429	Too Many Requests	You’ve exceeded your rate limit
500	Internal server error	An internal server error occurred
503	Content policy violation	Content blocked due to safety concerns (actual status code is 400)

​Authentication

​Initiate Request

​Query Result

​Parameters

​Path Parameters

​Request Body

​Duration & Resolution

​Error Codes

​Common Error Codes

Authentication

Initiate Request

Query Result

Parameters

Path Parameters

Request Body

Duration & Resolution

Error Codes

Common Error Codes