# Ltx 2.3 Quality · Render to Real API

> Mengubah rekaman render 3D, CG, atau game menjadi video fotorealistis dengan intensitas yang dapat dipilih

Mengonversi render 3D yang diberikan sebagai `video_url` menjadi tampilan yang lebih realistis. `intensity` dapat berupa light, strong, atau strong-v2, dari ringan hingga agresif. `image_url` opsional menetapkan bingkai pertama fotorealistik, dan `enable_detail_refine` menambahkan tahap penajaman kedua dengan `detail_refine_strength` dari 0.3 hingga 0.95. Prompt mempertahankan pemicu `3DREAL`, dan output berupa 480p atau 720p.

- Model id: `ltx-2.3-quality/render-to-real`
- Made by: Lightricks
- Category: Video to Video
- Output: video
- Price per megapixel of your output video: from $0.00241 / megapixel of output video (cheapest run $0.003 (3 API credits))
- Run: `POST https://api.doitong.com/v1/run/ltx-2.3-quality/render-to-real`
- Quote: `POST https://api.doitong.com/v1/quote/ltx-2.3-quality/render-to-real`
- Docs page: https://doitong.com/id/developers/models/ltx-2.3-quality/render-to-real

## Pricing

Price: **from $0.00241 / megapixel of output video** (the lowest tier; the quote prices your exact input). Price per megapixel of your output video: the input files are measured before the run (length, resolution, frame rate). The quote measures the same files and is exactly what the run charges.

Price by tier:

- base rate: $0.00241 / megapixel of output video
- detail refine: $0.00963 / megapixel of output video

The full example input below costs $0.27 = 270 API credits (112 MP output video × $0.002408).

Prices are the upstream price in USD, paid from the API balance in API credits (1000 API credits = 1 USD). `POST https://api.doitong.com/v1/quote/ltx-2.3-quality/render-to-real` with the same JSON body returns the exact price for that input; the quote is exactly what a run charges. Invalid input is never charged and failed or canceled requests are refunded automatically.

## Input parameters

Send either the canonical name or the native field name (not both). Canonical names are the same across models.

| Parameter | Canonical name | Type | Required | Default | Allowed values / range | Description |
|---|---|---|---|---|---|---|
| `video_url` | `video` | string (video URL) | yes |  |  | URL yang mengarah ke video 3D, CG, atau hasil render game untuk konversi fotorealistis. |
| `image_url` | `image` | string (image URL) \| null | no |  |  | Jangkar gambar opsional untuk bingkai 0, yang menetapkan tampilan fotorealistisnya. Tanpanya, hanya render yang memandu hasil; jika diberikan, gambar menjadi bingkai pertama, sesuai dengan pelatihan image-to-video adapter. |
| `intensity` |  | enum (string) | no | `light` | `light`, `strong`, `strong-v2` | Tingkat transformasi fotorealistis, dengan `strong-v2` memilih adapter terbaru yang disempurnakan untuk koherensi lebih baik antaradegan, audio, karakter yang berbicara, dan kualitas keseluruhan. Untuk opsi lain, pilih `light` untuk mempertahankan lebih banyak tampilan dan gerakan render sumber, atau `strong` untuk perubahan yang lebih agresif menuju fotorealisme. |
| `enable_detail_refine` |  | boolean | no | `false` |  | Mengaktifkan tahap penyempurnaan tambahan untuk meningkatkan ketajaman dan resolusi; dinonaktifkan secara bawaan. Setelah pembuatan dasar, upscaler spasial memperbesar latent video sebesar 2x, lalu proses detailer singkat menyempurnakannya menggunakan model distilled. |
| `detail_refine_strength` |  | number | no | `0.75` | 0.3 – 0.95 | Kekuatan denoising detailer, dengan nilai bawaan 0.75 dan hanya berlaku jika `enable_detail_refine` diaktifkan. Untuk perubahan yang lebih lembut dan mempertahankan hasil dasar, gunakan pengaturan yang lebih rendah; meningkatkannya akan membuat ulang detail secara lebih luas, tetapi berisiko menghasilkan perbedaan yang lebih besar. |
| `prompt` |  | string | no | `3DREAL.` |  | Prompt teks untuk hasil fotorealistis yang diinginkan, ditulis setelah pemicu aktivasi adapter `3DREAL` yang telah diisi sebelumnya. Menghapus prompt maupun mengaktifkan perluasan prompt tidak menghapus pemicu tersebut; pemicu selalu dipertahankan. |
| `resolution` |  | enum (string) | no | `720p` | `480p`, `720p` | Pilih resolusi sisi pendek output sambil mempertahankan rasio aspek sumber: 480p menghasilkan hasil yang lebih lembut untuk klip hingga sekitar 15 detik, sedangkan 720p menghasilkan hasil yang lebih tajam hingga sekitar 6 detik. Pilih 480p untuk klip yang lebih panjang karena jalur kontrol IC-LoRA membatasi hasil perkalian resolusi dan jumlah bingkai; permintaan yang melebihi anggaran tersebut ditolak dengan error yang jelas. Hitung durasi output sebagai `num_frames` / `frames_per_second`. |
| `num_frames` |  | integer | no | `121` | 9 – 481 | Jumlah bingkai output, yang tunduk pada anggaran IC-LoRA berdasarkan hasil perkalian resolusi dan bingkai: sekitar 6 detik pada 720p atau 15 detik pada 480p. Melebihi anggaran tersebut mengembalikan 422; kurangi `num_frames` atau pilih 480p. Durasi klip dalam detik sama dengan `num_frames` / `frames_per_second`. |
| `frames_per_second` |  | number | no | `24` | 1 – 60 | Laju bingkai video output, diukur dalam bingkai per detik. |
| `num_inference_steps` |  | integer | no | `15` | 8 – 30 | Atur jumlah langkah inferensi yang dijalankan, hingga 30; jika tidak diubah, nilainya 15. |
| `guidance_scale` |  | number | no | `1` | 1 – 20 | Sesuaikan classifier-free guidance menggunakan skala ini; penyetelan bawaannya menargetkan kualitas tinggi sekaligus pembuatan cepat. |
| `generate_audio` |  | boolean | no | `true` |  | Sakelar trek audio untuk MP4 yang dikembalikan: nonaktif menghasilkan file khusus video, sedangkan aktif menyertakan audio. |
| `negative_prompt` |  | string | no | `color distortion, overexposure, static, blurry details, subtitles, style, artwork, painting, frame, still, dim overall tone, worst quality, low quality, JPEG compression artifacts, ugly, mutilated, extra fingers, poorly drawn hands, poorly drawn face, deformed, disfigured, malformed limbs, fused fingers, motionless frame, cluttered background, three legs, crowded background, walking backwards` |  | Prompt negatif yang menentukan hal-hal yang harus dihindari dalam pembuatan. |
| `enable_prompt_expansion` |  | boolean | no | `false` |  | Pengayaan prompt pembuatan berbasis AI, dinonaktifkan secara bawaan agar susunan kata Anda diteruskan tanpa perubahan. Output melaporkan prompt yang sebenarnya digunakan dan selalu mempertahankan `3DREAL`; mengaktifkan perluasan memungkinkan model AI menguraikan deskripsi sebelum pembuatan. |
| `seed` |  | integer \| null | no |  |  | Seed yang membuat pembuatan dapat direproduksi. Mengaturnya ke None akan memilih seed secara acak. |
| `enable_safety_checker` |  | boolean | no | `true` |  | Mengontrol apakah pemeriksaan keamanan diaktifkan. |
| `video_quality` |  | enum (string) | no | `high` | `low`, `medium`, `high`, `maximum` | Preset kualitas yang diterapkan pada video output. |
| `video_write_mode` |  | enum (string) | no | `balanced` | `fast`, `balanced`, `small` | Mode penulisan untuk video yang dihasilkan. |

File parameters (`video`, `image`) take a public `https://` URL, a `data:` URI up to 10 MB, or the `file_url` of an upload from `POST /files`.

## Example input

Required parameters only:

```json
{
  "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
}
```

A fuller example:

```json
{
  "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
}
```

## Run it

Set `DOITONG_API_KEY` to a key from https://doitong.com/developers/dashboard#keys. `?wait=20` returns the finished request in the same call when it is ready within 20 seconds; otherwise poll `GET /requests/{id}` (it also accepts `?wait=`), or pass `webhook_url`.

### curl

```bash
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ltx-2.3-quality/render-to-real?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"
```

### JavaScript

```javascript
const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/ltx-2.3-quality/render-to-real?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
```

### Python

```python
import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/ltx-2.3-quality/render-to-real", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
```

### MCP

The MCP server at `https://api.doitong.com/v1/mcp` exposes the tools `search_models`, `get_model`, `quote`, `run`, `get_request`, `cancel_request`, `list_requests`, `create_upload` and `get_account`. A `run` call for this model:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "ltx-2.3-quality/render-to-real",
      "input": {
        "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
      },
      "wait_seconds": 20
    }
  }
}
```

## Response

Every call returns a request object. `status` is one of `queued`, `running`, `succeeded`, `failed`, `canceled`. `outputs` lists the generated files with URLs on our storage (kept forever, or 7 days with `?storage=temporary`; `storage` says which); `output` is the model's own result object with the same URLs.

```json
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ltx-2.3-quality/render-to-real",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 270,
    "usd": "0.27",
    "charged": 270,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "seed": 42,
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
```

### Output fields (`output`)

| Field | Type | Description |
|---|---|---|
| `video` | object {url, content_type, file_name, file_size} | Video yang dihasilkan model. |
| `seed` | integer | Seed aktual yang diterapkan selama pembuatan. |
| `prompt` | string | Prompt pembuatan, termasuk ekspansi yang diterapkan sebelum digunakan. |

## Related models

- [Ltx 2.3 Quality · Text to Video](https://doitong.com/developers/models/ltx-2.3-quality/text-to-video.md) (`ltx-2.3-quality/text-to-video`): $0.00241 / megapixel of output video
- [Ltx 2.3 Quality · Text to Video · LoRA](https://doitong.com/developers/models/ltx-2.3-quality/text-to-video/lora.md) (`ltx-2.3-quality/text-to-video/lora`): $0.00271 / megapixel of output video
- [Ltx 2.3 Quality · Image to Video](https://doitong.com/developers/models/ltx-2.3-quality/image-to-video.md) (`ltx-2.3-quality/image-to-video`): $0.00241 / megapixel of output video
- [Ltx 2.3 Quality · Image to Video · LoRA](https://doitong.com/developers/models/ltx-2.3-quality/image-to-video/lora.md) (`ltx-2.3-quality/image-to-video/lora`): $0.00271 / megapixel of output video
- [Ltx 2.3 Quality · Ingredient](https://doitong.com/developers/models/ltx-2.3-quality/ingredient.md) (`ltx-2.3-quality/ingredient`): $0.00241 / megapixel of output video
- [Ltx 2.3 Quality · Clean Plate](https://doitong.com/developers/models/ltx-2.3-quality/clean-plate.md) (`ltx-2.3-quality/clean-plate`): $0.00241 / megapixel of output video
- [Ltx 2.3 Quality · Colorization](https://doitong.com/developers/models/ltx-2.3-quality/colorization.md) (`ltx-2.3-quality/colorization`): $0.00241 / megapixel of output video
- [Ltx 2.3 Quality · Cross Eyed](https://doitong.com/developers/models/ltx-2.3-quality/cross-eyed.md) (`ltx-2.3-quality/cross-eyed`): $0.00241 / megapixel of output video

## Links

- HTML page: https://doitong.com/developers/models/ltx-2.3-quality/render-to-real
- All models and guides for AI agents: https://doitong.com/developers/llms.txt
- OpenAPI 3.1 with this model's typed request body: https://doitong.com/developers/openapi.json?model=ltx-2.3-quality/render-to-real
- Errors: https://doitong.com/developers/docs/errors
- Model details as JSON: https://api.doitong.com/v1/models/ltx-2.3-quality/render-to-real