Happy Horse Video Edit

HappyHorse video editing supports advanced video editing through natural language instructions. It allows for local or global editing of video elements using up to 5 reference images.

Pricing: $0.28/second. Endpoint: POST /v1/models/alibaba/happy-horse/video-edit/runs.

HappyHorse video editing supports advanced video editing through natural language instructions. It allows for local or global editing of video elements using up to 5 reference images.

Overview

• Endpoint: https://api.runflow.io/v1/models/alibaba/happy-horse/video-edit/runs
• Model ID: alibaba/happy-horse/video-edit
• Provider: Alibaba
• License: commercial
• Last Updated: 2026-04-28

Pricing

• Base price: $0.28/second
• Note: Per second of edited video (720p baseline)

Happy Horse Video Edit API

Endpoint: POST /v1/models/alibaba/happy-horse/video-edit/runs

Run the model

Python

import requests

response = requests.post(
    "https://api.runflow.io/v1/models/alibaba/happy-horse/video-edit/runs",
    headers={"Authorization": "Bearer RUNFLOW_API_KEY"},
    json={
        "input": {
            "prompt": "Replace the underwater background with deep cosmic space, the jellyfish becomes a glowing nebula creature among shimmering stars",
            "video_url": "https://public.runflow.io/images/models/_shared/source-videos/jellyfish-1080.mp4",
            "resolution": "720p"
        },
        "callback_url": "https://your-server.com/webhook"
    },
)

data = response.json()
print(data)

Node.js

const response = await fetch(
  "https://api.runflow.io/v1/models/alibaba/happy-horse/video-edit/runs",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer RUNFLOW_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
        "input": {
            "prompt": "Replace the underwater background with deep cosmic space, the jellyfish becomes a glowing nebula creature among shimmering stars",
            "video_url": "https://public.runflow.io/images/models/_shared/source-videos/jellyfish-1080.mp4",
            "resolution": "720p"
        },
        "callback_url": "https://your-server.com/webhook"
    }),
  }
);

const data = await response.json();
console.log(data);

cURL

curl -X POST https://api.runflow.io/v1/models/alibaba/happy-horse/video-edit/runs \
  -H "Authorization: Bearer $RUNFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
    "input": {
        "prompt": "Replace the underwater background with deep cosmic space, the jellyfish becomes a glowing nebula creature among shimmering stars",
        "video_url": "https://public.runflow.io/images/models/_shared/source-videos/jellyfish-1080.mp4",
        "resolution": "720p"
    },
    "callback_url": "https://your-server.com/webhook"
}
JSON

Request parameters

Parameter	Type	Required	Description
input	object	required	Model input parameters. See “Input schema” below.
callback_url	string | null	optional	Webhook URL - POSTed when the run reaches a terminal state.
metadata	object | null	optional	Arbitrary key-value pairs attached to the run.

Input schema

Field	Type	Required	Allowed values	Description
prompt	string	required	Any	Text prompt describing the desired edit. Reference any supplied reference images using @Image1, @Image2, … up to @Image5. Max 2500 characters.
video_url	video	required	Any	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).
audio_setting	string	optional	auto, origin	Audio handling. ‘auto’: model decides whether to regenerate audio. ‘origin’: preserve the original audio from the input video.
enable_safety_checker	boolean	optional	Any	Enable content moderation for input and output.
reference_image_urls	image_list	optional	Any	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.
resolution	string	optional	720p, 1080p	Output video resolution tier.
seed	integer	optional	Any	Random seed for reproducibility (0-2147483647).

Output schema

Field	Type	Description
outputs	json	Unified output array - one entry per generated artifact with url/type/width/height/duration/etc.
seed	json	Deterministic seed used for generation, or null if the provider doesn’t return one.
timing	json	Provider timing info (inference_ms etc.), or null.
nsfw_detected	json	true if the provider flagged output as NSFW, false if cleared, null if not checked.

Callback payload

When you provide a callback_url, Runflow POSTs to it once the run reaches a terminal state.

Field	Type	Description
event	string	Event type: “run.completed”, “run.failed”, or “run.cancelled”.
run_id	string	The unique identifier of the run.
status	string	Terminal status: “succeeded”, “failed”, or “cancelled”.
output	object | null	The run output. Null if the run failed or was cancelled.
duration_ms	number | null	Total run duration in milliseconds.
created_at	string | null	ISO 8601 timestamp when the run was created.
completed_at	string | null	ISO 8601 timestamp when the run reached terminal state.
metadata	object | null	The metadata object passed at run creation, if any.

• Retries: 3 attempts with exponential backoff (1s, 2s). Retries on 5xx / network errors only.
• Headers: Runflow-Request-Id is always sent. Runflow-Signature is sent if a signing secret is configured.

Additional Resources

• Playground
• API Reference
• Documentation
• OpenAPI

Related

Browse all models

Browse the catalog.

Run lifecycle

Callbacks, polling, statuses.

Callbacks

Handle async results.

Pricing

How requests bill out.