Alibaba Happy Horse 1.0 Image-to-Video

Overview

Happy Horse 1.0 Image-to-Video animates a reference image into a cinematic 720p / 1080p video, with optional text guidance for the motion. Strong subject preservation, smooth camera movement, and expressive motion.

Want to try HappyHorse 1.0 Image-to-Video? Head over to HappyHorse 1.0 Image-to-Video.

Why Choose HappyHorse 1.0?

Image-faithful generation

Preserves the reference image's subject, composition, and style while adding motion.Follows detailed instructions for scene composition, action, lighting, mood, and camera movement.

Optional prompt guidance

Direct the camera, mood, and action in plain language.

Cinematic motion

Smooth, expressive movement and stable subjects.

Production-ready API

Access the model through a REST inference API with no cold starts for easy integration into creative workflows.

Endpoint

POSThttps://openapi.joypix.ai/v1/alibaba/image-to-video

Headers

Name	Value	Required
Content-Type	application/json	Yes
Authorization	Bearer ${JoyPix_API_KEY}	Yes

Parameters

Parameter	Required	Description
model	Yes	The name of the model. Set to:happyhorse-1.0-i2v
prompt	Yes	Text prompt describing the desired video. Maximum 2500 characters.
images	Yes	[]string, First-frame image URL. JPEG / PNG / BMP / WEBP. Min dimension 300 px. Aspect ratio 1:2.5 to 2.5:1. Max 10 MB.
resolution	No	Output resolution: "720p" (default) or "1080p".
duration	No	Video length in seconds. Range: 3-15, default 5.
seed	No	Random seed for reproducibility. Range: 0-2147483647.

Example Request

{
  "model": "happyhorse-1.0-i2v",
  "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",
  "images": ["https://example.com/image1.jpg"],
  "resolution": "1080p",
  "duration": 5,
  "seed": 123456
}

Response

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_123456789"
  }
}

Get Task Status

Endpoint

GEThttps://openapi.joypix.ai/v1/tasks/${task_id}

Headers

Name	Value	Required
Authorization	Bearer ${JoyPix_API_KEY}	Yes

Response

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "task_123456789",
    "inputs": "...",
    "model": "happyhorse-1.0-i2v",
    "status": "completed",
    "error": "",
    "video_url": "https://joypix-output.s3.amazonaws.com/..." // Note: Data is only saved for 24 hours, please download it as soon as possible
  }
}

Pricing

Resolution	Cost
720p	14 credits/s ($0.14/s)
1080p	24 credits/s ($0.24/s)

Notes

Supported video duration is 3-15 seconds.
Aspect ratio of the output video matches the reference image automatically.