API docs / Video models

HappyHorse 1.1 (Text to video) API

Create a video from a text prompt.

Model id
alibaba/happy-horse/v1.1/text-to-video
Provider
alibaba
Output
Video
Price
From 244 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/v1.1/text-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/v1.1/text-to-video",
  "input": {
    "prompt": "A red fox standing in fresh snow at golden hour, soft light"
  },
  "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 video. Max 2500 characters.

Up to 2500 characters

first_framearray of URLs

URL of the first frame image. Formats: JPEG, JPG, PNG, BMP, WEBP. Dimensions must be at least 300px. Aspect ratio must be between 1:2.5 and 2.5:1. Max 20 MB. Each file: up to 20 MB.

Up to 1 files · Accepts image/*

reference_imagesarray 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 20 MB each. Each file: up to 20 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_ratiostring

Aspect ratio of the generated video.

Default: 16:9

One of: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 9:21, 5:4, 4:5

resolutionstring

Output video resolution tier.

Default: 720p

One of: 720p, 1080p

duration_secondsnumber

Output video duration in seconds (3-15).

Default: 5

One of: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

seednumber

Random seed for reproducibility (0-2147483647).