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/standard/text-to-video",
"input": {
"prompt": "A quiet forest under soft morning light, with natural detail.",
"duration": 6,
"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 Text to Video
Create short scenes from text with Hailuo 02 Standard, 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/standard/text-to-video",
"input": {
"prompt": "A quiet forest under soft morning light, with natural detail.",
"duration": 6,
"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>"
}- 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 02 Text to Video
Create short scenes from text with Hailuo 02 Standard, with optional prompt refinement to develop the visual direction of a clip.Available Models
- minimax/hailuo-02/standard/text-to-video - Generate video scenes from text prompts.
Duration Options
- 6, 10 seconds - Set
durationas an integer. Optional. Default: 6 seconds.
Key Features
- Generate video scenes from text prompts.
- Accepts
512Por768Presolution; defaults to768P.
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. 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-1,500 characters.- Whitespace is trimmed before validation; the result must not be blank.
Resolution
resolution: Optional. Accepted values:512P,768P. Default:768P.
Prompt Optimizer
prompt_optimizer: Optional. Control automatic prompt optimization. Usetrueorfalse.
Pricing
512P: 3 credits/second, 18 credits (0.09)for6secondsor30credits(0.15) for 10 seconds. 768P: 7 credits/second, 42 credits (0.21)for6secondsor70credits(0.35) for 10 seconds. 1 credit = $0.005. 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.
Vidgo public model ID. Must be minimax/hailuo-02/standard/text-to-video.
Available options:
minimax/hailuo-02/standard/text-to-video Example:
"minimax/hailuo-02/standard/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.