GET
/v1/schemas/fal/video/fal-ai/pixverse/c1/reference-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace385c252cae673982cc646c19339516ec849b812fa18af83335ad37d3b329238e{
"fetchedAt": 1791522002,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
8 properties · 2 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| image_references* | ImageReference[] | List of reference images with type and name. Use @ref_name in the prompt to refer to each reference. | items ≥ 1 · items ≤ 7 |
| prompt* | string | The prompt for the reference-to-video generation. Use @ref_name to refer to uploaded references. Limited to 2048 UTF-8 encoded bytes. Because the limit counts bytes rather than characters, emoji and non-Latin or accented characters (which use multiple bytes ea… | |
| aspect_ratio | enum | The aspect ratio of the generated video | 16:9 | 4:3 | 1:1 | 3:4 | 9:16 | 2:3 · +2 more · default: "16:9" |
| generate_audio_switch | boolean | Enable audio generation (BGM, SFX, dialogue) | default: false |
| duration | integer | The duration of the generated video in seconds (1-15) | 1 ≤ n ≤ 15 · default: 5 |
| enable_safety_checker | boolean | Authorized callers may set false to request relaxed screening. | default: true |
| resolution | enum | The resolution of the generated video | 360p | 540p | 720p | 1080p · default: "720p" |
| seed | integer | The same seed and the same prompt given to the same version of the model will output the same video every time. | nullable |
Types
1 $defsImageReferenceobject
| ref_name* | string | A short name for this reference. Use @ref_name in the prompt to refer to this image. | |
| type | enum | Type of reference: 'subject' for character/object references, 'background' for scene/environment references | subject | background · default: "subject" |
| image_url* | string | URL of the reference image |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/pixverse/c1/reference-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}