curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "alibaba/happyhorse-1.0/video-edit",
"input": {
"video_url": "https://example.com/video.mp4",
"resolution": "1080p",
"audio_setting": "auto",
"prompt": "Restyle the scene with warm sunset lighting while preserving the original motion."
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}Alibaba
Happy Horse Video Edit
Transform existing footage with Happy Horse using text instructions and reference images to guide a new visual direction.
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "alibaba/happyhorse-1.0/video-edit",
"input": {
"video_url": "https://example.com/video.mp4",
"resolution": "1080p",
"audio_setting": "auto",
"prompt": "Restyle the scene with warm sunset lighting while preserving the original motion."
}
}
'
{
"code": 200,
"data": {
"task_id": "task-unified-example",
"status": "running",
"created_time": "2026-09-10T08:00:00"
}
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}"Request timeout"{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}{
"detail": "<string>"
}- Submit the request with
VIDGO_API_KEY. Atask_idis returned immediately. Keep it until the task reachesfinishedorfailed. - Use Query Task Status to retrieve the result. If you provide a
callback_url, Vidgo sends the result to your webhook when the task finishes or fails.
Happy Horse Video Edit
Transform existing footage with Happy Horse using text instructions and reference images to guide a new visual direction.Available Models
- alibaba/happyhorse-1.0/video-edit - Edit an existing video using written instructions.
Duration Options
- Source video: 3-60 seconds - Duration is read from
video_url. - Do not send
durationfor video editing.
Key Features
- Edit an existing video using written instructions.
- Optionally add up to five reference images to guide the edit.
- Choose from
720p,1080poutput resolutions. - Choose automatic audio handling or preserve the source audio.
Advanced Parameters
Setmodel and optional callback_url at the request root. Place the parameters below inside input.
Send only the input fields supported by this workflow. Unsupported input fields are rejected before credits are deducted. Input URLs must use HTTP(S), include a hostname, and contain no embedded credentials.
Prompt
prompt: Required. Describe the requested changes to the video.- The prompt must not be blank when supplied. Maximum length: 2,500 characters.
Reference Inputs
reference_image_urls: Optional; provide up to 5 images.- Describe referenced subjects in the prompt;
character1andcharacter2markers are not required.
Source Video
video_url: Required. Provide one publicly accessible source video URL.- The source video must be directly downloadable over HTTP(S) and no larger than 100 MiB for duration inspection.
Resolution
resolution:720p,1080p. Default:1080p.
Audio
audio_setting:autoororigin. Default:auto.autolets the model determine audio handling;originpreserves the original audio.
Seed
seedis optional. Supply an integer from0to2147483647.
Safety Checker
enable_safety_checkeris optional. Set it totrueorfalseto control safety checking.
Pricing
Credits are calculated from the detected source-video duration, capped at 15 seconds, multiplied by the selected resolution rate. The result is normalized to six decimal places. Check the Vidgo dashboard for the current rate. Credits are deducted on submission and refunded if the task fails.Authorizations
Use VIDGO_API_KEY.
Body
application/json
Keep model and callback_url at the root. Unknown root fields are ignored; unsupported input fields are rejected.
Vidgo public model ID. Must be alibaba/happyhorse-1.0/video-edit.
Available options:
alibaba/happyhorse-1.0/video-edit Example:
"alibaba/happyhorse-1.0/video-edit"
Show child attributes
Show child attributes
Optional public HTTP(S) endpoint for task completion notifications. HTTPS is recommended. Omit, use null, or use an empty string to disable callbacks.