alibaba/happy-horse/video-edit

Name: Happy Horse Video Edit
Author: Alibaba

Happy Horse Video Edit by Alibaba - AI-powered video editing and transformation. Apply style transfer, motion control, lip-sync, and visual effects to existing videos with natural language instructions.

Input

Prompt(string)

Text prompt describing the desired edit. Reference any supplied reference images using @Image1, @Image2, ... up to @Image5. Max 2500 characters.

Video Url(string)

URL of the source video to edit. Formats: MP4, MOV (H.264 recommended). Duration: 3-60 s. Longer side ≤ 2160 px, shorter side ≥ 320 px. Aspect ratio between 1:2.5 and 2.5:1. Frame rate > 8 fps. Max 100 MB. The output video preserves the source aspect ratio. Output duration matches the input video, capped at 15 s (longer inputs are truncated to the first 15 s). Max file size: 100.0MB, Min duration: 3s, Max duration: 60s, Timeout: 30.0s

Resolution(string)

Output video resolution tier. Allowed values: 720p, 1080p.

Seed(integer)

Random seed for reproducibility (0-2147483647).

Image URL or upload(array)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum each

Optional reference images used to guide the edit (up to 5). Formats: JPEG, JPG, PNG, WEBP. Dimensions must be at least 300px. Aspect ratio between 1:2.5 and 2.5:1. Max 10 MB each.

Audio Setting(string)

Audio handling. 'auto': model decides whether to regenerate audio. 'origin': preserve the original audio from the input video. Allowed values: auto, origin.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDalibaba/happy-horse/video-edit

Input Schema

6 parameters · 1 required · 5 optional

Parameter	Type	Required	Description
`prompt`	string	Required	Text prompt describing the desired edit. Reference any supplied reference images using @Image1, @Image2, ... up to @Image5. Max 2500 characters. · Min length: 1
`seed`	integer	Optional	Random seed for reproducibility (0-2147483647).
`video`	string	Optional	URL of the source video to edit. Formats: MP4, MOV (H.264 recommended). Duration: 3-60 s. Longer side ≤ 2160 px, shorter side ≥ 320 px. Aspect ratio between 1:2.5 and 2.5:1. Frame rate > 8 fps. Max 100 MB. The output video preserves the source aspect ratio. Output duration matches the input video, capped at 15 s (longer inputs are truncated to the first 15 s). Max file size: 100.0MB, Min duration: 3s, Max duration: 60s, Timeout: 30.0s
`resolution`	string	Optional	Output video resolution tier. · Options: 720p, 1080p · Default: "1080p" 720p1080p
`audio_setting`	string	Optional	Audio handling. 'auto': model decides whether to regenerate audio. 'origin': preserve the original audio from the input video. · Options: auto, origin · Default: "auto" autoorigin
`reference_image_urls`	string[]	Optional	Optional reference images used to guide the edit (up to 5). Formats: JPEG, JPG, PNG, WEBP. Dimensions must be at least 300px. Aspect ratio between 1:2.5 and 2.5:1. Max 10 MB each.

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "alibaba/happy-horse/video-edit",
  "video": "https://static.sandbase.ai/examples/alibaba/happy-horse/video-edit/input_video_0.mp4",
  "prompt": "Recolor the sky to a deep purple sunset.",
  "resolution": "1080p",
  "audio_setting": "auto"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Happy Horse Video Edit

API README

Happy Horse Video Edit

Happy Horse Video Edit is a video editing workflow for turning supplied visual material and written direction into a new moving sequence. It starts from an existing clip and applies a directed transformation.

Use the route for rapid creative iteration when a key asset already exists and the goal is to extend, animate, or revise it. Describe subject action, camera behavior, timing, atmosphere, and the intended ending; local duration, resolution, aspect-ratio, and seed controls define the delivery envelope.

Highlights

Prompt-directed video revision. Reworks an existing clip according to a written creative change.
Directed subject movement. Uses the prompt to define action, pace, staging, and interaction within the shot.
Camera and atmosphere control. Lets the brief specify framing, camera movement, lighting, mood, and scene energy.
Production-oriented delivery. Supports explicit duration, resolution, framing, and repeatability controls where exposed by the route.

Pricing

Configuration	Mode	Price
Any supported duration	Per generated second	$0.28

When to Use

✅ Good fit	❌ Consider alternatives
The project needs revising an existing visual asset	The goal is a different media task or endpoint
The available inputs match the required local schema	Required source media or permissions are unavailable
The brief can specify subject, composition, style, and delivery	The result must be deterministic at pixel or sample level
The supported formats and controls match final placement	Delivery requires unsupported dimensions, codecs, or duration
An asynchronous generated result fits the workflow	A live, frame-synchronous, or real-time response is mandatory

Prompt Guide

Write the request as a production brief: identify the main subject or source material, state the intended transformation, describe composition or timing, and finish with style, atmosphere, and delivery constraints. Keep preservation requirements separate from requested changes, and use only fields exposed by this route.

{
  "prompt": "A cinematic, precisely directed scene with clear subject action, camera movement, lighting, and atmosphere",
  "seed": 1,
  "video": "https://example.com/source.mp4",
  "resolution": "720p"
}

Technical Specs

Spec	Value
Model ID	`alibaba/happy-horse/video-edit`
Input fields	`seed` (integer)<br>`video` (string)<br>`prompt` (string)<br>`resolution` (string; `720p`, `1080p`)<br>`audio_setting` (string; `auto`, `origin`)<br>`reference_image_urls` (array)
Required input	`prompt`
Output fields	`url`, `content_type`
Execution	Asynchronous job

Related Models

alibaba/qwen-image-3/edit
alibaba/wan/2.2/image-to-video/turbo
alibaba/wan/2.1/text-to-video