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

NameTypeDetails
promptrequiredstring

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_imagesarray 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_videorequiredarray 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/*

resolutionstring

Output video resolution tier.

Default: 720p

One of: 720p, 1080p

seednumber

Random seed for reproducibility (0-2147483647).

audio_settingstring

Audio handling. 'auto': model decides whether to regenerate audio. 'origin': preserve the original audio from the input video.

Default: auto

One of: auto, origin