GET
/v1/schemas/fal/video/fal-ai/pixverse/v4/text-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace248f057ce24a01001379a8ee48eaac9acee2ed61958e13516008c4f2313d84bd{
"fetchedAt": 1791522002,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
8 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | Text prompt for the video generation. 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 each) can push a visually short prompt over the cap. | |
| aspect_ratio | enum | The aspect ratio of the generated video | 16:9 | 4:3 | 1:1 | 3:4 | 9:16 · default: "16:9" |
| negative_prompt | string | Negative prompt to be used for the generation. 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 each) can push a visually short prompt over the cap. | default: "" |
| style | enum | The style of the generated video | anime | 3d_animation | clay | comic | cyberpunk · nullable |
| enable_safety_checker | boolean | Authorized callers may set false to request relaxed screening. | default: true |
| duration | enum | The duration of the generated video in seconds. 8s videos cost double. 1080p videos are limited to 5 seconds | 5 | 8 · default: "5" |
| 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 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/pixverse/v4/text-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}