curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "minimax/hailuo-02/pro/text-to-video",
"input": {
"prompt": "A quiet forest under soft morning light, with natural detail.",
"resolution": "768P"
}
}
'{
"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 02 Pro Text to Video
Create short scenes from text with Hailuo 02 Pro, with optional prompt refinement to develop the visual direction of a clip.
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-02/pro/text-to-video",
"input": {
"prompt": "A quiet forest under soft morning light, with natural detail.",
"resolution": "768P"
}
}
'{
"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>"
}- After submission, a
task_idwill be returned. If you provided acallback_url, when the task status becomesfinishedorfailed, a POST request will be sent to thecallback_url. - Regardless of whether
callback_urlis provided, you can retrieve the result through the unified Query Task Status endpoint.
Models
- minimax/hailuo-02/pro/text-to-video - Generate video scenes from text prompts.
Features
- Generate video scenes from text prompts.
Output Options
resolution: Optional. Accepted values:512P,768P. Default:768P.
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. Unsupported input fields are rejected before credits are deducted.
Prompt
prompt: Required. Describe the scene and desired motion. No maximum prompt length is specified.- Whitespace is trimmed before validation; the result must not be blank.
Prompt Optimizer
prompt_optimizer: Optional. Control automatic prompt optimization. Usetrueorfalse.
Billing Factors
Billed per generation using the Pro model tier. Both supported resolutions use the same rate. 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.
Example:
"minimax/hailuo-02/pro/text-to-video"
Input parameters for generation
Show child attributes
Show child attributes
Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.