happyhorse

Install the belt CLI skill: npx skills add belt-sh/cli

HappyHorse 1.0 Video Generation

Generate and edit physically realistic videos with Alibaba's HappyHorse 1.0 models via inference.sh CLI.

Quick Start

Requires inference.sh CLI (belt). Install instructions

belt login

belt app run alibaba/happyhorse-1-0-t2v --input '{"prompt": "a horse galloping across a sunlit meadow"}'

HappyHorse Models

Model	App ID	Best For
T2V	alibaba/happyhorse-1-0-t2v	Text-to-video, physically realistic motion
I2V	alibaba/happyhorse-1-0-i2v	Animate a single image
R2V	alibaba/happyhorse-1-0-r2v	Preserve characters from up to 9 reference images
Video Edit	alibaba/happyhorse-1-0-video-edit	Edit existing videos with natural language

All models support 720P/1080P resolution, up to 15 seconds duration.

Examples

Text-to-Video

belt app run alibaba/happyhorse-1-0-t2v --input '{
  "prompt": "a golden retriever running through autumn leaves in a park, slow motion",
  "duration": 10,
  "resolution": "1080P",
  "ratio": "16:9"
}'

Image-to-Video

Animate a still image:

belt app run alibaba/happyhorse-1-0-i2v --input '{
  "first_frame": "https://your-image.jpg",
  "prompt": "gentle camera zoom, clouds moving in the sky",
  "duration": 8,
  "resolution": "720P"
}'

Reference-to-Video (Character Preservation)

Generate videos that preserve characters from reference images (up to 9):

belt app run alibaba/happyhorse-1-0-r2v --input '{
  "prompt": "a woman walking through a busy market street",
  "reference_images": ["https://portrait.jpg"],
  "duration": 10,
  "resolution": "720P"
}'

Multi-Character Reference

belt app run alibaba/happyhorse-1-0-r2v --input '{
  "prompt": "two friends sitting at a cafe having coffee",
  "reference_images": ["https://person1.jpg", "https://person2.jpg"],
  "ratio": "16:9"
}'

Video Editing

Edit existing videos using natural language instructions:

belt app run alibaba/happyhorse-1-0-video-edit --input '{
  "video": "https://your-video.mp4",
  "prompt": "change the background to a snowy mountain landscape"
}'

Video Editing with Reference Images

belt app run alibaba/happyhorse-1-0-video-edit --input '{
  "video": "https://your-video.mp4",
  "prompt": "replace the person with the character from the reference image",
  "reference_images": ["https://character.jpg"]
}'

Video Editing with Audio Control

belt app run alibaba/happyhorse-1-0-video-edit --input '{
  "video": "https://your-video.mp4",
  "prompt": "make the scene look like a rainy day",
  "audio_setting": "generate"
}'

Pricing

Resolution	Price
720P	$0.14 per second
1080P	$0.24 per second

Video Edit is billed on input + output duration.

Parameters (T2V)

Parameter	Type	Default	Description
prompt	string	required	Text description of the video
duration	integer	5	Duration in seconds (3–15)
resolution	enum	720P	720P or 1080P
ratio	enum	16:9	16:9, 9:16, 1:1, 4:3, 3:4, 21:9
seed	integer	random	Reproducible generation
watermark	boolean	false	Add HappyHorse watermark

Parameters (I2V)

Parameter	Type	Default	Description
first_frame	file	required	First frame image (JPEG, PNG, WebP)
prompt	string	-	Optional text description
duration	integer	5	Duration in seconds (3–15)
resolution	enum	720P	720P or 1080P
seed	integer	random	Reproducible generation

Parameters (R2V)

Parameter	Type	Default	Description
prompt	string	required	Text description of the scene
reference_images	array	required	Up to 9 character reference images
duration	integer	5	Duration in seconds (3–15)
resolution	enum	720P	720P or 1080P
ratio	enum	16:9	16:9, 9:16, 1:1, 4:3, 3:4, 21:9
seed	integer	random	Reproducible generation

Parameters (Video Edit)

Parameter	Type	Default	Description
video	file	required	Video to edit (MP4/MOV, H.264)
prompt	string	required	Editing instruction
reference_images	array	-	Up to 5 reference images
audio_setting	enum	auto	auto, generate, or keep_original
resolution	enum	720P	720P or 1080P
seed	integer	random	Reproducible generation

Search HappyHorse Apps

belt app search "happyhorse"

Related Skills

# Full platform skill (all apps)
npx skills add inference-sh/skills@infsh-cli

# All video generation models
npx skills add inference-sh/skills@ai-video-generation

# Seedance 2.0
npx skills add inference-sh/skills@seedance

# Google Veo
npx skills add inference-sh/skills@google-veo

# Image generation (for image-to-video)
npx skills add inference-sh/skills@ai-image-generation

Browse all video apps: belt app list --category video

Documentation

• Running Apps - How to run apps via CLI
• Streaming Results - Real-time progress updates
• Content Pipeline Example - Building media workflows