Skip to main content
HappyHorse 1.0 I2V animates a single first-frame image into a short video. Uses an asynchronous task interface — submit a task and poll until completion.

​
Key Capabilities

  • Image-to-video — Use one image as the first frame, with text description driving motion
  • Resolution — 720P / 1080P
  • Aspect ratio — 16:9, 9:16, 1:1, 4:3, 3:4
  • Duration — 3–15 seconds
  • Watermark control — Optionally disable the bottom-right watermark

​
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

curl https://ai.alad.com/v1/video/generations \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "happyhorse-1.0-i2v",
    "prompt": "Camera slowly zooms in, the scene comes to life",
    "image": "https://example.com/first-frame.png",
    "parameters": {
      "resolution": "720P",
      "duration": 5,
      "watermark": false
    }
  }'
The image field accepts a single URL. You can also use the images: [...] array form (only the first image is used as the first frame).

​
Parameters

ParameterTypeRequiredDescription
modelstringYesMust be happyhorse-1.0-i2v
promptstringYesDescription of the motion effect
imagestringYesFirst-frame image URL
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. Failed tasks are automatically refunded.

API Reference

HappyHorse 1.0 I2V interactive Playground.

Task Query

Poll task status and retrieve the final video URL.