Sign inGet started
falImage to videoComing soon

alibaba/happy-horse/reference-to-video

alibaba/happy-horse/reference-to-video is an image to video tool from fal that runs in the background and returns video. Coming soon: listed with its price, not yet open to runs.

This tool is listed but not yet available to run.

Priced by usage

Pricing

duration: 3 $0.546, 4 $0.728, 5 (default) $0.91, 6 $1.092, 7 $1.274, 8 $1.456, 9 $1.638, 10 $1.82, 11 $2.002, 12 $2.184, 13 $2.366, 14 $2.548, 15 $2.73, otherwise $2.73 per run. The final charge comes from usage.

Limits

Runs
In the background
Returns
video
Longest queue wait
3600s
Run deadline
3600s
Largest inline input
1024 KB
Largest input file
500 MB
Largest output
4768 MB
Outputs per run
16

Input

FieldKindDefaultDescription
prompt requiredtext—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.
image_urls requiredURLs or files—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.
aspect_ratioone of
16:9, 9:16, 1:1, 4:3, 3:4
16:9Aspect ratio of the generated video.
resolutionone of
720p, 1080p
1080pOutput video resolution tier.
durationone of
3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
5Output video duration in seconds (3-15).
seednumber (whole)—Random seed for reproducibility (0-2147483647).

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "alibaba/happy-horse/reference-to-video",
    "input": {
      "prompt": "A dance battle between character1 and character2, cinematic lighting, smooth camera movement.",
      "image_urls": [
        "<image_urls>"
      ]
    }
  }'