Happy Horse API

What is Happy Horse API

Happy Horse 1.1 is an API for AI video generation, developed by Alibaba. It allows users to generate 720p or 1080p videos from text prompts and up to nine reference images. The API supports synchronized audio and delivers results via webhooks.

How to use Happy Horse API

To use the Happy Horse 1.1 API, you need to make a POST request to /v2/videos/generate. This request should include your API key in the headers and a JSON body containing the prompt, model identifier (happyhorse-1.1), and specific parameters for Happy Horse 1.1. You can optionally provide reference image URLs, desired resolution, aspect ratio, and a seed for reproducibility. The API will return a jobId that you can use to poll for the job status, or you can provide a webhook_url to receive the result automatically when it's ready.

Features of Happy Horse API

• Multiple Generation Modes: Supports text-to-video (no images), image-to-video (one image), and reference-to-video (two to nine images).
• Reference Image Consistency: Up to nine reference images can be used to maintain consistent subjects and scenes in the generated video, referenced in the prompt as [Image 1], [Image 2], etc.
• High Resolution: Generates videos in both 720p and 1080p.
• Synchronized Audio: Includes synchronized audio generated within the same pass.
• Flexible Durations: Supports clip lengths from 3 to 15 seconds.
• Multiple Aspect Ratios: Offers generation in 16:9, 9:16, 1:1, 4:3, and 3:4.
• Webhook Delivery: Results can be delivered via webhooks for asynchronous processing.
• Reproducibility: A seed parameter allows for reproducing the same result.

Use Cases of Happy Horse API

• Reference-Driven Video: Ideal for creating social media content and product videos where specific subjects, characters, or styles need to be maintained consistently.
• E-commerce Listings: Generate moving assets for product listings by using product stills as reference images.
• High-Volume Content Creation: Suitable for generating large quantities of video content for feeds due to its per-second pricing and multiple aspect ratio options.

Pricing

Pricing is based on credits per second of output:

• 720p: 24 credits/second
• 1080p: 31 credits/second

A 10-second 1080p clip costs 310 credits. Pricing depends on the resolution and selected options. Volume discounts are available for larger plans. Users start with free credits, and no subscription is required.

FAQ

• How is the generation mode chosen? It depends on the number of images you pass in happyhorse11Params.images: none = text-to-video, one = image-to-video, two to nine = reference-to-video.
• How do reference images work? Pass up to nine images and mention them in the prompt as [Image 1], [Image 2], etc. Happy Horse 1.1 keeps those subjects and scenes consistent in the output.
• What does Happy Horse 1.1 cost? Pricing is per second of output: 24 credits/second at 720p and 31 credits/second at 1080p. A 10-second 1080p clip is 310 credits.