# Ltx 2.3 Quality · Render to Real API

> Transforma gravações de renderização 3D, CG ou de jogos em um vídeo fotorrealista, com intensidade selecionável

Converte um render 3D fornecido como `video_url` em uma aparência mais realista. `intensity` pode ser light, strong ou strong-v2, de suave a agressiva. Um `image_url` opcional define o primeiro quadro fotorrealista, e `enable_detail_refine` adiciona uma segunda etapa de nitidez com `detail_refine_strength` de 0.3 a 0.95. O prompt mantém o gatilho `3DREAL`, e a saída é 480p ou 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.ru/v1/run/ltx-2.3-quality/render-to-real`
- Quote: `POST https://api.doitong.ru/v1/quote/ltx-2.3-quality/render-to-real`
- Docs page: https://doitong.com/pt-BR/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.ru/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 que aponta para um vídeo renderizado em 3D, CG ou jogo para conversão fotorrealista. |
| `image_url` | `image` | string (image URL) \| null | no |  |  | Âncora de imagem opcional para o quadro 0, estabelecendo sua aparência fotorrealista. Sem ela, apenas a renderização orienta o resultado; quando fornecida, a imagem se torna o primeiro quadro, de acordo com o treinamento de imagem para vídeo do adaptador. |
| `intensity` |  | enum (string) | no | `light` | `light`, `strong`, `strong-v2` | Nível de transformação fotorrealista, com `strong-v2` selecionando o adaptador aprimorado mais recente para melhor coerência entre cenas, áudio, personagens falantes e qualidade geral. Para as outras opções, escolha `light` para preservar mais a aparência e o movimento da renderização de origem, ou `strong` para mudanças mais agressivas em direção ao fotorrealismo. |
| `enable_detail_refine` |  | boolean | no | `false` |  | Ativa uma etapa adicional de refinamento para aumentar a nitidez e a resolução; desativada por padrão. Após a geração base, um upscaler espacial amplia o latente do vídeo em 2x e, em seguida, uma breve etapa de detalhamento o refina usando o modelo destilado. |
| `detail_refine_strength` |  | number | no | `0.75` | 0.3 – 0.95 | Intensidade de redução de ruído do detalhador, com padrão 0.75 e aplicável somente quando `enable_detail_refine` está ativado. Para edições mais suaves que preservam o resultado base, use uma configuração menor; aumentá-la regenera os detalhes de forma mais abrangente, mas pode causar maior divergência. |
| `prompt` |  | string | no | `3DREAL.` |  | Prompt de texto para o resultado fotorrealista desejado, escrito após o gatilho de ativação do adaptador `3DREAL` preenchido previamente. Nem limpar o prompt nem ativar a expansão do prompt remove esse gatilho; ele é sempre mantido. |
| `resolution` |  | enum (string) | no | `720p` | `480p`, `720p` | Escolha a resolução do lado menor da saída mantendo a proporção da fonte: 480p produz resultados mais suaves para clipes de até aproximadamente 15 segundos, enquanto 720p produz resultados mais nítidos por até aproximadamente 6 segundos. Escolha 480p para clipes mais longos, pois o caminho de controle IC-LoRA limita a resolução multiplicada pela quantidade de quadros; requisições que excedem esse limite são rejeitadas com um erro claro. Calcule a duração da saída como `num_frames` / `frames_per_second`. |
| `num_frames` |  | integer | no | `121` | 9 – 481 | Quantidade de quadros da saída, sujeita a um limite do IC-LoRA sobre a resolução multiplicada pelos quadros: aproximadamente 6 segundos em 720p ou 15 segundos em 480p. Exceder esse limite retorna 422; reduza `num_frames` ou selecione 480p. A duração do clipe em segundos é igual a `num_frames` / `frames_per_second`. |
| `frames_per_second` |  | number | no | `24` | 1 – 60 | Taxa de quadros do vídeo de saída, medida em quadros por segundo. |
| `num_inference_steps` |  | integer | no | `15` | 8 – 30 | Defina quantas etapas de inferência executar, até 30; deixar inalterado usa 15. |
| `guidance_scale` |  | number | no | `1` | 1 – 20 | Ajuste classifier-free guidance usando esta escala; seu ajuste padrão busca alta qualidade e geração rápida. |
| `generate_audio` |  | boolean | no | `true` |  | Alternância da faixa de áudio do MP4 retornado: desativada produz um arquivo somente com vídeo, e ativada inclui áudio. |
| `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 negativo que especifica o que a geração deve evitar. |
| `enable_prompt_expansion` |  | boolean | no | `false` |  | Enriquecimento do prompt de geração baseado em IA, desativado por padrão para que sua redação passe sem alterações. A saída informa o prompt realmente usado, sempre mantendo `3DREAL`; ativar a expansão permite que um modelo de IA desenvolva a descrição antes da geração. |
| `seed` |  | integer \| null | no |  |  | Seed que torna a geração reproduzível. Defini-lo como None seleciona uma seed aleatoriamente. |
| `enable_safety_checker` |  | boolean | no | `true` |  | Controla se a verificação de segurança está ativada. |
| `video_quality` |  | enum (string) | no | `high` | `low`, `medium`, `high`, `maximum` | Predefinição de qualidade aplicada ao vídeo de saída. |
| `video_write_mode` |  | enum (string) | no | `balanced` | `fast`, `balanced`, `small` | Modo de gravação do vídeo resultante. |

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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"
```

### JavaScript

```javascript
const API = "https://api.doitong.ru/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.ru/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.ru/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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
```

### Output fields (`output`)

| Field | Type | Description |
|---|---|---|
| `video` | object {url, content_type, file_name, file_size} | Vídeo produzido pelo modelo. |
| `seed` | integer | Seed efetivamente aplicada durante a geração. |
| `prompt` | string | Prompt de geração, incluindo qualquer expansão aplicada antes do uso. |

## 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.ru/v1/models/ltx-2.3-quality/render-to-real