HappyHorse Video API · Unified video generation and editing interface

HappyHorse Video API

Name: HappyHorse Video
Brand: Ace Data Cloud

Use a stable REST API for text-to-video, first-frame image-to-video, reference image-to-video, and video editing. Ideal for integrating creative storyboards, product assets, character references, and post-production workflows into your own product.

View API Documentation View Pricing

4 actions720P / 1080PAsynchronous callbacks + task queries

🎬

Generation and editing modes

⏱️

3-15s

Output video duration

🖼️

1-9

Number of reference images

📡

REST

Unified API entry point

Covering the key actions of video production

No need to piece together workflows across multiple vendor APIs—HappyHorse consolidates common video generation and editing modes into a unified request structure.

✍️

Text-to-video

Enter shot descriptions, scenes, and actions to quickly generate short video prototypes.

🖼️

First-frame image-to-video

Use a fixed first frame to control composition and bring static visual assets to life naturally.

🎭

Reference image-to-video

Use multiple reference images to constrain characters, props, styles, and visual elements.

✂️

Video editing

Use input videos and reference images for style transfer, outfit changes, and local replacement.

curl

curl -X POST 'https://api.acedata.cloud/happyhorse/videos' \
  -H 'authorization: Bearer YOUR_API_KEY' \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -d '{
    "action": "image_to_video",
    "model": "happyhorse-1.1-i2v",
    "image_url": "https://cdn.acedata.cloud/b1c82e4937.png",
    "prompt": "A cinematic white horse lifts its head, the mane moves gently in the sunrise wind, slow camera push in, warm film lighting",
    "resolution": "720P",
    "duration": 5,
    "async": true
  }'

Submit a video task with one request

Use async to immediately return a task ID, then query the result through /happyhorse/tasks; if callback_url is provided, the final result will be pushed to your service after the task is completed.

Choose an action

Text-to-video, image-to-video, reference images, and editing all use the same endpoint.

Provide assets

Images and videos must be publicly accessible URLs; using Ace Data Cloud CDN is recommended.

Query results

Use task_id to obtain the final CDN video URL, duration, and resolution.

Three scenarios for real product integration

From marketing assets to content tools, HappyHorse is better suited as a reliable video capability module rather than a one-time toy.

Brand short film prototypes

Quickly generate short clips of products, characters, and scenes from text and first frames to validate visual direction.

Character and prop consistency

Use multiple reference images to lock in characters, clothing, props, and visual style.

Video post-production editing

Apply style transfer, local replacement, and audio preservation strategies to existing clips.

Launch video capabilities in three steps

Reuse Ace Data Cloud's unified authentication, billing, task, and callback model for a clear and controllable integration path.

Request a Token

Create an application in the console to obtain a unified Bearer Token.

Submit a task

Provide prompt, image_url, image_urls, or video_url according to the action.

Retrieve results

Get a downloadable CDN video URL through the task API or callback.

Why Use a Unified API

Consolidate model calls, task polling, CDN transfer, error classification, and billing records on the platform side.

Capability	Ace Data Cloud HappyHorse	Some Others
Multiple video actions	Unified `/happyhorse/videos`	Multiple APIs to combine yourself
Result files	Automatic CDN transfer	Temporary URLs commonly expire
Billing	Recorded by actual seconds	Requires building your own usage ledger
Failure handling	Structured error codes	Upstream error formats are inconsistent

Choose a Model by Task

1.1 models are prioritized for generation tasks; video editing currently uses 1.0 video-edit.

T2V

happyhorse-1.1-t2v

The default text-to-video model, suitable for generating short videos from scripts and shot descriptions.

I2V

happyhorse-1.1-i2v

Controls composition and visual tone with a first-frame image, suitable for animating product and character images.

R2V

happyhorse-1.1-r2v

Uses multiple reference images to constrain characters and props, suitable for scenarios with higher consistency requirements.

EDIT

happyhorse-1.0-video-edit

Edits based on input video, with the option to preserve the original audio.

Clear Per-Second Pricing

Failed tasks are not billed; video editing is billed based on the combined input and output duration returned by the upstream provider.

720P Generation

As low as $0.105 / second

Ideal for rapid prototyping
Supports t2v / i2v / r2v
3–15 second output

View Pricing

1080P Generation

As low as $0.18 / second

Clearer delivery assets
Suitable for commercial previews
Unified task queries

Get Started

Video Editing

Based on actual seconds

Input + output duration
Supports reference images
Original audio can be retained

View Parameters

Frequently Asked Questions

The parameters, assets, and billing questions you are most likely to care about before launch.

What input assets does HappyHorse support?

Text-to-video only requires a prompt; first-frame image-to-video requires image_url; reference image-to-video requires 1–9 image_urls; video editing requires video_url, with an optional 0–5 reference images.

Will the returned video URL expire?

Ace Data Cloud transfers upstream results to the platform CDN, and the CDN URLs used in the documentation and API responses are accessible.

How should long-running generation be handled?

It is recommended to use async or callback_url. The API will first return a task_id, which you can actively query through /happyhorse/tasks or wait for a callback.

Are failed tasks charged?

No. Only tasks that complete successfully and have recorded results are billed based on duration and resolution.

Integrate HappyHorse into Your Video Product

Use unified Tokens, unified billing, and unified task queries to reliably integrate video generation and editing capabilities into your application.

View API Documentation Get API Token

Beta HappyHorse Videos API

POSThttps://api.acedata.cloud/happyhorse/videos

Generate or edit HappyHorse videos from text, first frames, multiple reference images, or video, with synchronous, asynchronous, and callback delivery.

HappyHorse Tasks API

POSThttps://api.acedata.cloud/happyhorse/tasks

Retrieve one or multiple HappyHorse video tasks, including progress, final videos, and elapsed time.

Packages

We offer various credit packages. The more you purchase, the higher the discount you receive.

up to46% OFF

Price
HappyHorse Videos API
HappyHorse Tasks API

HappyHorse MCP

Generate and edit videos using HappyHorse in the AI Agent through MCP.

Agent app

Installation Scope

Operating System

Configuration Method

Connect to the current service in Claude Code:

Select the current project or current user;
The command will save the authentication Header to the corresponding configuration, please do not submit configurations that contain the Token;
After completion, run /mcp to check the connection and tool list.

export ACEDATACLOUD_API_TOKEN='YOUR_API_TOKEN'
claude mcp add --scope user --transport http 'happyhorse-mcp' 'https://happyhorse.mcp.acedata.cloud/mcp' --header 'Authorization: Bearer ${ACEDATACLOUD_API_TOKEN}'

View source code

HappyHorse Video

Provide parameter descriptions, input material requirements, and task processing guidelines for HappyHorse video generation and editing for AI Agent.

Agent app

Installation Scope

Install the current Skill to Claude Code. Project-level configurations are shared across the repository, while user-level configurations apply to all projects on this machine.

npx skills add acedatacloud/skills --skill 'happyhorse-video' -a 'claude-code' --yes

View source code