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.1/image-to-video",
"input": {
"image_urls": [
"https://example.com/image.png"
],
"resolution": "1080p",
"duration": 5
}
}
'{
"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 1.1 Image to Video
Bring a still image into motion with Happy Horse 1.1, creating video scenes up to fifteen seconds long in a range of screen formats.
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.1/image-to-video",
"input": {
"image_urls": [
"https://example.com/image.png"
],
"resolution": "1080p",
"duration": 5
}
}
'{
"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 1.1 Image to Video
Bring a still image into motion with Happy Horse 1.1, creating video scenes up to fifteen seconds long in a range of screen formats.Available Models
- alibaba/happyhorse-1.1/image-to-video - Generate video from image input.
Duration Options
- 3-15 seconds - Set
durationas an integer. Optional. Default: 5 seconds.
Key Features
- Generate video from image input.
- Accepts exactly 1 image in
image_urls. - Choose from
720p,1080poutput resolutions.
Advanced Parameters
Setmodel and optional callback_url at the request root. Place all workflow parameters, including output options, 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. Image inputs also accept image Data URIs or raw Base64. Image conversion and media validation complete before credits are deducted.
duration and seed also accept integer strings such as "5"; decimal numbers such as 5.0 and decimal strings such as "5.0" are rejected. Null or empty values use the default duration or omit the seed. Supported boolean fields also accept 0/1 and case-insensitive strings true/false, 1/0, yes/no, y/n, and on/off; null omits the field. Surrounding whitespace is trimmed, and resolution values are case-insensitive.
Prompt
prompt: Optional. Describe the scene and desired motion. Maximum: 2,500 Unicode characters.- Leading and trailing whitespace is trimmed. Omitted, null, empty, and whitespace-only values are treated as omitted.
aspect_ratio or reference_image_urls.
Image URLs
image_urls: Required. Supply exactly 1 item. Each item may be a public HTTP(S) URL, image Data URI, or raw Base64. Image order is preserved.
Resolution
resolution: Optional. Accepted values:720p,1080p. Default:1080p.
Seed
seed: Optional. Set the generation seed. Integer from0to2147483647.
Safety Checker
enable_safety_checker: Optional. Control safety checking. Usetrueorfalse.
Pricing
Usage equals output seconds multiplied by the selected resolution rate. See Pricing for current rates. 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.1/image-to-video.
Available options:
alibaba/happyhorse-1.1/image-to-video Example:
"alibaba/happyhorse-1.1/image-to-video"
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.