GET
/v1/schemas/fal/video/fal-ai/wan-25-preview/text-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above.Source tracebff2898de6b0f27fa0c252acf6c8065961b87458b41606396985bd334586d284{
"fetchedAt": 1786338105,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
9 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The text prompt for video generation. Supports Chinese and English, max 1500 characters. | length ≥ 1 |
| aspect_ratio | enum | The aspect ratio of the generated video | 16:9 | 9:16 | 1:1 · default: "16:9" |
| enable_prompt_expansion | boolean | Whether to enable prompt rewriting using LLM. Improves results for short prompts but increases processing time. | default: true |
| seed | integer | Random seed for reproducibility. If None, a random seed is chosen. | nullable |
| resolution | enum | Video resolution tier | 480p | 720p | 1080p · default: "1080p" |
| audio_url | string | URL of the audio to use as the background music. Must be publicly accessible. Limit handling: If the audio duration exceeds the duration value (5 or 10 seconds), the audio is truncated to the first 5 or 10 seconds, and the rest is discarded. If the audio is shorter than the video, the remaining part of the video will be silent. For example, if the audio is 3 seconds long and the video duration is 5 seconds, the first 3 seconds of the output video will have sound, and the last 2 seconds will be silent. - Format: WAV, MP3. - Duration: 3 to 30 s. - File size: Up to 15 MB. | nullable |
| duration | enum | Duration of the generated video in seconds. Choose between 5 or 10 seconds. | 5 | 10 · default: "5" |
| enable_safety_checker | boolean | If set to true, the safety checker will be enabled. Disabling it requires account authorization; unauthorized requests are always checked. | default: true |
| negative_prompt | string | Negative prompt to describe content to avoid. Max 500 characters. | nullable |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/wan-25-preview/text-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}