Alibaba
HappyHorse 1.0
happyhorse-1.0
A single generation jointly produces video and natively synchronized audio, supports multilingual lip sync and up to 1080p output in multiple aspect ratios, making it suitable for talking-head and dialogue-based short videos
Try happyhorse-1.0
Input
Showcases
View all showcasesOutput
Pricing
happyhorse-1.0 per second
| Specifications | Unit Price |
|---|---|
| 720P | $0.168 |
| 1080P | $0.288 |
Positioning Overview
HappyHorse 1.0 is a text-to-video model for short-video creation, called through the unified HiAPI.ai interface. Developers can input a text description to get a finished clip, with configurable durations of 3–15 seconds, 720p/1080p resolutions, and five aspect ratios including landscape, portrait, and square. It suits developers who need to rapidly produce short-video assets for social platforms, especially for multi-aspect-ratio adaptation, talking-head content prototypes, and image-to-motion clip scenarios.
Core Highlights
- Produce a short video with an audio track in one call — Research results show the model jointly produces visuals and native audio in the same generation, covering dialogue, sound effects, and ambient sound, which can reduce post-production dubbing and sound-effect work.
- Output specs adjustable by publishing channel — The schema supports durations of 3–15 seconds, 720p/1080p resolutions, and five aspect ratios: 16:9, 9:16, 1:1, 4:3, and 3:4, so landscape and portrait assets can be completed within the same interface.
- Seed control for reproducibility — A seed parameter in the range 0–2147483647 is provided; the same prompt and seed combination can reproduce results, making it easy to locate and debug during batch generation.
Capability Description
Text-to-video and audio-visual sync: Generate a video by passing only a text prompt; research results show that dialogue, sound effects, and ambient sound are jointly produced in the same generation, suitable for scenarios that need a finished clip rather than a silent film.
Multi-aspect-ratio and resolution adaptation: Specify output specs directly through the aspect_ratio and resolution parameters; one integration can produce landscape, portrait, square, and other versions without secondary cropping.
Fine control over duration and seed: duration supports second-by-second configuration from 3–15 seconds, and seed supports a fixed random seed to reproduce results, making it easy to maintain stylistic consistency or run A/B comparisons in batch production.
Lip sync (specific languages only): Research results show the model has phoneme-level lip-sync capability, explicitly covering 7 languages: Mandarin, Cantonese, English, Japanese, Korean, German, and French; other languages are not stated in the materials.
Use Cases
- Social platform operations: multi-aspect-ratio short-video assets — Input product selling points or scene descriptions to generate multiple versions such as 16:9 and 9:16 in one go, directly usable as ad assets for channels like Douyin, WeChat Channels, and YouTube.
- Content teams: talking-head and dialogue clip prototypes — Input prompts containing dialogue setups to get short videos of speakers with synchronized audio tracks, used to quickly validate script feasibility before deciding whether to proceed to formal shooting.
- Advertising and marketing: rapid drafts — Generate 3–15 second clips with sound from short copy, serving as dynamic drafts during the proposal stage and reducing production costs when communicating creative directions with clients.
- Narrative creation: rapid rehearsal of dialogue scenes — Input scene and character descriptions to generate short clips with ambient sound, used for rhythm and atmosphere rehearsal during short-film or storyboard stages.
Limitations and Selection Advice
The maximum duration of a single generation is 15 seconds, so it is not suitable for directly producing long-form content or continuous narratives. Lip sync explicitly covers only 7 languages: Mandarin, Cantonese, English, Japanese, Korean, German, and French; dialogue effects in other languages lack supporting materials. Research results conflict regarding developer and licensing information, so when selecting, refer to upstream official information. If the requirement is multi-shot cinematic control, reference-image guidance, or precise camera movement, evaluate other models that emphasize controllability.
Frequently asked questions
View all FAQs →-
What type of video model is HappyHorse 1.0?
It is a pure text-to-video route and does not require an opening image.
-
Which output settings does HappyHorse 1.0 support?
3-15 seconds, 720p, 1080p, and 16:9, 9:16, 1:1, 4:3, 3:4.
-
Can it generate sound or use audio references?
No media input; audio behavior follows the model contract
-
How is HappyHorse 1.0 billed?
Billing follows output duration and the live tier. Resolution, mode, or audio differences are reflected by the page price and task record.
Create a generation task
https://api.hiapi.ai/v1/tasks Headers
AuthorizationstringRequiredAccount API key. Required on every request. Example: Bearer YOUR_HIAPI_API_KEY. Get your API key
Content-TypestringOptionalThe request body is always parsed as JSON; when sent, only application/json (optionally with charset) is accepted — any other value returns 415. Example: application/json.
Idempotency-KeystringOptionalIdempotency key, up to 255 bytes. Retries with the same key from the same account create the task only once; replays return the original taskId.
On network timeouts or client retries, the same key creates the task only once — no double charges (scope: the API key's account). Use a business-unique identifier as the key (e.g. "order-42"); replays return the original taskId, and keys expire 24 hours after the first request. See the Unified Async API overview for the full scenario matrix.
Body
modelstringRequiredCurrent fixed value: happyhorse-1.0
routestringOptionalCurrent fixed value: default
inputobjectRequired
Business parameters for happyhorse-1.0 and route default — see the parameter table below.
seedintegerOptionalmin 0max 2147483647Random seed used for reproducible generation. Pass an integer to fix randomness so that generation results stay consistent under the same input.
promptstringRequiredminLength 1maxLength 5000Text prompt describing the video content, scene, and style, passed as a string; it determines the subject and overall style of the generated footage.
durationintegerOptionalDefault: 5min 3max 15Duration of the output video in seconds, as an integer, default 5.
resolutionstringOptionalDefault: "1080p"Resolution of the output video, specified as a string, default 1080p.
720p1080paspect_ratiostringOptionalDefault: "16:9"Aspect ratio of the output video, specified as a string, default 16:9.
16:99:161:14:33:4callbackobjectOptional
Terminal-state notification config. When omitted, no callback is delivered — poll the task yourself. See the callback note below.
Provide callback.url when creating a task and HiAPI POSTs to your service once the task reaches a terminal state — no polling needed. The callback payload mirrors the task detail structure; signature verification, delivery retries and idempotency are documented on the Unified Async API overview page.
urlstringRequiredRequired when callback is present. A POST is sent to this URL once the task reaches a terminal state; must be a valid http(s) URL.
whenstringOptionalDefault: "final"Only final is supported today — notified on both success and fail.
finalstoragestringOptionalDefault: "temp"Artifact storage tier: temp (default, retained about 7 days) or persistent (long-term, billed by size). Insufficient balance or exceeding the storage cap silently downgrades to temp; the effective tier is shown in the task detail response.
temppersistentRequest examples
# Submit an async task; returns a taskId immediately (no waiting for generation)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "happyhorse-1.0",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "1080p",
"aspect_ratio": "16:9"
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "happyhorse-1.0",
input: {
"prompt": "…",
"duration": 5,
"resolution": "1080p",
"aspect_ratio": "16:9"
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "happyhorse-1.0",
"input": {
"prompt": "…",
"duration": 5,
"resolution": "1080p",
"aspect_ratio": "16:9"
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Get task detail
https://api.hiapi.ai/v1/tasks/:id Response fields
taskIdstringRequiredTask ID, always prefixed with tk-hiapi-.
modelstringRequiredResolved full model name. Tasks submitted with the route parameter return base@route (e.g. gpt-image-2/text-to-image@ext); otherwise identical to the name passed at creation.
routestringOptionalPresent only when the task was submitted with an explicit route parameter; echoes the submitted value.
statusstringRequiredTask status.
queued Queued, not started yet.
handling Being processed.
archiving Processing finished, artifacts being prepared.
success Terminal: completed, artifacts available (output returned).
fail Terminal: failed (error returned).
After submission, check status: success and fail are terminal, everything else is non-terminal. Poll every 1–3 seconds until terminal. On success, download artifacts from output[].url and transfer them before expireAt; pass storage: "persistent" at creation time when long-term retention is needed.
creatednumberRequiredTask creation time (Unix seconds).
completednumberRequiredUnix seconds when the task reached a terminal state; fixed to 0 while not terminal.
outputarrayOptional
Present only when status == success. Artifact list — always an array; a single task may return multiple types at once (e.g. video + first_frame).
Array [ object ]
Array items
urlstringRequiredArtifact URL, directly downloadable.
typestringRequiredCurrent possible values: video, image, audio, first_frame, last_frame, thumbnail; more may be added later.
expireAtnumberRequiredUnix seconds until which the artifact remains accessible; download or transfer before it expires.
errorobjectOptional
Present only when status == fail.
codestringRequiredBusiness error code.
messagestringRequiredError description.
Response examples
Success
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} Processing (non-terminal)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Failed
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articles
View all articles →Related Models
View all models →Same Type
-
FLUX 3 Max Black Forest Labs $0.061 /second -
Kling 2.5 Kuaishou $0.060 /second -
Kling 3.0 Kuaishou $0.100 /second -
Kling 3.0 Turbo Kuaishou $0.130 /second -
Veo 3.1 Lite Google $0.060 /second -
Vidu Q4 Preview Vidu $0.051 /second -
PixVerse V6 PixVerse $0.036 /second -
Grok Imagine 1.5 Lite xAI $0.029 /second -
Runway Gen 4.5 Runway $0.172 /second -
Creatify Boreal Creatify $0.015 /second -
LTX 2.5 Fast Lightricks $0.086 /second -
Grok Imagine 1.5 xAI $0.011 /second
Same Provider
-
Qwen Image 2.0 Alibaba $0.042 /image -
Wan 2.7 Video Alibaba $0.100 /second -
Qwen Image 2.1 Alibaba $0.020 /image -
Z-Image Alibaba $0.008 /image -
Wan 2.6 Flash Alibaba $0.043 /second -
HappyHorse 1.1 Alibaba $0.160 /second -
Wan 2.7 Image Alibaba $0.035 /image -
Qwen Image 3.0 Alibaba $0.036 /image -
Qwen Audio 3.0 TTS Alibaba $0.030 /1,000 characters -
Wan 3.0 Video Alibaba $0.040 /second