curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "minimax/hailuo-2.3/pro/image-to-video",
"input": {
"prompt": "A quiet forest under soft morning light, with natural detail.",
"start_image_url": "https://example.com/image.png",
"duration": 6,
"resolution": "1080p"
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}MiniMax / Hailuo
Hailuo 2.3 Pro Image to Video
Turn a starting image into a 1080p video with Hailuo 2.3 Pro, using text and optional prompt refinement to guide the motion.
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/hailuo-2.3/pro/image-to-video",
"input": {
"prompt": "A quiet forest under soft morning light, with natural detail.",
"start_image_url": "https://example.com/image.png",
"duration": 6,
"resolution": "1080p"
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- Submit the request with
VIDGO_API_KEY. Atask_idis returned immediately. 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.
Hailuo 2.3 Pro Image to Video
Turn a starting image into a 1080p video with Hailuo 2.3 Pro, using text and optional prompt refinement to guide the motion.Available Models
- minimax/hailuo-2.3/pro/image-to-video - Generate video from image input.
Duration Options
- 6 seconds - Set
durationas an integer. Optional. Default: 6 seconds.
Key Features
- Generate video from image input.
- Use
start_image_urlto supply the starting frame. - This model ID fixes the output resolution to
1080p.
Advanced Parameters
Setmodel and optional callback_url at the request root. Place all workflow parameters, including output options, inside input.
Send only the input fields supported by this workflow. JSON types are validated without converting strings to numbers or booleans; prompt must be a string and fractional durations are rejected. Unsupported input fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials.
Prompt
prompt: Required. Describe the scene and desired motion. Length: 1-5,000 characters.- The value must not be blank when supplied.
Resolution
resolution: Optional. Accepted values:1080p. Default:1080p.
Start Image URL
start_image_url: Required. Provide the starting frame URL. Use a publicly accessible HTTP(S) URL.
Prompt Optimizer
prompt_optimizer: Optional. Control automatic prompt optimization. Usetrueorfalse. Omit this field to leave it unspecified upstream; no API default is imposed.
Billing Factors
Billed per video using the Pro model tier. This endpoint fixes output resolution to1080p and duration to 6 seconds. Prompt optimization (prompt_optimizer) does not change the charge.
Credits are deducted on submission and refunded if the task fails.Authorizations
Use VIDGO_API_KEY.
Body
application/json
Keep model and callback_url at the root. Unknown root fields are ignored; unsupported input fields are rejected.