GET
/v1/schemas/fal/video/fal-ai/ltx-2.3-quality/render-to-real
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above.Source trace74199635e210a0dd6653667ac886743bf693d8f00472a46a023433610e0e644e{
"fetchedAt": 1783487013,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
19 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| video_url* | string | The URL of the 3D / CG / game render to make photorealistic. | |
| intensity | enum | How hard to push the render toward photorealism. 'light' keeps more of the source render's look and motion; 'strong' transforms more aggressively for a more photoreal result; 'strong-v2' is the newest improved adapter (better multi-scene coherence, audio, talk… | light | strong | strong-v2 · default: "light" |
| enable_detail_refine | boolean | Add a second refinement stage for a sharper, higher-resolution result. After the base pass the video latent is 2x latent-upscaled (spatial upscaler) and refined by a short detailer pass on the distilled model. NOTE: this doubles the output width AND height (4x… | default: false |
| resolution | enum | Output resolution (short side), preserving the source aspect ratio. The IC-LoRA control path caps the resolution x frames volume, so resolution trades against duration: 720p allows up to ~6s (sharper), 480p up to ~15s (softer but longer). A request above the b… | 480p | 720p · default: "720p" |
| frames_per_second | number | Frames per second of the generated video. | 1 ≤ n ≤ 60 · default: 24 |
| num_inference_steps | integer | Number of inference steps. Defaults to 15 and can be increased up to 30. | 8 ≤ n ≤ 30 · default: 15 |
| guidance_scale | number | Classifier-free guidance scale. The default is tuned for fast, high-quality generation. | 1 ≤ n ≤ 20 · default: 1 |
| detail_refine_strength | number | Denoise strength of the detailer pass, used only when enable_detail_refine is on. Higher regenerates more detail (and can drift further from the base); lower is a lighter touch that stays closer to the base. Default 0.75. | 0.3 ≤ n ≤ 0.95 · default: 0.75 |
| prompt | string | The text prompt, pre-filled with the `3DREAL` trigger the adapter activates on. Describe the photorealistic result after it. The `3DREAL` trigger is always kept, even if you clear it or enable prompt expansion. | default: "3DREAL. " |
| negative_prompt | string | The negative prompt to steer generation away from. | default: "color distortion, overexposure,… |
| enable_prompt_expansion | boolean | When enabled, an AI model expands your prompt into a richer description before generation (off by default sends it as written). The `3DREAL` trigger is always kept, and the final prompt used is returned in the output. | default: false |
| generate_audio | boolean | Whether to include audio in the returned video. When disabled, the final MP4 is returned without an audio track. | default: true |
| 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 |
| image_url | string | Optional reference image used as the FIRST frame (image-to-video anchor), matching how the adapter was trained. It defines the photoreal look of frame 0; leave empty to let the render alone drive the result. | nullable |
| video_quality | enum | The quality preset of the generated video. | low | medium | high | maximum · default: "high" |
| 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 |
| video_write_mode | enum | The write mode of the generated video. | fast | balanced | small · default: "balanced" |
| num_frames | integer | The number of output frames. Output duration is num_frames / frames_per_second. The IC-LoRA control budget caps the resolution x frames volume: roughly 6s at 720p or 15s at 480p; a request above it returns a 422 (lower num_frames, or use 480p). | 9 ≤ n ≤ 481 · default: 121 |
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/render-to-real","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}