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/reference-to-video",
"input": {
"prompt": "Image 1 walks through a sunlit street",
"reference_image_urls": [
"https://example.com/subject.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 Reference to Video
Create a video from image, video and audio references.
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/reference-to-video",
"input": {
"prompt": "Image 1 walks through a sunlit street",
"reference_image_urls": [
"https://example.com/subject.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.
This endpoint is currently unavailable. Requests return HTTP
503 without creating a task or charging credits.Usage Guide
Useminimax/h3-max/reference-to-video. When this workflow becomes available, provide at least one reference image. Optionally add reference video and audio, with at most 12 assets across all lists. Refer to assets as Image 1, Video 1 and Audio 1 in list order. Starting and ending frames cannot be combined with reference assets.
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: six fixed ratios (21:9,16:9,4:3,1:1,3:4,9:16) oradaptive; defaults toadaptive.reference_image_urls: required array of 1-9 static JPEG, PNG or WebP images, at most 30 MB each. Supported shapes are1:1,4:3,3:4,16:9,9:16,5:2and2:5; normalize image orientation before uploading.reference_video_urls: optional array of up to 3 MP4/MOV clips, at most 50 MB each. Each clip must be 2-15 seconds, with at most 15 seconds combined. Clips must use constant 24 fps, square pixels, zero rotation metadata, and a16:9or9:16shape. After limiting frames to the requested output duration, the counted frames must be 48, 120, 240 or 360. Other timing patterns are rejected.reference_audio_urls: optional array of up to 3 MP3/WAV clips, at most 15 MB each. Each clip must be 2-15 seconds and no longer than the output duration, with at most 15 seconds combined. Audio must be mono or stereo at 32 kHz, with a decoded sample count divisible by 800.- All reference URLs must be public HTTP(S) download links. Total assets across the three lists must not exceed 12.
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