> ## Documentation Index > Fetch the complete documentation index at: https://docs.gptproto.com/llms.txt > Use this file to discover all available pages before exploring further. # Hailuo-2.3-Fast - Text To Video - gptproto > Quick hailuo 2.3 fast text to video. Rapidly generate cinematic AI videos from text with next-gen efficiency. export const data_0 = undefined ## Authentication 1. Sign up for a GPTProto account at [https://gptproto.com](https://gptproto.com) 2. Navigate to the API Keys section in your dashboard 3. Generate a new API key (sk-xxxxx) 4. Copy and securely store your API key For authentication details, please refer to the [Authentication](https://docs.gptproto.com/authentication) section. ## Initiate Request ```bash cURL theme={null} curl --location 'https://gptproto.com/api/v3/minimax/hailuo-2.3-fast/text-to-video' \ --header 'Authorization: GPTPROTO_API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "duration": 6, "enable_prompt_expansion": true, "prompt": "a act" }' ``` ```javascript JavaScript theme={null} 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-2.3-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); }); ``` ```python Python theme={null} import requests import json url = "https://gptproto.com/api/v3/minimax/hailuo-2.3-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) ``` ```go Go theme={null} package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://gptproto.com/api/v3/minimax/hailuo-2.3-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. ```bash cURL theme={null} curl -X GET "https://gptproto.com/api/v3/predictions/{id}/result" \ -H "Authorization: GPTPROTO_API_KEY" \ -H "Content-Type: application/json" ``` ```python Python theme={null} 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)) ``` ```javascript JavaScript theme={null} 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)); ``` ```go Go theme={null} 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 ```json theme={null} { "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,{data_0} 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,{data_0} 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](#duration-resolution) for more details. | | `resolution` | string | ❌ No | `768P` | `512P`, `720P`, `768P`, `1080P` | Resolution parameter. See [Resolution & Duration](#duration-resolution) 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) |