The safety checker cannot be disabled on the playground. This property is only available through the API.
1080p: 32 credits/s x 6s = 192 credits
Example Output
Generate your own video to see real task data.
UVB0QUVMBQASUWU8
finished
2026-05-11T17:42:05
100%
Happy Horse API for Multimodal Video Generation and Editing
Happy Horse is Alibaba's video model for short-form generation and editing. Vidgo API exposes it through one async API shape for text-to-video, image-to-video, reference-to-video, and video-edit workflows.
Use prompts for direct generation, upload one first-frame image for image-to-video, provide ordered reference images for character or style guidance, or edit an existing source video with natural language instructions.
Happy Horse API Workflows
Text to Video
Generate short videos from a prompt with selectable aspect ratio, resolution, duration, seed, and safety checker controls.
Image and Reference to Video
Use one first-frame image for image-to-video, or use ordered reference images when a prompt needs to preserve visual identity, style, or subject details.
Video Edit
Upload a source video and describe the edit. Optional reference images can guide the transformation, while audio handling can be automatic or preserve the original audio.
Key Features of Happy Horse API
Happy Horse combines cinematic prompt following, first-frame animation, and explicit output controls in one async Vidgo API workflow.
Prompt-Driven Cinematic Video
Generate polished short clips directly from natural-language prompts. Happy Horse is suited for cinematic motion, visual concepts, campaign hooks, story beats, and social video ideas where the scene needs to follow a written direction.
- Create videos from prompt-only input
- Guide scene, motion, camera, and visual style
- Use the same submit, status, and callback flow
First-Frame Image Animation
Start from one image when the opening composition, product view, character art, or concept frame needs to stay recognizable. Add a prompt to guide how the still image should move, transform, or unfold.
- Use one image as the first frame
- Guide motion with an optional prompt
- Animate products, portraits, and concept frames
Resolution, Duration, and Aspect Controls
Choose output settings that match the product surface, from low-cost 720p drafts to sharper 1080p results. Generation workflows support short 3-15 second clips and common horizontal, vertical, square, and portrait aspect ratios.
- Select 720p or 1080p output
- Generate 3-15 second clips
- Use 16:9, 9:16, 1:1, 4:3, or 3:4 aspect ratios
Who Can Benefit from Happy Horse API?
Marketing and Social Teams
Turn campaign ideas into short clips, hooks, product teasers, and vertical social concepts using prompt-only generation, first-frame animation, or reference-guided scenes.
E-commerce and Product Teams
Animate product stills, lifestyle images, or branded reference assets into motion tests for launches, product detail pages, ads, and marketplace creative.
Film and Production Teams
Prototype camera movement, lighting, scene blocking, short narrative beats, and video-edit transformations before committing time to manual production.
Character and Story Creators
Use ordered reference images to guide subject identity, outfit details, art direction, and recurring visual language across short-form story experiments.
Design and Brand Studios
Explore cinematic, photoreal, stylized, anime, or branded motion directions from the same model while keeping aspect ratio and resolution choices explicit.
Developers and AI Apps
Build video generation, editing, polling, and webhook workflows around one public model ID while supporting text, image, reference, and source-video inputs.
Happy Horse API Workflow Comparison
Happy Horse supports multiple ways to create or transform short videos. Choose the workflow based on the media you already have and how much visual guidance the result needs.
| Workflow | Input | Prompt | Best Fit |
|---|---|---|---|
| Text to Video | No media required | Required | Fast concept generation from a written scene |
| Image to Video | One image_url | Optional | Animating a first frame, product image, portrait, or concept frame |
| Reference to Video | 1-9 reference_image_urls | Required | Maintaining subject identity, outfit details, style, or recurring visual language |
| Video Edit | video_url plus optional reference_image_urls | Required | Transforming an existing clip while preserving timing, subject movement, or camera rhythm |
All workflows use the same public model ID: happy-horse. Available controls and limits reflect the current Vidgo API integration.
How to Use Happy Horse API on Vidgo API
Step 1: Create an API key.
Sign in to Vidgo API and create a key for authenticated requests.
Create API Key ->
Step 2: Pick the workflow.
Use text-only input for prompt generation, image_urls for one first-frame image, reference_image_urls for reference-to-video, or video_url for video edit.
Step 3: Submit and poll.
Send the request to POST /api/generate/submit, then poll GET /api/generate/status/{task_id} or provide callback_url for completion callbacks.
View Documentation ->
Happy Horse API Pricing: Generation, Reference, and Video Edit
Text / Image / Reference workflows
720p: 16 credits per second ($0.08/s) compared with Fal.ai at $0.14/s
1080p: 32 credits per second ($0.16/s) compared with Fal.ai at $0.28/s
Video Edit workflow
720p: 32 credits per second ($0.16/s) compared with Fal.ai at $0.28/s
1080p: 64 credits per second ($0.32/s) compared with Fal.ai at $0.56/s
✓ Text-to-video, image-to-video, reference-to-video, and video-edit use the same public model ID
✓ Generation and reference workflows use duration-based billing for 3-15 second videos
✓ Video-edit billing uses the probed source video duration, capped at 15 seconds
✓ Vidgo API is about 43% lower than the Fal.ai reference rates shown above
No subscription requirement for API usage - pay with credits as you generate.
Frequently Asked Questions about Happy Horse API
What model ID should I use?
happy-horse for all Happy Horse workflows.What workflows are supported?
Can I combine image_urls and reference_image_urls?
image_urls for image-to-video or reference_image_urls for reference-to-video. In video-edit, reference_image_urls can be used as optional edit references.What resolutions and durations are supported?
720p and 1080p. Generation workflows support 3 to 15 seconds. Video-edit accepts source videos from 3 to 60 seconds and bills up to the first 15 seconds.How does video-edit audio handling work?
audio_setting in video-edit mode. auto lets Happy Horse decide audio handling, while origin preserves the original audio.Why Use Vidgo API for Happy Horse
One API for Four Workflows
Use <code>happy-horse</code> for text-to-video, image-to-video, reference-to-video, and video-edit instead of wiring separate endpoints for each workflow.
Reference and Edit Ready
Pass one first-frame image, 1-9 reference images, or a source video with optional edit references, so apps can support both generation and transformation use cases.
Async API Workflow
Submit tasks, poll status, or receive callbacks using the same async pattern as other Vidgo video models.
Lower Than Fal.ai Reference
Compare spend by workflow, resolution, and billable seconds: Vidgo API is about 43% lower than the Fal.ai reference rates shown for Happy Horse.
720p and 1080p Controls
Expose clear quality choices for fast 720p iteration or higher-detail 1080p output across generation and video-edit workflows.
Part of a Larger Model Stack
Offer Happy Horse next to Kling, Seedance, Wan, Sora, image, and music APIs through the same Vidgo account, billing, status, and dashboard experience.