Skip to main content
POST
https://gptproto.com
/
api
/
v3
/
minimax
/
hailuo-2.3-standard
/
text-to-video
hailuo-2.3-standard (Text To Video)
curl --request POST \
  --url https://gptproto.com/api/v3/minimax/hailuo-2.3-standard/text-to-video

​
Authentication

  1. Sign up for a GPTProto account at 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 section.

​
Initiate Request

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

​
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"
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
{
    "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.
sceneexample
text-to-videohttps://gptproto.com/api/v3/minimax/hailuo-02-fast/text-to-video
image-to-videohttps://gptproto.com/api/v3/minimax/hailuo-02-fast/image-to-video

​
Request Body

ParameterTypeRequiredDefaultRangeDescription
promptstring✅ Yes--Prompt parameter
imagestring✅ 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_imagestring❌ 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.
durationinteger❌ No66, 10The duration of the generated media in seconds. See Duration for more details.
resolutionstring❌ No768P512P, 720P, 768P, 1080PResolution parameter. See Resolution for more details.
enable_prompt_expansionboolean❌ Notrue-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

Video duration (seconds), default value is 6. Available values depend on model and resolution:
Model720P768P1080P
MiniMax-Hailuo-2.3-6 or 106
MiniMax-Hailuo-2.3-Fast-6 or 106
MiniMax-Hailuo-02-6 or 106
Other models6-6

​
Resolution

Video resolution. Available values depend on model:
Model6s10s
MiniMax-Hailuo-2.3768P (default), 1080P768P (default)
MiniMax-Hailuo-2.3-Fast768P (default), 1080P768P (default)
MiniMax-Hailuo-02512P, 768P (default), 1080P512P, 768P (default)
Other models720P (default)Not supported

​
Error Codes

​
Common Error Codes

Error CodeError NameDescription
401UnauthorizedAPI key is missing or invalid
403ForbiddenYour API key doesn’t have permission to access this resource, or insufficient balance for the requested operation
429Too Many RequestsYou’ve exceeded your rate limit
500Internal server errorAn internal server error occurred
503Content policy violationContent blocked due to safety concerns (actual status code is 400)