Reference

API reference

Complete input parameter surface for HappyHorse 1.0. The canonical schema lives at the model's llms.txt; the table below is derived from it.

Endpoint

Submit a job to the queue endpoint:

POST https://queue.fal.run/fal-ai/happyhorse/v1/text-to-video

Input parameters

KeyTypeDefaultAllowed / notes
promptrequiredstringFree text describing the output.
durationenum5s3s | 5s | 8s | 10s
resolutionenum720p256p | 480p | 720p | 1080p
aspect_ratioenum16:916:9 | 9:16 | 1:1 | 21:9
generate_audioenumtruetrue | false
languageenumenen | zh | ja | ko | de | fr | yue

Canonical schema: fal.ai/models/fal-ai/happyhorse/v1/text-to-video/llms.txt. Anything new shipped by the model vendor appears there first.

Worked example

Minimal request using the defaults above. Swap the prompt for your own; everything else stays optional.

BASH
1curl -X POST "https://queue.fal.run/fal-ai/happyhorse/v1/text-to-video" \
2 -H "Authorization: Key $FAL_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{"prompt":"Documentary style interview at night. A barista in a rain jacket leans agains...","duration":"5s","resolution":"720p","aspect_ratio":"16:9","generate_audio":true,"language":"en"}'
Also reading