curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "minimax/h3-max/text-to-video",
"input": {
"prompt": "A cinematic aerial view of a coastal city at sunrise"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1787970600-abcd1234",
"status": "not_started",
"created_time": "2026-08-29T10:30:00Z"
}
}MiniMax / Hailuo
MiniMax H3 Max Text to Video
Generate a video from a text prompt.
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "minimax/h3-max/text-to-video",
"input": {
"prompt": "A cinematic aerial view of a coastal city at sunrise"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1787970600-abcd1234",
"status": "not_started",
"created_time": "2026-08-29T10:30:00Z"
}
}- Submit the request with
VIDGO_API_KEY. Atask_idis returned. Keep it until the task reachesfinishedorfailed. - Use Query Task Status to retrieve the result. If you provide a
callback_url, Vidgo sends the result to your webhook when the task finishes or fails.
Usage Guide
Useminimax/h3-max/text-to-video. Provide a prompt without media. Select the text endpoint for prompt-only generation.
Set model and optional callback_url at the request root. Place generation parameters inside input.
Parameter Details
prompt: required non-empty string, up to 50,000 characters.duration: integer from 5 through 15 seconds; defaults to 5. Fractional durations are rejected.resolution:480p,768por1080p; defaults to768p.aspect_ratio:21:9,16:9,4:3,1:1,3:4or9:16; defaults to16:9.
Optional parameters
enable_safety_checker: boolean, defaults totrue. Setfalseto disable it.callback_url: optional webhook URL at the request root. Query task status if you do not use a callback.
Authorizations
Use Authorization: Bearer VIDGO_API_KEY.
Body
application/json