Skip to main content
POST
  1. Submit the request with VIDGO_API_KEY. A task_id is returned immediately. Keep it until the task reaches finished or failed.
  2. 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 Text to Video

Generate short video scenes with Hailuo 2.3 Standard, with 768p output and optional prompt refinement for written scene concepts.

Available Models

  • minimax/hailuo-2.3/standard/text-to-video - Generate video scenes from text prompts.

Duration Options

  • 6, 10 seconds - Set duration as an integer. Optional. Default: 6 seconds.

Key Features

  • Generate video scenes from text prompts.
  • This model ID fixes the output resolution to 768p.

Advanced Parameters

Set model 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.

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: 768p. Default: 768p.

Prompt Optimizer

  • prompt_optimizer: Optional. Control automatic prompt optimization. Use true or false. Omit this field to leave it unspecified upstream; no API default is imposed.

Billing Factors

Billing depends on video duration (duration) using the Standard model tier. This endpoint fixes output resolution to 768p. Prompt optimization (prompt_optimizer) does not change the charge. Credits are deducted on submission and refunded if the task fails.

Authorizations

Authorization
string
header
required

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.

model
string
required
Example:

"minimax/hailuo-2.3/standard/text-to-video"

input
object
required
callback_url
string | null

Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.

Response

Task submitted

code
enum<integer>
required
Available options:
200
data
object
required