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.

Happy Horse 1.1 Text to Video

Generate short video scenes with Happy Horse 1.1, with output up to 1080p and framing from wide cinematic layouts to tall vertical video.

Available Models

  • alibaba/happyhorse-1.1/text-to-video - Generate video scenes from text prompts.

Duration Options

  • 3-15 seconds - Set duration as an integer. Optional. Default: 5 seconds.

Key Features

  • Generate video scenes from text prompts.
  • Choose from 720p, 1080p output resolutions.

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. duration and seed also accept integer strings such as "5"; decimal numbers such as 5.0 and decimal strings such as "5.0" are rejected. Null or empty values use the default duration or omit the seed. Supported boolean fields also accept 0/1 and case-insensitive strings true/false, 1/0, yes/no, y/n, and on/off; null omits the field. Surrounding whitespace is trimmed, and resolution values are case-insensitive.

Prompt

  • prompt: Required. Describe the scene and desired motion. Maximum: 2,500 Unicode characters.
  • Leading and trailing whitespace is trimmed. A nonblank prompt is required.

Aspect Ratio

  • aspect_ratio: Optional. Accepted values: 21:9, 16:9, 4:3, 1:1, 3:4, 4:5, 5:4, 9:16, 9:21. Default: 16:9.

Resolution

  • resolution: Optional. Accepted values: 720p, 1080p. Default: 1080p.

Seed

  • seed: Optional. Set the generation seed. Integer from 0 to 2147483647.

Safety Checker

  • enable_safety_checker: Optional. Control safety checking. Use true or false.

Pricing

Usage equals output seconds multiplied by the selected resolution rate. See Pricing for current rates. 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 alibaba/happyhorse-1.1/text-to-video.

Available options:
alibaba/happyhorse-1.1/text-to-video
Example:

"alibaba/happyhorse-1.1/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