Skip to main content
POST
HappyHorse Video Generation

Introduction

HappyHorse is Alibaba Cloud Bailian’s video generation family: text-to-video (HappyHorse-T2V), image-to-video (HappyHorse-I2V), and reference-to-video (HappyHorse-R2V). It produces physically realistic, smooth-motion videos at 720P and 1080P, with durations from 3–15 seconds. Use GravitexAI’s unified video API: submit a task to get a task_id, then query the task to poll status and get url.
HappyHorse passes underlying DashScope parameters via metadata.input and metadata.parameters, same structure as Wan 2.7. Reference-to-video uses [Image 1], [Image 2] in the prompt (English bracket format) and supports image references only—no video references.

Authentication

string
required
Bearer Token, e.g. Bearer sk-xxxxxxxxxx

Supported models

Workflow

  1. Submit task: POST /v1/video/generations with model, prompt, duration, and HappyHorse params in metadata.
  2. Poll status: GET /v1/video/generations/{task_id} every 3–15 seconds until status is succeeded or failed.
  3. Get result: On success, url contains the video link (typically valid for 24 hours—download promptly).

Common request structure

Submit response

Query response (success)

Use cases

Generate physically realistic, smooth-motion video from a text prompt.
string
required
Text prompt describing the desired video
string
default:"1080P"
720P or 1080P
string
default:"16:9"
Aspect ratio: 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9
integer
default:"5"
Duration in seconds, range 3–15
boolean
default:"true"
Add watermark (fixed text “Happy Horse” at bottom-right)
integer
Random seed, range [0, 2147483647], for reproducibility
Example:

Parameter reference

Common parameters

Text-to-video & reference-to-video

Media input limits

Error handling

On failure, status is failed and error.message contains the reason.

FAQ

Video url and task_id are typically valid for 24 hours. Download and store promptly.
Use [Image 1], [Image 2] in the prompt. Order matches reference_image entries in media. Describe specific objects in each reference.
HappyHorse I2V supports first frame (first_frame) only—no first+last frame, continuation, or audio driving.
Same metadata.input / metadata.parameters structure. HappyHorse R2V uses [Image n] and images only (up to 9); Wan 2.7 uses 图n/视频n with video refs and voice clone. HappyHorse defaults to 1080P and watermark on; duration is 3–15s.

Submit video task

Unified video submission and multi-model parameters

Query video task

Poll task status and get video URL