Model
alibaba/happyhorse-1.1-video
Modes
| Mode | Description |
|---|---|
t2v | Generate video from a text prompt |
i2v | Generate video from a first frame image |
r2v | Generate video from reference images. Use [Image N] in prompt to reference them (order matches reference_image_urls) |
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
mode | string | No | "t2v" | "t2v", "i2v", or "r2v" |
prompt | string | No | "" | Text prompt describing the desired video |
first_frame_url | string | No | null | URL of the first frame image for I2V mode |
reference_image_urls | string[] | No | null | Reference image URLs for R2V mode (1-9). Use [Image N] in prompt to reference them |
ratio | string | No | null | Aspect ratio (T2V/R2V only): "16:9", "9:16", "1:1", "4:3", "3:4", "4:5", "5:4", "9:21", "21:9" |
resolution | string | No | "1080P" | "720P" or "1080P" |
duration | integer | No | 5 | Output duration in seconds (3-15) |
watermark | boolean | No | false | Add watermark to the output |
seed | integer | No | null | Random seed for reproducible generation (0-2147483647) |
Example - Text-to-Video
curl -X POST https://api.unifically.com/v1/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "alibaba/happyhorse-1.1-video",
"input": {
"mode": "t2v",
"prompt": "A golden retriever running through a field of wildflowers at sunset",
"resolution": "1080P",
"ratio": "16:9",
"duration": 5
}
}'
Example - Image-to-Video
curl -X POST https://api.unifically.com/v1/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "alibaba/happyhorse-1.1-video",
"input": {
"mode": "i2v",
"prompt": "The camera slowly zooms out as the scene comes to life",
"first_frame_url": "https://example.com/landscape.png",
"resolution": "1080P",
"duration": 10
}
}'
Example - Reference-to-Video
curl -X POST https://api.unifically.com/v1/tasks \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "alibaba/happyhorse-1.1-video",
"input": {
"mode": "r2v",
"prompt": "[Image 1] walks confidently through a busy city street",
"reference_image_urls": ["https://example.com/person.png"],
"resolution": "1080P",
"ratio": "16:9",
"duration": 8
}
}'
Response
{
"code": 200,
"success": true,
"data": {
"task_id": "abc123def456",
"status": "processing"
}
}