HappyHorse 1.0 API

Alibaba HappyHorse 1.0 for video from text, a first frame, or reference images at 720p or 1080p.

Warm Official Live Priced by route Data privacy Zero training API docs

Input

prompt*string

Describe the subject, motion, camera, lighting, and timing

route_modestring

Choose the provider route used for this request.

Lower-cost official route and the default for new requests and API keys.

generation_typestring

Select the generation workflow. The API mode updates with this choice.

aspect_ratiostring

Aspect ratio of the generated output

Default: "16:9"

resolutionstring

Higher resolutions may take longer to generate.

Default: "720p"

durationnumber

Length of the generated video in seconds

Output

Ready for a predictionAdjust the inputs, then run the model.

Quick start

Video API reference

Create an API key
Create a key in the console and save it as the MLMUX_API_KEY environment variable.
Create an API key
Send a request
Send the request to https://api.mlmux.com/v1/videos/generations with the model ID alibaba/happyhorse-1.0. The example uses this page's default settings; change the prompt and options as needed.
Read the result
The response is a task. Poll its poll_url every few seconds until status is succeeded, then download the video, or set up a webhook to be notified.

curl https://api.mlmux.com/v1/videos/generations \
  -H "Authorization: Bearer $MLMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "alibaba/happyhorse-1.0",
  "route_mode": "official-cheap",
  "prompt": "A red fox walks through fresh snow at sunrise, slow tracking shot, cinematic light",
  "mode": "text_to_video",
  "ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

# The response is a task. Poll it until "status" is "succeeded", then read "video".
curl https://api.mlmux.com/v1/videos/generations/TASK_ID \
  -H "Authorization: Bearer $MLMUX_API_KEY"

Examples

View more examples ↗

Pricing

Video is billed per second of output at the resolution you choose. The price changes with resolution and route.

Learn more about pricing ↗

All video rates

Per second of output video, by resolution. Billing follows the seconds the provider reports.

Resolution	official	official-cheap
720p	$0.138 / s	$0.125 / s
1080p	$0.246 / s	$0.222 / s

Readme

HappyHorse 1.0 is available through MLMux with one request shape and two explicit route tiers.

Three ways to start

Write a prompt, animate a starting image, or guide the clip with reference images.

720p or 1080p

Clips run 3 to 15 seconds at 720p or 1080p.

Choosing a HappyHorse model

HappyHorse 1.1 adds 480p and costs less at 1080p; HappyHorse 1.0 Video Edit changes an existing video.

Frequently asked questions

What is HappyHorse 1.0?

HappyHorse 1.0 is a video generation model from Alibaba. On MLMux you can run it in the browser or call it through one API. Alibaba HappyHorse 1.0 for video from text, a first frame, or reference images at 720p or 1080p.

How do I use the HappyHorse 1.0 API?

Create an API key in the MLMux Console, then send a POST request to https://api.mlmux.com/v1/videos/generations with the key in the Authorization header and model set to alibaba/happyhorse-1.0. The request returns a task: poll it, or receive a webhook when the video is ready.

What can HappyHorse 1.0 do?

Generation modes: Text to video, Image to video, and Multimodal reference. Clips run 3 to 15 seconds at 720p or 1080p, in aspect ratios such as 16:9, 9:16, 1:1, 4:3, and 3:4, with up to 9 reference images.

How much does HappyHorse 1.0 cost?

MLMux is pay as you go, with no subscription or monthly fee, and 1 credit equals 1 US dollar. One second of 720p HappyHorse 1.0 video costs $0.125 on the default official-cheap route and $0.138 on the official route. Rates for every resolution are listed in the pricing section of this page.

Can I try HappyHorse 1.0 without writing code?

Yes. Sign in and use the playground at the top of this page to run HappyHorse 1.0 with the same settings as the API. The playground's code views show the matching request for your settings, and the quick start below has copy-paste examples in cURL, Python, and JavaScript.