GET
/v1/schemas/fal/video/alibaba%2Fhappy-horse%2Fv1.1%2Freference-to-video
Accept:
Request body
7 properties · 2 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | 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. | length ≥ 1 |
| image_urls* | string[] | 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. | |
| duration | enum | Output video duration in seconds (3-15). | 3 | 4 | 5 | 6 | 7 | 8 · +7 more · default: 5 |
| enable_safety_checker | boolean | Enable content moderation for input and output. | default: true |
| aspect_ratio | enum | Aspect ratio of the generated video. | 16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:9 · +3 more · default: "16:9" |
| seed | integer | Random seed for reproducibility (0-2147483647). | nullable |
| resolution | enum | Output video resolution tier. | 720p | 1080p · default: "1080p" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"alibaba/happy-horse/v1.1/reference-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}