Happyhorse 1.0 Image To Video
Alibaba Happy Horse 1.0 (Image-to-Video) animates a reference image into a cinematic 720p / 1080p video, optionally guided by a text prompt. Smooth camera movement and expressive, stable motion. Ready-to-use REST API, best performance, no coldstarts, affordable pricing.
Key Features
- Animate still images into smooth, high-quality video with natural motion.
- Faithful to the source — preserves subject identity, composition and visual style during animation.
- Prompt-guided motion — control camera movement, subject actions and scene dynamics via text.
- Multiple duration options — generate clips from a few seconds up to the model maximum.
- Resolution support — 720p and 1080p.
- Consistent physics — realistic motion with proper object dynamics and lighting continuity.
Parameters
| Parameter | Required | Description |
|---|---|---|
| prompt | Yes | Text description of the motion and scene dynamics. |
| image | Yes | Source image URL to animate. |
| duration | No | Video length in seconds (default varies by model). |
| aspect_ratio | No | Output ratio: 16:9, 9:16, 4:3, 1:1 (default: matches input). |
| resolution | No | Output resolution: 720p, 1080p (default: 1080p). |
How to Use
- Upload a high-quality source image that you want to animate.
- Write a prompt describing the desired motion — camera movement, subject action, and mood.
- Set duration and resolution based on your needs.
- Generate and download your animated video clip.
Code Examples
import os
import requests
response = requests.post(
"https://aircube.ai/api/v3/happyhorse-1.0/image-to-video",
headers={
"Authorization": "Bearer " + os.environ["AIRCUBE_API_KEY"],
"Content-Type": "application/json",
},
json={
"prompt": "Camera slowly orbits around the subject, hair flowing gently in the breeze",
"image": "https://example.com/portrait.jpg",
"duration": 5
},
timeout=300,
)
data = response.json()
if data["success"]:
print("ID:", data["data"]["id"], "Status:", data["data"]["status"])
else:
print("Error:", data["error"]["message"])Pricing
| Resolution | Duration | Cost |
|---|---|---|
| 720p | 5s | $0.40 |
| 720p | 10s | $0.80 |
| 720p | 15s | $1.20 |
| 1080p | 5s | $0.71 |
| 1080p | 10s | $1.41 |
| 1080p | 15s | $2.12 |
Billing rules
- 720p / 5s: $0.40.
- 1080p / 5s: $0.71.
- Longer durations scale proportionally.
- Failed generations are not charged.
Best Use Cases
- Product animation — bring still product shots to life with subtle motion.
- Social media content — create eye-catching animated posts from static images.
- Ad creatives — transform hero images into engaging video ads.
- Character animation — animate character art or portraits with expressive motion.
- Scene storytelling — extend a keyframe into a full cinematic sequence.
Pro Tips
- Upload high-resolution, clean images for best motion quality.
- Describe camera movement (zoom in, pan left, orbit around) for cinematic results.
- Start with short durations (3-5s) to iterate quickly, then extend for final renders.
- Keep the subject centered in the source image for more stable animation.
- Mention specific actions (walking, waving, flowing) for directed character motion.
Notes
- Input images should be under 10 MB (JPEG, PNG, WebP).
- Video output is typically MP4 format.
- Generation time varies with duration and resolution — longer clips take more time.