3d render to real

Transform your 3D video render into realistic using first frame with Ltx 2.3

Table of contents

1. Calling the API

   • Install the client
   • Setup your API Key
   • Submit a request

2. Authentication

   • API Key

3. Queue

   • Submit a request
   • Fetch request status
   • Get the result

4. Files

   • Data URI (base64)
   • Hosted files (URL)
   • Uploading files

5. Schema

   • Input
   • Output
   • Other

About

Turn a stylized 3D / CG / game render into photorealistic footage.

Shares the effect IC-LoRA machinery (raw render into the Union Control guide, render-to-real adapter on node 5011, size auto from the render capped to the stable IC-LoRA budget), plus an optional first-frame image anchor (image-to-video) matching training. The caller writes the prompt (starting with the 3DREAL trigger). Prompt expansion runs when the caller enables it, but the 3DREAL trigger is always guaranteed in the final prompt (which is returned in the output).

1. Calling the API

Install the client

The client provides a convenient way to interact with the model API.

npm install --save @fal-ai/client

Setup your API Key

Set FAL_KEY as an environment variable in your runtime.

export FAL_KEY="YOUR_API_KEY"

Submit a request

The client API handles the API submit protocol. It will handle the request status updates and return the result when the request is completed.

import { fal } from "@fal-ai/client";

const result = await fal.subscribe("fal-ai/ltx-2.3-quality/render-to-real", {
  input: {
    video_url: "https://v3b.fal.media/files/b/0a8824b1/sdm0KfmenrlywesfzY1Y1_if6euPp1.mp4"
  },
  logs: true,
  onQueueUpdate: (update) => {
    if (update.status === "IN_PROGRESS") {
      update.logs.map((log) => log.message).forEach(console.log);
    }
  },
});
console.log(result.data);
console.log(result.requestId);

2. Authentication

The API uses an API Key for authentication. It is recommended you set the FAL_KEY environment variable in your runtime when possible.

API Key

In case your app is running in an environment where you cannot set environment variables, you can set the API Key manually as a client configuration.

import { fal } from "@fal-ai/client";

fal.config({
  credentials: "YOUR_FAL_KEY"
});

3. Queue

Submit a request

The client API provides a convenient way to submit requests to the model.

import { fal } from "@fal-ai/client";

const { request_id } = await fal.queue.submit("fal-ai/ltx-2.3-quality/render-to-real", {
  input: {
    video_url: "https://v3b.fal.media/files/b/0a8824b1/sdm0KfmenrlywesfzY1Y1_if6euPp1.mp4"
  },
  webhookUrl: "https://optional.webhook.url/for/results"
});

4. Files

Some attributes in the API accept file URLs as input. Whenever that's the case you can pass your own URL or a Base64 data URI.

Data URI (base64)

You can pass a Base64 data URI as a file input. The API will handle the file decoding for you.

5. Schema

Input

video_url string * required The URL of the 3D / CG / game render to make photorealistic.

intensity IntensityEnum How hard to push the render toward photorealism.

Default value: "light" Possible enum values: light, strong, strong-v2.

detail_refine_strength float Denoise strength of the detailer pass.

Default value: 0.75

prompt string The text prompt, pre-filled with the 3DREAL trigger the adapter activates on.

Default value: "3DREAL. "

resolution ResolutionEnum Output resolution (short side), preserving the source aspect ratio. Default value: "720p" Possible enum values: 480p, 720p.

num_frames integer The number of output frames.

Default value: 121

frames_per_second float Frames per second of the generated video.

Default value: 24

num_inference_steps integer Number of inference steps.

Default value: 15

guidance_scale float Classifier-free guidance scale.

Default value: 1

generate_audio boolean Whether to include audio in the returned video.

Default value: true

negative_prompt string The negative prompt to steer generation away from.

Default value: according to the requirements.

enable_safety_checker boolean Whether to enable the safety checker.

Default value: true

video_quality VideoQualityEnum The quality preset of the generated video.

Default value: "high" Possible enum values: low, medium, high, maximum.

video_write_mode VideoWriteModeEnum The write mode of the generated video.

Default value: "balanced" Possible enum values: fast, balanced, small.

sync_mode boolean If True, the media is returned as a data URI inline in the response.