Alibaba Happyhorse 1.1 Text To Video API Documentation

Alibaba Happyhorse 1.1 Text To Video API Documentation

Playground

Alibaba HappyHorse 1.1 Text-to-Video generates cinematic 720P or 1080P videos from text prompts, with smooth camera movement, expressive motion, and strong prompt fidelity. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Alibaba Happy Horse 1.1 Text-to-Video turns natural-language prompts into cinematic videos with smooth motion, strong prompt alignment, and stable subject rendering. It supports 480p, 720p and 1080p output, along with multiple aspect ratios for ad creatives, social content, storytelling, and concept work.

• Need to animate a reference image instead? Try Alibaba Happy Horse 1.1 Image-to-Video.

Why Choose This?

• Strong prompt fidelity
  Follows detailed instructions for scene composition, action, lighting, mood, and camera movement.

• Cinematic motion
  Generates smooth, expressive motion with stable subjects and polished visual dynamics.

• Flexible aspect ratios
  Supports 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, and 21:9 for landscape, portrait, square, and ultrawide video formats.

• Resolution options for different needs
  Choose 480p for the lowest cost, 720p for everyday iteration or 1080p for higher-resolution outputs.

• Production-ready API
  Access the model through a REST inference API for easy integration into creative workflows.

Parameters

How to Use

1. Write your prompt — Describe the scene, subject, action, camera movement, lighting, and mood.
2. Choose aspect ratio — Select the format that best matches your target platform or creative layout.
3. Choose resolution — Use 480p for the lowest cost, 720p for everyday iteration or 1080p for higher-resolution output.
4. Set duration — Choose a clip length between 3 and 15 seconds.
5. Set a seed optional — Use a fixed seed if you want more reproducible results.
6. Submit — Generate and download your video.

Example Prompt

A cinematic street scene at night, light rain falling, soft reflections on wet pavement, a stylish woman walking slowly toward the camera, gentle dolly-in movement, neon glow, shallow depth of field, elegant and atmospheric mood.

Pricing

• Total price: per-second rate × duration

Best Use Cases

• Ad creatives — Generate short cinematic promo videos from detailed campaign concepts.
• Social media content — Create vertical, square, or landscape videos for different platforms.
• Concept visualization — Turn written ideas into motion previews for pitching, ideation, or storyboarding.
• Brand storytelling — Build polished mood-driven clips with specific lighting, movement, and atmosphere.
• Creative prototyping — Explore different visual directions before committing to full production.
• Short-form cinematic scenes — Generate expressive clips for teasers, motion concepts, and narrative experiments.

Pro Tips

• Be specific in your prompt about subject, action, camera movement, lighting, and mood.
• Mention visual style clearly, such as cinematic, commercial, dreamy, realistic, or editorial.
• Use 480p for quick, low-cost drafts, then switch to 720p or 1080p for final outputs.
• Pick the aspect ratio based on the final destination: 9:16 for short-form mobile, 16:9 for widescreen, and 1:1 for square layouts.
• Reuse the same seed when you want more reproducible outputs.
• Start with shorter durations to validate motion and composition before generating longer clips.

Related Models

• Alibaba Happy Horse 1.1 Image-to-Video — Animate a reference image into a cinematic video clip.

## Authentication

For authentication details, please refer to the [Authentication Guide](/api-authentication).

## API Endpoints

### Submit Task & Query Result

<ApiTabs submitUrl={model.submitUrl} resultUrl={model.resultUrl} payload={model.defaultValues} />

## Parameters

### Task Submission Parameters

#### Request Parameters

<RequestParams params={model.params} conditions={model.conditions} />

Every model also accepts the global request options [`enable_sync_mode`](/sync-mode) and [`enable_base64_output`](/base64-output); see their pages for details.

#### Response Parameters

<SubmitResponse />

#### Result Request Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| id | string | Yes | - | Task ID |

#### Result Response Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., "success") |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction |
| data.model | string | Model ID used for the prediction |
| data.outputs | array&lt;string \| object&gt; | Array of generated outputs (empty when status is not completed). Items are usually URL strings, but may be text strings or structured result objects, depending on the model. |
| data.urls | object | Object containing related API endpoints |
| data.status | string | Status: `completed` is successful; `failed`, `cancelled`, `timeout`, and `deleted` are failure terminal statuses |
| data.created_at | string | ISO timestamp of when the request was created |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |