Skip to main content
POST
Create Happy Horse — Video Edit

Overview

Alibaba Happy Horse video-edit: natural-language edits on a source clip with optional reference images. Optimized for video to video via apisale.
Docs = API contract + Try it (snapshot). Explore = browser playground. Model page = product examples.

Endpoint

Pricing

From $0.087/sec apisale price is 30% below the vendor’s official list price.
Official price = vendor list price. apisale price = what you pay through apisale.

Request

Parameters

Fields marked * are required. Use Authorization: Key YOUR_API_KEY for REST.
number
Optional random seed for reproducibility.
string
required
Text prompt for video generation. Maximum 2500 characters.
number
Billing estimate in seconds (3–15). Actual output matches source length, capped at 15s. Default: 5 Values: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Range: 3 – 15
string
required
Source video URL (MP4/MOV, 3–60s; output capped at 15s).
string
Default: 1080p Values: 720p, 1080p
string
auto = model may regenerate audio; origin = keep source audio. Default: auto Values: auto, origin
array
Optional reference images (@Image1…@Image5 in prompt).
boolean
Content moderation on input and output. Default: true
string
Optional HTTPS webhook when the run reaches a terminal state.
boolean
Block until completion (same Run response shape).

Submit response

Returns a Run with run_id. Poll with GET /v1/runs/{run_id} or use Try it above.
string
required
Unique run ID — save for polling and webhooks.
string
required
queued (async) or terminal state for sync runs.
object
Result when status is succeeded — see Output schema below.

Example (async submit)

Full lifecycle: Runs lifecycle.

Output

When status is succeeded, output follows this schema:

Example

Authorizations

Authorization
string
header
required

Key sk-... (native REST) or Bearer sk-... (vendor SDKs)

Body

application/json
input
object
required
Example:
webhook_url
string<uri>
sync
boolean
default:false

Response

201 - application/json

Run accepted

run_id
string
required

Unique run identifier

endpoint
string
required

Model slug

model
string
required
capability
string
required
mode
string
required
status
enum<string>
required
Available options:
queued,
processing,
succeeded,
failed,
timeout,
cancelled
created_at
string<date-time>
required
output
object | null
error
object | null
billing
object | null
started_at
string<date-time> | null
completed_at
string<date-time> | null
elapsed_ms
number | null