API docs / Video models
HappyHorse 1.0 (Edit video) API
Transform an existing video with instructions.
- Model id
alibaba/happy-horse/video-edit- Provider
- Happy Horse
- Output
- Video
- Price
- Depends on the options; the same as on voor.ai.
Request
POST https://voor.ai/v1/generations with "model": "alibaba/happy-horse/video-edit". 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/video-edit",
"input": {
"prompt": "A red fox standing in fresh snow at golden hour, soft light",
"source_video": [
"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 edit. Reference any supplied reference images using @Image1, @Image2, ... up to @Image5. Max 2500 characters. Up to 2500 characters |
reference_images | array of URLs | Optional reference images used to guide the edit (up to 5). Formats: JPEG, JPG, PNG, WEBP. Dimensions must be at least 300px. Aspect ratio between 1:2.5 and 2.5:1. Max 10 MB each. Each file: up to 10 MB. Upload up to 5 reference images. They are numbered in upload order and can be inserted into the prompt as @Image1, @Image2, and so on. Up to 5 files · Accepts image/* |
source_videorequired | array of URLs | URL of the source video to edit. Formats: MP4, MOV (H.264 recommended). Duration: 3-60 s. Longer side ≤ 2160 px, shorter side ≥ 320 px. Aspect ratio between 1:2.5 and 2.5:1. Frame rate > 8 fps. Max 100 MB. The output video preserves the source aspect ratio. Output duration matches the input video, capped at 15 s (longer inputs are truncated to the first 15 s). Each file: 3–60s. Up to 1 files · Accepts video/* |
resolution | string | Output video resolution tier. Default: One of: 720p, 1080p |
seed | number | Random seed for reproducibility (0-2147483647). |
audio_setting | string | Audio handling. 'auto': model decides whether to regenerate audio. 'origin': preserve the original audio from the input video. Default: One of: auto, origin |