Skip to content

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

HappyHorse 1.1 API — Python wrapper

Call HappyHorse 1.1 from Python with one function per endpoint: text-to-video, image-to-video, reference-to-video, video extension. Built on the official wavespeed SDK and the WaveSpeedAI hosted API — no GPU, pay per generation.

HappyHorse 1.1 API Try in browser

Quick start

pip install git+https://github.com/WaveSpeedAI/happyhorse-1.1-api.git
export WAVESPEED_API_KEY="your-api-key"   # https://wavespeed.ai/accesskey
import happyhorse_api

urls = happyhorse_api.text_to_video(
    prompt="A slow cinematic dolly shot through a rain-soaked neon night market, reflections on the pavement",
)
print(urls[0])

Every function waits for the generation to finish and returns a list of output URLs. Optional arguments you leave out are not sent, so the API defaults apply. Inputs such as images, videos and audio are passed as URLs; use happyhorse_api.upload("local-file") to get a URL for a local file.

Endpoints

Function Model Type
text_to_video() alibaba/happyhorse-1.1/text-to-video text-to-video
image_to_video() alibaba/happyhorse-1.1/image-to-video image-to-video
reference_to_video() alibaba/happyhorse-1.1/reference-to-video reference-to-video
video_extend() alibaba/happyhorse-1.1/video-extend video-extend

Each model page has a playground, live pricing and copy-paste API snippets. Prices are per generation and depend on the settings you choose; check a request before running it with wavespeed price <model> from the CLI.

Parameters

text_to_video

alibaba/happyhorse-1.1/text-to-video — Alibaba Happy Horse 1.1 (Text-to-Video) generates cinematic 720p / 1080p videos from text prompts with smooth camera movement, expressive motion, and strong prompt fidelity.

Parameter Type Required Default Allowed Description
prompt str yes Text prompt describing the desired video. Max 2500 characters.
aspect_ratio str "16:9" 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 The aspect ratio of the generated video.
resolution str "720p" 480p, 720p, 1080p Output video resolution.
duration int 5 3–15 Video length in seconds (3-15).
seed int Random seed for reproducibility.

image_to_video

alibaba/happyhorse-1.1/image-to-video — Alibaba Happy Horse 1.1 (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.

Parameter Type Required Default Allowed Description
prompt str yes Optional text prompt guiding the animation. Max 2500 characters.
image str yes URL of the first-frame image. JPEG / PNG / BMP / WEBP. Min dimension 300px. Aspect ratio between 1:2.5 and 2.5:1. Max 10 MB.
resolution str "720p" 480p, 720p, 1080p Output video resolution.
duration int 5 3–15 Video length in seconds (3-15).
seed int Random seed for reproducibility.

reference_to_video

alibaba/happyhorse-1.1/reference-to-video — Alibaba Happy Horse 1.1 (Reference-to-Video) generates new video scenes guided by reference images, maintaining consistent characters, styles, and visual identity. Smooth camera movement and expressive, stable motion.

Parameter Type Required Default Allowed Description
prompt str yes Text description of the desired scene. Refer to reference images as [Image 1], [Image 2], ... in array order.
images List[str] yes up to 9 items Array of reference image URLs (1-9).
resolution str "720p" 480p, 720p, 1080p Output video resolution.
aspect_ratio str "16:9" 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4, 9:21, 21:9 The aspect ratio of the generated video.
duration int 5 3–15 Video length in seconds (3-15).
seed int Random seed for reproducibility.

video_extend

alibaba/happyhorse-1.1/video-extend — Alibaba Happy Horse 1.1 (Video Extend) extends existing videos with seamless AI-generated continuation, supporting 720p/1080p output. Natural, motion-consistent extension.

Parameter Type Required Default Allowed Description
prompt str yes Text description of the desired continuation.
video str yes The source video to extend.
resolution str "720p" 480p, 720p, 1080p Output video resolution.
duration int 5 3–15 Total duration of the final output video in seconds (3-15).
seed int Random seed for reproducibility.

REST and CLI

The wrapper is a thin layer over the REST API: submit, then poll for the result.

curl -s -X POST "https://api.wavespeed.ai/api/v3/alibaba/happyhorse-1.1/text-to-video" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" -H "Content-Type: application/json" \
  -d '{"prompt": "A slow cinematic dolly shot through a rain-soaked neon night market, reflections on the pavement"}'
# -> {"data": {"id": "<prediction_id>"}}

curl -s "https://api.wavespeed.ai/api/v3/predictions/<prediction_id>/result" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY"
# -> status: completed, outputs: ["<url>"]
npm i -g @wavespeed/cli && wavespeed login
wavespeed run alibaba/happyhorse-1.1/text-to-video -p "your prompt"

Related

Notes

  • HappyHorse 1.1 is a model by Alibaba. This repository is maintained by WaveSpeedAI and wraps the WaveSpeedAI hosted API for it.
  • Function signatures and the tables above are generated from the live model schemas (last generated 2026-11-22). The model pages are the source of truth if an endpoint changes.
  • Issues and pull requests are welcome. License: MIT.

Releases

Packages

Used by

Contributors

Languages