One continuous wide natural-history shot in a dramatic limestone stone forest at dawn. A single great hornbill with a clearly defined curved yellow casque and black-and-cream wings stands on a near rock pinnacle. It crouches, pushes off, opens both wings and flies through a broad gap between two distant pillars. The camera pans gently to follow the bird as it becomes smaller in the landscape. Consistent anatomy and wingbeat rhythm, convincing depth and brief natural rock occlusion. No other birds, no cuts, no text, no logos.
Hailuo 02 Standard Text to Video API
minimax/hailuo-02/standard/text-to-videoHailuo 02 Standard Text to Video transforms text prompts into cinematic 512P and 768P video scenes, supporting 6-second or 10-second clips, realistic physical simulation, and optional prompt refinement. It preserves compositional spatial coherence and fine lighting texture while delivering fluid camera movement and expressive character dynamics.
530/1500
OutputReady
Examples
REST API Spec
Quick Start
Submit an endpoint request and poll for status. Replace example URLs with your accessible files.
01
Step 1: Configure API authentication
Obtain an API key from the dashboard and include Authorization: Bearer <API_KEY> in every request header.
- Submission Endpoint
- POST
https://api.vidgo.ai/api/generate/submit - Auth Header
- Authorization: Bearer VIDGO_API_KEY
02
Step 2: Submit a generation task
POST /api/generate/submit. Pass model and optional callback_url at the root level, with generation parameters inside input.
Request Payload
REQUEST_BODY=$(cat <<'JSON'
{
"model": "minimax/hailuo-02/standard/text-to-video",
"input": {
"prompt": "One continuous wide natural-history shot in a dramatic limestone stone forest at dawn. A single great hornbill with a clearly defined curved yellow casque and black-and-cream wings stands on a near rock pinnacle. It crouches, pushes off, opens both wings and flies through a broad gap between two distant pillars. The camera pans gently to follow the bird as it becomes smaller in the landscape. Consistent anatomy and wingbeat rhythm, convincing depth and brief natural rock occlusion. No other birds, no cuts, no text, no logos.",
"prompt_optimizer": false,
"duration": 6
}
}
JSON
)
RESPONSE=$(curl --silent --show-error --fail-with-body \
--request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data "$REQUEST_BODY")
CODE=$(printf '%s' "$RESPONSE" | jq -r '.code // empty')
if [ "$CODE" != "0" ] && [ "$CODE" != "200" ]; then
printf 'API error: %s
' "$RESPONSE" >&2
exit 1
fi
printf '%s
' "$RESPONSE"03
Step 3: Poll for task completion
Poll status with task_id; continue while not_started or running, and stop on finished or failed. Read video URLs from data.files[].file_url on success, or data.error_message on failure.
Status Endpoint
GET https://api.vidgo.ai/api/generate/status/{task_id}Poll status using task_id; continue while not_started or running, stop when finished or failed. On success, read data.files[].file_url; on failure, read data.error_message.
not_startedrunningfinishedfailedSubmission Response
{
"code": 200,
"data": {
"task_id": "510G37CWFG1XX0QG",
"status": "running",
"created_time": "2026-09-22T13:03:05"
}
}Completed Response Data
{
"code": 200,
"data": {
"task_id": "task-unified-...",
"status": "finished",
"files": [
{
"file_url": "https://storage.vidgo.ai/generated/video.mp4",
"file_type": "video"
}
],
"created_time": "2026-08-22T10:00:00Z",
"progress": 100,
"error_message": null
}
}Complete end-to-end script example
Expand to view a production-ready script with retry logic, error handling, and timeout safeguards.
Complete end-to-end script example
set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"
REQUEST_BODY=$(cat <<'JSON'
{
"model": "minimax/hailuo-02/standard/text-to-video",
"input": {
"prompt": "One continuous wide natural-history shot in a dramatic limestone stone forest at dawn. A single great hornbill with a clearly defined curved yellow casque and black-and-cream wings stands on a near rock pinnacle. It crouches, pushes off, opens both wings and flies through a broad gap between two distant pillars. The camera pans gently to follow the bird as it becomes smaller in the landscape. Consistent anatomy and wingbeat rhythm, convincing depth and brief natural rock occlusion. No other birds, no cuts, no text, no logos.",
"prompt_optimizer": false,
"duration": 6
}
}
JSON
)
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
--request POST \
--url "https://api.vidgo.ai/api/generate/submit" \
--header "Authorization: Bearer $VIDGO_API_KEY" \
--header "Content-Type: application/json" \
--data "$REQUEST_BODY")
TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
BUSINESS_CODE=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.code // empty')
if [ "$BUSINESS_CODE" != "0" ] && [ "$BUSINESS_CODE" != "200" ]; then
printf 'Submit failed:
%s
' "$SUBMIT_RESPONSE" >&2
exit 1
fi
if [ -z "$TASK_ID" ]; then
printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
exit 1
fi
START_TIME=$(date +%s)
POLL_DELAY=2
while true; do
if [ $(( $(date +%s) - START_TIME )) -ge 600 ]; then
printf 'Timed out after 600 seconds
' >&2
exit 1
fi
STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
--url "https://api.vidgo.ai/api/generate/status/$TASK_ID" \
--header "Authorization: Bearer $VIDGO_API_KEY")
STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')
BUSINESS_CODE=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.code // empty')
if [ "$BUSINESS_CODE" != "0" ] && [ "$BUSINESS_CODE" != "200" ]; then
printf 'Status request failed:
%s
' "$STATUS_RESPONSE" >&2
exit 1
fi
case "$STATUS" in
finished)
printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
break
;;
failed)
printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
exit 1
;;
not_started|running)
sleep "$POLL_DELAY"
if [ "$POLL_DELAY" -lt 10 ]; then POLL_DELAY=$((POLL_DELAY + 1)); fi
;;
*)
printf 'Unexpected task status: %s
' "$STATUS" >&2
exit 1
;;
esac
doneRequest Parameters (input object)
Supported generation parameters inside the input object when submitting a POST request to /api/generate/submit:
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| prompt | string | Yes | — | Required nonblank string, trimmed before validation. Maximum 1500 Unicode characters. |
| resolution | string | No | 768P | 512P or 768P; defaults to 768P. |
| duration | integer | No | 6 | 6 or 10 seconds; defaults to 6. |
| prompt_optimizer | boolean | No | — | Optional boolean; omit to leave unspecified upstream. The playground starts with false. |
Response Fields (query result)
Task details returned when polling GET /api/generate/status/{task_id}:
| Field | Type | Description |
|---|---|---|
| code | integer | Business response code, 200 on success. |
| data.task_id | string | Globally unique asynchronous task identifier. |
| data.status | string | Execution status: not_started, running, finished, or failed. |
| data.files | array | Generated video files upon completion, each with file_url and file_type. |
| data.error_message | string | null | Error description if task fails. |
Task Lifecycle
Clients should inspect the status field and stop polling when reaching finished or failed:
not_startedTask received and queued for execution.
runningGeneration is in progress.
finishedGeneration complete; retrieve video URL from data.files.
failedGeneration failed; inspect data.error_message; deducted credits are refunded per standard policy.
Polling & Error Handling
- Recommended Polling IntervalStart polling every 2–3 seconds, increasing to 5 seconds as the task continues, to avoid excessive requests.
- Network Fluctuations & RetriesIf status polling encounters 5xx or timeouts, the task is still running; retry querying after a brief pause.
- Asynchronous Webhook CallbackProvide callback_url at the root of the request payload to receive the completed task result automatically via POST.
Specifications
| Specification | Value | Description |
|---|---|---|
| Model ID | minimax/hailuo-02/standard/text-to-video | Root-level model field. |
| Resolution | 512P / 768P | 512P or 768P; defaults to 768P. |
| Duration | 6 / 10s | Defaults to 6 seconds. |
Related Models
Hailuo 02 Standard Text to Video API frequently asked questions
What is the Hailuo 02 Standard Text to Video API?
Hailuo 02 Standard Text to Video is a MiniMax model for video generation from text. It generates continuous dynamic videos at 512P or 768P resolution directly from text prompts, supporting 6-second or 10-second durations, realistic physical simulation, and optional prompt refinement. Built on MiniMax's advanced video generation architecture, it faithfully executes narrative choreography and camera movement while preserving scenic coherence and lighting fidelity. You can call it programmatically or try it from the playground above.
Does Hailuo 02 Standard Text to Video support 10-second generations?
Yes. The model provides discrete 6-second and 10-second duration options, with 6 seconds as the default. Choosing 10 seconds allows creators to depict multi-stage actions, extended narrative arcs, and gradual camera transitions in a single clip.
How does the prompt optimizer work in Hailuo 02 Standard Text to Video?
The prompt optimizer (prompt_optimizer) enriches concise user prompts by automatically incorporating cinematic lighting, realistic textures, and camera framing details. It is an optional boolean parameter disabled by default in the playground, and enabling it incurs no extra credits.
What prompt length is supported by Hailuo 02 Standard Text to Video?
The prompt is trimmed of leading and trailing whitespace and accepts between 1 and 1,500 Unicode characters. This generous length allows detailed descriptions of subject characteristics, progressive actions, and environmental lighting.
How is Hailuo 02 Standard Text to Video billed?
This endpoint is billed on a per-second basis based on output resolution and duration (1 credit = $0.005). The 512P tier costs 3 credits/second (18 credits for 6s, 30 credits for 10s), while 768P costs 7 credits/second (42 credits for 6s, 70 credits for 10s).
Can Hailuo 02 Standard Text to Video control camera movement via prompts?
Yes. You can incorporate standard cinematography terms (such as 'slow push-in', 'lateral tracking shot', or 'wide high-angle crane') directly into your prompt. The model coordinates camera movement seamlessly with the subject's actions.
When should I choose Hailuo 02 Standard Text to Video over the Pro version?
Choose the Standard mode when you require explicit 6-second or 10-second duration control, economical per-second pricing (such as 512P at 3 credits/sec), or high-throughput conceptual prototyping. Choose the Pro mode when producing final hero assets demanding heightened cinematic dynamics.