Happy Horse 1.1 Reference to Video

Name: Alibaba Happy Horse 1.1 Reference to Video
Price: 0.7 USD
Availability: InStock
Author: Alibaba

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.

Try the model

Playground

Open playground

Input

Prompt(string)

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.

Image Urls(array)

Upload

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.

Additional Settings More

Customize your input with more control.

Resolution(string)

Output video resolution tier. Allowed values: 480p, 720p, 1080p.

Duration(integer)

Output video duration in seconds (3-15). Allowed values: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.

Aspect Ratio(string)

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.

Seed(integer)

Random seed for reproducibility (0-2147483647).

Result

Example

What would you like to do next?
Open original

Examples

Select an example to load its inputs and result into the playground.

Input

{
  "duration": 3,
  "images": [
    "https://static.sandbase.ai/examples/15f1d2b2-01e3-4f0d-a112-2cfb84ceafde/input/7d424001-95e4-46ed-a097-62db3b5f6022.jpg"
  ],
  "prompt": "[Image 1] waves at the camera in a park",
  "resolution": "720p"
}

Open result ↗

Happy Horse 1.1 Reference to Video

Cast subjects from reference images into a new Happy Horse 1.1 scene. Refer to each image by number in the prompt to keep its look while the scene plays out.

Fields

Field	Type	Default	Notes
`prompt`	string, required	—	Text instruction.
`images`	image URL[], required	—	Reference images, Image 1, Image 2, …
`resolution`	`480p` / `720p` / `1080p`	`720p`	Sets the per-second rate.
`duration`	3–15	5	Output length in seconds.
`aspect_ratio`	`21:9` / `16:9` / `3:2` / `4:3` / `5:4` / `1:1` / `4:5` / `3:4` / `2:3` / `9:16`	`16:9`	Output frame shape.
`seed`	integer	random	Fix it to compare prompt changes.

Billing

You pay for output seconds: $0.07 at 480p, $0.14 at 720p, and $0.18 at 1080p, Alibaba's list price.

Output	480p	720p	1080p
3s	$0.21	$0.42	$0.54
5s (default)	$0.35	$0.70	$0.90
10s	$0.70	$1.40	$1.80
15s	$1.05	$2.10	$2.70

Failed runs are not charged.

Prompting

Give each reference a role: “Image 1 is the rider, Image 2 is the horse”.
Keep one clear subject per reference image.

Limits

Reference images only; reference videos are not accepted.

Also on SandBase

Other Happy Horse endpoints: alibaba/happy-horse/1.1/text-to-video, alibaba/happy-horse/1.1/image-to-video, alibaba/happy-horse/video-edit (edit an existing clip).

Start building

Send your first request

Submit this model through the SandBase Unified Run API.

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": "720p",
  "aspect_ratio": "16:9"
}
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"

2. Authentication

Create a SandBase API key and set it in your server environment. All requests use Bearer authentication.

API key environment variable

export SANDBASE_API_KEY="YOUR_API_KEY"

Keep the key on your server. Do not expose it in browser code or commit it to a repository.

3. Queue

Submit a request

POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.

Fetch request status and result

Use the returned run ID to poll until the status is completed, failed or timeout. Read output only after completed.

Poll run status

curl "https://api.sandbase.ai/v1/run/$RUN_ID" \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

4. Files

Hosted files

Pass a publicly accessible file URL in the model’s image, video or audio field. Supported formats and limits are shown beside each Playground input.

Uploading images

Use the upload or replace control on supported image fields in the Playground. Video URL fields accept a hosted driving video; they do not imply video-upload support.

5. Schema

Input

`seed`integer

Random seed for reproducibility (0-2147483647).

`images`arrayrequired

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.

`prompt`stringrequired

`duration`integer

Output video duration in seconds (3-15).

Default: 5

Possible values: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

`resolution`string

Output video resolution tier.

Default: "720p"

Possible values: "480p", "720p", "1080p"

`aspect_ratio`string

The aspect ratio of the generated image.

Default: "16:9"

Possible values: "21:9", "16:9", "3:2", "4:3", "5:4", "1:1", "4:5", "3:4", "2:3", "9:16"

Request body

{
  "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": "720p",
  "aspect_ratio": "16:9"
}

Output

A completed run exposes its result in output. The following is the model’s saved example, not a new generation.

Example output JSON

[
  {
    "poster": "https://static.sandbase.ai/examples/posters/560068e931254a41e9dd.jpg",
    "source": "Self organization completed prediction",
    "source_url": "https://www.sandbase.ai",
    "url": "https://static.sandbase.ai/examples/15f1d2b2-01e3-4f0d-a112-2cfb84ceafde/output/2861d5af-fe15-44d0-9e30-d995a5ebba5b.mp4"
  }
]

Happy Horse 1.1 Reference to Video

Playground

Examples

Happy Horse 1.1 Reference to Video

Fields

Billing

Prompting

Limits

Also on SandBase

Send your first request

2. Authentication

3. Queue

Submit a request

Fetch request status and result

4. Files

Hosted files

Uploading images

5. Schema

Input

seedinteger

imagesarrayrequired

promptstringrequired

durationinteger

resolutionstring

aspect_ratiostring

Output

Happy Horse Reference to Video ↗

Wan 2.6 Flash Reference to Video ↗

Wan 3.0 Prime Reference to Video ↗

Wan 3.0 Reference to Video ↗

Happy Horse 1.1 Image to Video ↗

Happy Horse 1.1 Text to Video ↗

`seed`integer

`images`arrayrequired

`prompt`stringrequired

`duration`integer

`resolution`string

`aspect_ratio`string