API docs / Video models
HappyHorse 1.0 (Reference to video) API
Combine image, video, and audio references for subjects, motion, style, editing, and sound.
- Model id
alibaba/happy-horse/reference-to-video- Provider
- Happy Horse
- Output
- Video
- Price
- From 147 credits per run, the same as on voor.ai. Options such as length or resolution can change it.
Request
POST https://voor.ai/v1/generations with "model": "alibaba/happy-horse/reference-to-video". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.
curl https://voor.ai/v1/generations \
-H "Authorization: Bearer $VOOR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "alibaba/happy-horse/reference-to-video",
"input": {
"prompt": "A red fox standing in fresh snow at golden hour, soft light",
"reference_images": [
"https://example.com/input.png"
]
},
"callback_url": "https://example.com/webhooks/voor"
}'
# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
-H "Authorization: Bearer $VOOR_API_KEY"Input parameters
| Name | Type | Details |
|---|---|---|
promptrequired | string | Text prompt describing the desired video. Reference subjects from your images using ``character1``, ``character2``, ... up to ``character9`` (the order matches the order of ``image_urls``). Max 2500 characters. Up to 2500 characters |
reference_imagesrequired | array of URLs | Reference images for subject consistency (1-9 images). Formats: JPEG, JPG, PNG, WEBP. Shortest side must be at least 400 px (720P or higher recommended). Max 10 MB each. Each file: up to 10 MB. Upload up to 9 reference images. They are numbered in upload order and can be inserted into the prompt as character1, character2, and so on. Up to 9 files · Accepts image/* |
aspect_ratio | string | Aspect ratio of the generated video. Default: One of: 16:9, 9:16, 1:1, 4:3, 3:4 |
resolution | string | Output video resolution tier. Default: One of: 720p, 1080p |
duration_seconds | number | Output video duration in seconds (3-15). Default: One of: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
seed | number | Random seed for reproducibility (0-2147483647). |