GET
/v1/schemas/fal/video/fal-ai/ltx-2.3-quality/outpaint/lora
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above.Source trace7a5d912fc7c8b305d32761b94e1ada4a88126f2f2fde9bfa01ced6d07e94a0e5{
"fetchedAt": 1783331098,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
20 properties · 3 required · 2 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The prompt to guide the outpainted video generation. | |
| video_url* | string | The source video to spatially outpaint. | |
| loras* | LoRAInput[] | Up to 3 LoRAs to apply on top of LTX-2.3. Each path is downloaded through the registry SSRF-safe downloader before it is loaded. Max size: 3 GB per LoRA. | items ≤ 3 |
| num_frames | integer | The number of frames to generate. | 9 ≤ n ≤ 481 · default: 121 |
| enable_prompt_expansion | boolean | Whether to enable prompt expansion. | default: true |
| frames_per_second | number | Frames per second of the generated video. | 1 ≤ n ≤ 60 · default: 24 |
| seed | integer | Random seed for reproducibility. If None, a random seed is chosen. | nullable |
| enable_safety_checker | boolean | Whether to enable the safety checker. | default: true |
| guidance_scale | number | Classifier-free guidance scale. The default is tuned for fast, high-quality generation. | 1 ≤ n ≤ 20 · default: 1 |
| sync_mode | boolean | If True, the media is returned as a data URI inline in the response. Useful for short-lived requests and tests. | default: false |
| aspect_ratio | enum | Target aspect ratio for the outpainted video. Choose a different ratio than the input video to extend the frame cleanly, e.g. use 16:9 for a 4:3 source. | 21:9 | 16:9 | 4:3 | 1:1 | 3:4 | 9:16 · +1 more · default: "16:9" |
| num_inference_steps | integer | Number of inference steps. Defaults to 15 and can be increased up to 30. | 8 ≤ n ≤ 30 · default: 15 |
| video_quality | enum | The quality preset of the generated video. | low | medium | high | maximum · default: "high" |
| generate_audio | boolean | Whether to include audio in the returned video. When disabled, the final MP4 is returned without an audio track. | default: true |
| video_strength | number | Strength of the IC-LoRA video guide for the original content. Higher values preserve the source video more strongly inside the outpainted canvas. | 0 ≤ n ≤ 1 · default: 1 |
| negative_prompt | string | The negative prompt to steer generation away from. | default: "color distortion, overexposure,… |
| resolution | ImageSize | enum | Legacy exact target canvas size. For new requests, prefer aspect_ratio with output_resolution; this field remains supported for backwards compatibility. | default: "landscape_16_9" |
| output_resolution | enum | Output resolution tier. 480p is faster, 720p is the default balance, and 1080p gives a larger canvas when it fits LTX limits. | 480p | 720p | 1080p · default: "720p" |
| video_write_mode | enum | The write mode of the generated video. | fast | balanced | small · default: "balanced" |
| source_scale | number | Scale of the source video inside the target canvas before outpainting. 1.0 uses the largest source size that fits the target canvas, which is recommended for true aspect-ratio outpainting such as 4:3 to 16:9. Lower values create a zoom-out border around the so… | 0.25 ≤ n ≤ 1 · default: 1 |
Types
2 $defsImageSizeobject
| height | integer | The height of the generated image. | 0 < n ≤ 14142 · default: 512 |
| width | integer | The width of the generated image. | 0 < n ≤ 14142 · default: 512 |
LoRAInputobject
A single LoRA to apply on top of the LTX-2.3 base model.
| scale | number | Strength of the LoRA application (0.0 to 2.0). Higher values = stronger effect on the generated video. | 0 ≤ n ≤ 2 · default: 1 |
| path* | string | Direct HTTP(S) download URL of the LoRA file (.safetensors). The file is downloaded through an SSRF-safe downloader before it is loaded. Max size: 3 GB. | length ≤ 2048 |
| transformer | enum | Forward-compatibility flag for multi-transformer architectures. LTX-2.3 has a single transformer, so 'both' is the right choice for almost all users. | high | low | both · default: "both" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/ltx-2.3-quality/outpaint/lora","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}