Skip to main content
HappyHorse 1.0 T2V is the text-to-video model in Alibaba’s HappyHorse video generation series. Uses an asynchronous task interface — submit a task and poll until completion.

​
Key Capabilities

  • Text-to-video — Generate video from text description alone
  • Resolution — 720P / 1080P
  • Aspect ratio — 16:9, 9:16, 1:1, 4:3, 3:4
  • Duration — 3–15 seconds
  • Watermark control — Optionally disable the “Happy Horse” watermark in the bottom-right corner

​
Workflow

1. POST /v1/video/generations  →  task_id
2. GET  /v1/video/generations/{task_id}  →  Poll until SUCCESS / FAILURE
3. Read data.result_url  (valid for 24 hours)

​
Quick Example

# Step 1 — Create task
curl https://ai.alad.com/v1/video/generations \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "happyhorse-1.0-t2v",
    "prompt": "A cat running on a meadow",
    "parameters": {
      "resolution": "720P",
      "ratio": "16:9",
      "duration": 5,
      "watermark": false
    }
  }'

# Step 2 — Poll until complete
curl https://ai.alad.com/v1/video/generations/asyntask_xxx \
  -H 'Authorization: Bearer YOUR_API_KEY'

​
Parameters

Optional parameters can be placed at the request top level or inside the parameters object — both are equivalent.
ParameterTypeRequiredDescription
modelstringYesMust be happyhorse-1.0-t2v
promptstringYesVideo description text
resolutionstringNo720P / 1080P, default 1080P
ratiostringNo16:9, 9:16, 1:1, 4:3, 3:4, default 16:9
durationintegerNoVideo duration 3–15 seconds, default 5
watermarkbooleanNoDefault true, set to false to disable watermark
seedintegerNoRandom seed [0, 2147483647]

​
Billing

Billed by resolution tier × user-requested duration. The pre-charged amount is the final amount:
  • duration: 5 → charged for 5 seconds (even if the upstream actually generates 6 seconds, billed at 5)
  • Failed tasks are automatically refunded

API Reference

HappyHorse 1.0 T2V interactive Playground.

Task Query

Poll task status and retrieve the final video URL.