⌘K

HappyHorse 1.0 - Video Edit

happyhorse_1.0_video_edit

HappyHorse 1.0 Video Edit edits input videos with prompt instructions and optional reference images.

API Notes

happyhorse_1.0_video_edit generates videos at 24fps in MP4 format and supports 720P and 1080P resolution for 3 to 15 seconds

happyhorse_1.0_video_edit uses the input video duration when it is no longer than 15 seconds, and truncates longer input videos to the first 15 seconds

happyhorse_1.0_video_edit billing is based on both input and output video seconds; resolution affects unit price

Authentication

authorization string required

All APIs require authentication via Bearer Token.

Get API Key:

Visit API Key Management Page to get your API Key.

Usage:

Add to request header:

Authorization: Bearer YOUR_API_KEY

Parameters

model string required

Model ID to use for the request

Value: happyhorse_1.0_video_edit

input object required

Input parameters for the generation request

prompt string required

Text prompt used to describe how to edit the input video. Supports Chinese and English. Chinese prompts support up to 2500 characters, and non-Chinese prompts support up to 5000 characters. Content exceeding the limit is automatically truncated

Example: Turn the scene into a warm watercolor animation while keeping the main subject motion unchanged

media array required

Input media array. Provide exactly one input video and 0 to 5 reference images

type string required

Media type

Options: video, reference_image

url string required

Media URL

Video requirements:
Publicly accessible HTTP or HTTPS URL
Supported formats: MP4, MOV
Encoding recommendation: H.264
Duration: 3 - 60 seconds
Long side: maximum 4096 pixels
Short side: at least 360 pixels
Aspect ratio: from 1:2.5 to 2.5:1
File size: maximum 100MB
Frame rate: greater than 8fps

Output duration:
The output video is 3 to 15 seconds. Input videos up to 15 seconds keep the original duration; longer videos are automatically truncated from the beginning to the first 15 seconds.

Reference image requirements:
Publicly accessible HTTP or HTTPS URL, or Base64-encoded image data
Supported formats: JPEG, JPG, PNG, WEBP
Width and height: at least 300 pixels
Aspect ratio: from 1:2.5 to 2.5:1
File size: maximum 20MB

Reference image Base64 format:
data:{MIME_type};base64,{base64_data}
MIME types: JPEG/JPG image/jpeg, PNG image/png, WEBP image/webp

Example: https://example.com/input-video.mp4

parameters object

Generation parameters

resolution string

Video resolution. This parameter affects billing because different resolution tiers have different unit prices

Options: 720P, 1080P

Default: 1080P

watermark boolean

Whether to add a watermark to the lower-right corner of the generated video. The fixed watermark text is “Happy Horse”

Options: true, false

Default: true

audio_setting string

Audio control mode

Options: auto, origin

Default: auto

seed integer

Random seed. If not specified, the system automatically generates a random seed. To improve reproducibility, use the same seed value for repeated calls

Range: 0 - 2147483647

Polling

Since result generation takes time, you need to poll the task status after creating the task.

The initial response only returns information such as the task ID and initial status. The final result must be obtained by polling the task status endpoint using the task ID.

See the examples on the right for polling requests and responses.

Response Format

error object

Error information, only present when status is failed

code string

Error code

message string

Detailed error message

output array

Generation results, only present when status is completed

content array

List of generated resource content

type string

Resource type

Value: image｜video

url string

Processed resource URL

jobId string

Remote task ID

usage object

Usage statistics, only present when status is completed

cost string

Total cost in USD

discount number

Discount amount

metadata object

Metadata information