API Free WeekHundreds of APIs are free to call this week.Browse free APIs

Happy Horse 1.1 Reference to Video

alibaba/happy-horse/1.1/reference-to-video

Happy Horse 1.1 by Alibaba - animate still images into dynamic videos with AI. Transform photos into cinematic clips with natural motion, camera movement, and optional audio generation.

Base price
$0.90USD / run
Execution
async
Model type
video
Input fields
6

Try the model

Playground

Open playground
Input
Text prompt describing the desired video. Reference subjects from your images using ``character1``, ``character2``, ... up to ``character9`` (the order matches the order of ``image_urls``). Max 2500 characters.

PNG, JPEG, WebP, or GIF · 20 MiB maximum each

Reference images for subject consistency (1-9 images). Formats: JPEG, JPG, PNG, WEBP. Shortest side must be at least 400 px (720P or higher recommended). Max 20 MB each.
Output video resolution tier. Allowed values: 720p, 1080p.
Output video duration in seconds (3-15). Allowed values: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.
The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.
Random seed for reproducibility (0-2147483647).
OutputReady

Your output will appear here

Complete the inputs, then click Run.

Specifications

Pricing

Base price
$0.90 / run
Billing formula
(params.resolution ?? "1080p") == "1080p" ? (params.duration ?? 5) * 0.18 : (params.duration ?? 5) * 0.14

Context & modalities

Input
Schema-defined
Output
video

Capabilities

Chat
Not supported
Vision
Not supported
Reasoning
Not supported
Structured output
Not supported
Function calling
Not supported
Audio input
Not supported

Access

Provider
Alibaba
Model ID
alibaba/happy-horse/1.1/reference-to-video
Execution
async
API
Unified Run API
Endpoint
/v1/run

API README

Happy Horse 1.1 Reference to Video

Happy Horse 1.1 Reference to Video generates a short video with synchronized audio from 1 to 9 reference images and a written prompt. Refer to the references in the prompt as [Image 1], [Image 2], and so on to keep characters, products, and scenes consistent across the clip.

Highlights

  • Multi-reference consistency. Up to 9 reference images anchor subjects, outfits, props, and settings.
  • Prompt-directed motion. Describe action, camera movement, pacing, and mood in natural language.
  • Flexible delivery. 3 to 15 second clips at 720p or 1080p in common aspect ratios.

Pricing

Duration720p1080p
3 seconds$0.42$0.54
4 seconds$0.56$0.72
5 seconds$0.70$0.90
6 seconds$0.84$1.08
7 seconds$0.98$1.26
8 seconds$1.12$1.44
9 seconds$1.26$1.62
10 seconds$1.40$1.80
11 seconds$1.54$1.98
12 seconds$1.68$2.16
13 seconds$1.82$2.34
14 seconds$1.96$2.52
15 seconds$2.10$2.70

Billed per output second at the Alibaba Model Studio list price.

When to Use

  • Keep a character or product consistent while placing it in a new scene.
  • Combine several reference images into one coherent short clip.

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API
Unified Run API endpoint
https://api.sandbase.ai/v1/run
Model ID
alibaba/happy-horse/1.1/reference-to-video
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "alibaba/happy-horse/1.1/reference-to-video",
  "images": [
    "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png"
  ],
  "prompt": "A dance battle between character1 and character2, cinematic lighting, smooth camera movement.",
  "duration": 5,
  "resolution": "1080p"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All language models
ModelContextInput / 1MOutput / 1MReleased
Alibaba———Jun 22, 2026
Alibaba———Aug 24, 2026
Alibaba———Aug 24, 2026
Alibaba———Aug 24, 2026
Alibaba———Aug 24, 2026
Alibaba———Aug 24, 2026