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/image-to-video",
"input": {
"prompt": "The camera glides forward",
"image_urls": [
"https://example.com/start.jpg"
]
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1787970600-abcd1234",
"status": "not_started",
"created_time": "2026-08-29T10:30:00Z"
}
}MiniMax / Hailuo
MiniMax H3 Max Image to Video
Animate a starting frame with an optional ending frame.
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/image-to-video",
"input": {
"prompt": "The camera glides forward",
"image_urls": [
"https://example.com/start.jpg"
]
}
}
'{
"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/image-to-video. Provide image_urls in order: the starting frame first, then an optional ending frame. The output follows the starting image; omit aspect_ratio.
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.image_urls: required array of 1-2 images, in starting-frame and ending-frame order. Use public HTTP(S) download URLs. Base64 is not supported.
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