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

Available Models

  • minimax/hailuo-02/pro/text-to-video - Generate video scenes from text prompts.

Output Options

  • resolution: Optional. Accepted values: 512P, 768P. Default: 768P.
  • Do not send duration; the current PoYo Pro handler rejects this field.

Key Features

  • Generate video scenes from text prompts.

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. Unsupported input fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials.
  • Resolution is forwarded to PoYo as supplied; no fixed output duration or 1080P output is asserted by this contract.

Prompt

  • prompt: Required. Describe the scene and desired motion. The current PoYo Pro handler has no explicit prompt length limit.
  • Whitespace is trimmed before validation; the result must not be blank.

Prompt Optimizer

  • prompt_optimizer: Optional. Control automatic prompt optimization. Use true or false.

Pricing

65 credits ($0.325) per generation, for either resolution. 1 credit = $0.005. 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
enum<string>
required

Vidgo public model ID. Must be minimax/hailuo-02/pro/text-to-video.

Available options:
minimax/hailuo-02/pro/text-to-video
Example:

"minimax/hailuo-02/pro/text-to-video"

input
object
required

Input parameters for generation

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