# Ltx 2.3 Quality · Reference Video to Video · LoRA API

> Referentievideogeneratie zoals de basisversie, maar met maximaal 3 aangepaste LoRA's

Genereert video met een verplichte `prompt` en een referentie-`video_url` voor beweging en structuur, en vereist daarnaast `loras`, maximaal 3 LoRA-bestanden van elk maximaal 3 GB. Optionele eerste, middelste en laatste keyframe-afbeeldingen (`image_url`, `mid_image_url`, `end_image_url`) verankeren het uiterlijk. `video_strength` en `strength` lopen van 0 to 1 en `num_frames` van 9 to 481.

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

## Pricing

Price: **$0.00271 / megapixel of output video**. 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.

The full example input below costs $0.304 = 304 API credits (112 MP output video × $0.002708).

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/reference-video-to-video/lora` 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 |
|---|---|---|---|---|---|---|
| `prompt` |  | string | yes |  |  | Prompt die de generatie aanstuurt. |
| `video_url` | `video` | string (video URL) | yes |  |  | URL die verwijst naar een referentievideo voor het sturen van beweging en structuur. |
| `control_video_url` |  | string (video URL) \| null | no |  |  | Optionele vooraf berekende controlevideo, gebruikt in plaats van ingebouwde controleschatting wanneer deze samen met `skip_control_preprocess` wordt opgegeven. Na resampling naar de uitvoerafmetingen en het aantal frames wordt deze het directe controlesignaal. De video kan bijvoorbeeld een al gerenderde diepte-, rand- of posecompositie bevatten. |
| `skip_control_preprocess` |  | boolean | no | `false` |  | Directe besturingsmodus met `control_video_url` in plaats van interne schatting van diepte, randen of pose; zonder die URL wordt deze instelling genegeerd. De uitvoerafmetingen respecteren in deze modus expliciete afmetingen met uitlijning op 64 om RGB- en controlevideo's gelijk te houden, terwijl `auto` de bronafmetingen en beeldverhouding binnen de LTX-limieten overneemt. |
| `preserve_original_video` |  | boolean | no | `false` |  | Modus voor behoud van de oorspronkelijke video, alleen beschikbaar met `skip_control_preprocess`, `video_url` en `control_video_url`. Standaard uitgeschakeld: standaardcontroleverwerking blijft intact; inschakelen start de generatie vanuit `video_url` en behoudt structurele begeleiding uit `control_video_url`. Denoising via `strength` bepaalt hoeveel behouden blijft; lagere instellingen behouden meer oorspronkelijke pixels. |
| `image_url` | `image` | string (image URL) \| null | no |  |  | Optionele stijl voor beeldverankering of karakteridentiteit als keyframe van het eerste frame. |
| `mid_image_url` |  | string (image URL) \| null | no |  |  | Optionele verankering van het uiterlijk rond het midden van de clip, als aanvulling op het initiële `image_url`-keyframe. Dit helpt het uiterlijk de camerabeweging te volgen in plaats van weg te drijven; vereist `image_url`. |
| `end_image_url` | `end_image` | string (image URL) \| null | no |  |  | Optionele verankering van het uiterlijk bij het laatste frame van de clip. Nuttig wanneer de camerabeweging eindigt op een andere locatie dan de startafbeelding; vereist `image_url`. |
| `video_strength` |  | number | no | `0.6` | 0 – 1 | De vrijheid om beweging en structuur van de referentievideo aan te passen wordt bepaald door deze conditioneringssterkte: lagere instellingen staan grotere wijzigingen toe. |
| `strength` |  | number | no | `1` | 0 – 1 | Denoisingregeling voor sampling van referentievideo naar video, waarvan het effect afhangt van `preserve_original_video`. Als die modus uitstaat, verkort dit alleen het denoising-schema; als hij aanstaat, bepaalt dit de transformatie van de bronpixels. Met 1.0 wordt alles opnieuw gegenereerd en lagere instellingen behouden meer, bijvoorbeeld 0.5 behoudt ongeveer 50%. |
| `num_frames` |  | integer | no | `121` | 9 – 481 | Aantal uitvoerframes, onderhevig aan een IC-LoRA-stabiliteitsbudget op basis van resolutie vermenigvuldigd met frames. Een 422-response betekent dat dit budget is overschreden: verlaag de resolutie of `num_frames`. Het budget staat ongeveer 150 frames toe bij afmetingen van 720p-klasse en meer bij kleinere formaten. |
| `resolution` |  | object {width, height} \| enum (string) | no | `auto` | `auto`, `square_hd`, `square`, `portrait_4_3`, `portrait_16_9`, `landscape_4_3`, `landscape_16_9` | Afmetingen van de uitvoervideo, die ook de stabiele duur beïnvloeden: kleinere formaten staan meer frames toe, terwijl grotere formaten het maximum verlagen. Ingebouwde controleschatting houdt het formaat dicht bij de officiële control-workflow; directe besturing via `skip_control_preprocess` en `control_video_url` respecteert daarentegen expliciete afmetingen met uitlijning op 64. In de directe besturingsmodus neemt `auto` de bronafmetingen en beeldverhouding over binnen de LTX-limieten. |
| `frames_per_second` |  | number | no | `24` | 1 – 60 | Framesnelheid van de uitvoervideo, gemeten in frames per seconde. |
| `num_inference_steps` |  | integer | no | `15` | 8 – 30 | Stel het aantal inference-stappen in, maximaal 30; ongewijzigd gebruikt dit 15. |
| `guidance_scale` |  | number | no | `1` | 1 – 20 | Pas classifier-free guidance aan met deze schaal; de standaardafstelling is gericht op zowel hoge kwaliteit als snelle generatie. |
| `generate_audio` |  | boolean | no | `true` |  | Schakelaar voor de audiotrack van de geretourneerde MP4: uit levert een bestand zonder audio op, aan voegt audio toe. |
| `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` |  | Negatieve prompt die specificeert wat de generatie moet vermijden. |
| `seed` |  | integer \| null | no |  |  | Seed die generatie reproduceerbaar maakt. Als je deze instelt op None, wordt willekeurig een seed gekozen. |
| `enable_prompt_expansion` |  | boolean | no | `true` |  | Bepaalt of promptuitbreiding is ingeschakeld. |
| `enable_safety_checker` |  | boolean | no | `true` |  | Bepaalt of veiligheidscontrole is ingeschakeld. |
| `video_quality` |  | enum (string) | no | `high` | `low`, `medium`, `high`, `maximum` | Kwaliteitsvoorinstelling die op de uitvoervideo wordt toegepast. |
| `video_write_mode` |  | enum (string) | no | `balanced` | `fast`, `balanced`, `small` | Schrijfmodus van de resulterende video. |
| `loras` |  | array of object {path, scale, transformer} | yes |  | ≤ 3 items | LoRA-toevoegingen voor LTX-2.3, elk beperkt tot 3 GB, met maximaal 3 toegestane items. Laden gebeurt pas nadat de SSRF-veilige downloader van het register elk pad heeft opgehaald. |
| `loras[].path` |  | string | yes |  | ≤ 2048 characters | Directe HTTP(S)-URL voor een LoRA .safetensors-bestand van maximaal 3 GB. Laden wordt voorafgegaan door ophalen via een SSRF-veilige downloader. |
| `loras[].scale` |  | number | no | `1` | 0 – 2 | De invloed van LoRA op de gegenereerde video neemt toe naarmate deze sterkte binnen het bereik 0.0–2.0 stijgt. |
| `loras[].transformer` |  | enum (string) | no | `both` | `high`, `low`, `both` | Selectievlag voor de transformer: 'both' is geschikt voor vrijwel iedereen die LTX-2.3 gebruikt, omdat het model slechts één transformer heeft. De vlag ondersteunt toekomstige architecturen met meerdere transformers. |

File parameters (`video`, `control_video_url`, `image`, `mid_image_url`, `end_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
{
  "loras": [
    {
      "path": "https://example.com/your-file.safetensors"
    }
  ],
  "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
  "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
}
```

A fuller example:

```json
{
  "loras": [
    {
      "path": "https://example.com/your-file.safetensors"
    }
  ],
  "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
  "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/reference-video-to-video/lora?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "loras": [
      {
        "path": "https://example.com/your-file.safetensors"
      }
    ],
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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/reference-video-to-video/lora?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "loras": [
      {
        "path": "https://example.com/your-file.safetensors"
      }
    ],
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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 = {
    "loras": [
        {
            "path": "https://example.com/your-file.safetensors",
        },
    ],
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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/reference-video-to-video/lora", 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/reference-video-to-video/lora",
      "input": {
        "loras": [
          {
            "path": "https://example.com/your-file.safetensors"
          }
        ],
        "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
        "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/reference-video-to-video/lora",
  "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": 304,
    "usd": "0.304",
    "charged": 304,
    "refunded": 0
  },
  "input": {
    "loras": [
      {
        "path": "https://example.com/your-file.safetensors"
      }
    ],
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "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} | Video die door het model is geproduceerd. |
| `seed` | integer | Werkelijke seed die tijdens de generatie wordt toegepast. |
| `prompt` | string | Generatieprompt, inclusief eventuele uitbreiding die vóór gebruik is toegepast. |

## 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/reference-video-to-video/lora
- 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/reference-video-to-video/lora
- Errors: https://doitong.com/developers/docs/errors
- Model details as JSON: https://api.doitong.ru/v1/models/ltx-2.3-quality/reference-video-to-video/lora