HappyHorse 1.0 - Video Edit

happyhorse_1.0_video_edit

HappyHorse 1.0 Video Edit edits an input video using a prompt and optional reference images.

Endpoints

POST /v1/queue/happyhorse_1.0_video_edit # Create task

GET /v1/queue/happyhorse_1.0_video_edit/requests/{request_id}/status # Check status

GET /v1/queue/happyhorse_1.0_video_edit/requests/{request_id}/response # Get result

PUT /v1/queue/happyhorse_1.0_video_edit/requests/{request_id}/cancel # Cancel task

Request parameters

curl --location "https://cloud.seaart.ai/model/v1/queue/happyhorse_1.0_video_edit" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A red apple slowly rotating on a white table, clean studio lighting, static camera.",
    "media": [
      {
        "type": "video",
        "url": "https://static.cdn2.haiyiapi.com/2026-06-01/d8elghle878b7lpvk0o0/053e1094464d3a0e557f6e3437acafd5.mp4"
      }
    ],
    "duration": 5,
    "resolution": "720P",
    "audio_setting": "auto"
  }'

prompt string required

Text prompt describing how to edit the input video. Chinese and English are supported, for example Turn the scene into a warm watercolor animation while keeping the main subject motion unchanged. The maximum length is 2500 characters. Each Chinese character or letter counts as one character, and content beyond the limit is truncated automatically.

media array required

Input media array. Provide exactly one input video.

Range: 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

Recommended encoding: H.264

Duration: 3 - 60 seconds

Short side: at least 360 pixels

Aspect ratio: 1:8 to 8:1

File size: up to 100MB

Frame rate: greater than 8fps

Reference image requirements:

Publicly accessible HTTP or HTTPS URL

Supported formats: JPEG, JPG, PNG, BMP, WEBP

Width and height: both at least 300 pixels

Aspect ratio: 1:2.5 to 2.5:1

File size: up to 10MB

duration int

If the input video is no longer than 15 seconds, the original input duration is used. If it is longer than 15 seconds, the first 15 seconds are used.

resolution string

Video resolution. Different resolution tiers use different unit prices, so this parameter affects billing cost.

Options: 720P, 1080P

Default: 1080P

seed int

Random seed. If omitted, the system generates a random seed automatically. Use the same seed across repeated calls to improve reproducibility.

Range: 0 - 2147483647

watermark bool

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.

Options: auto, origin

Default: auto

Response parameters

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://cloud.seaart.ai/model/v1/queue/happyhorse_1.0_video_edit/requests/mmsu_01hxyz.../response",
  "status_url": "https://cloud.seaart.ai/model/v1/queue/happyhorse_1.0_video_edit/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://cloud.seaart.ai/model/v1/queue/happyhorse_1.0_video_edit/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

Field	Type	Description
`request_id`	string	Task ID used for all follow-up operations.
`response_url`	string	URL to fetch the final result.
`status_url`	string	URL to query task status.
`cancel_url`	string	URL to cancel the task.
`queue_position`	int	Current queue position.

Follow-up operations

Check status

Get result

Cancel task

Error handling