# Ltx 2.3 Quality · Reference Video to Video API

> Kehotepohjainen generointi viitevideon ohjaamana, valinnaiset alku-, keski- ja loppuvaiheen avainruutukuvat

Luo uuden videon pakollisen `prompt`-parametrin ja liikkeen sekä rakenteen tarjoavan viitteen `video_url` perusteella. Valinnaiset `image_url`, `mid_image_url` ja `end_image_url` ankkuroivat ulkoasun alkuun, keskelle ja loppuun. `video_strength` ja `strength` (molemmat 0–1) määrittävät, kuinka tarkasti lähdettä seurataan tai säilytetään, ja `control_video_url` voi tarjota esilasketun ohjaussignaalin. `resolution` tarjoaa automaattisia tai kiinteitä esiasetuksia, kuten neliön sekä 16:9-pysty- tai vaakasuunnan.

- Model id: `ltx-2.3-quality/reference-video-to-video`
- Made by: Lightricks
- Category: Video to Video
- Output: video
- Price per megapixel of your output video: $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/reference-video-to-video`
- Quote: `POST https://api.doitong.ru/v1/quote/ltx-2.3-quality/reference-video-to-video`
- Docs page: https://doitong.com/fi/developers/models/ltx-2.3-quality/reference-video-to-video

## Pricing

Price: **$0.00241 / 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.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/reference-video-to-video` 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 |  |  | Generointia ohjaava kehote. |
| `video_url` | `video` | string (video URL) | yes |  |  | URL, joka osoittaa liikkeen ja rakenteen ohjaamiseen käytettävään viitevide oon. |
| `control_video_url` |  | string (video URL) \| null | no |  |  | Valinnainen esilaskettu ohjausvideo, jota käytetään sisäisen ohjauksen estimoinnin sijaan, kun se annetaan yhdessä asetuksen `skip_control_preprocess` kanssa. Siitä tulee suora ohjaussignaali, kun se on skaalattu uudelleen tulosteen mittojen ja ruutumäärän mukaiseksi. Video voi sisältää esimerkiksi valmiiksi renderöidyn syvyys-, reuna- tai poseerauskomposiitin. |
| `skip_control_preprocess` |  | boolean | no | `false` |  | Suora ohjaustila, joka käyttää asetusta `control_video_url` syvyyden, reunojen tai poseerauksen sisäisen estimoinnin sijaan; ilman kyseistä URL-osoitetta tämä asetus ohitetaan. Tämän tilan tulosteen mitoitus noudattaa määritettyjä mittoja 64:n kohdistuksella, jotta RGB- ja ohjausvideot pysyvät yhteensopivina, kun taas `auto` käyttää lähteen mittoja ja kuvasuhdetta LTX:n rajoissa. |
| `preserve_original_video` |  | boolean | no | `false` |  | Alkuperäisen videon säilytystila, joka on käytettävissä vain asetusten `skip_control_preprocess`, `video_url` ja `control_video_url` kanssa. Oletuksena poissa käytöstä se säilyttää tavallisen ohjauskäsittelyn; käyttöönotto aloittaa generoinnin osoitteesta `video_url` ja säilyttää samalla rakenteellisen ohjauksen osoitteesta `control_video_url`. `strength`-asetuksella tehtävä kohinanpoisto määrittää säilytettävän määrän: pienemmät arvot säilyttävät enemmän alkuperäisiä pikseleitä. |
| `image_url` | `image` | string (image URL) \| null | no |  |  | Valinnainen kuvan ankkurointityyli tai hahmon identiteetti ensimmäisen ruudun avainruuduksi. |
| `mid_image_url` |  | string (image URL) \| null | no |  |  | Valinnainen kuvan ankkuroitu ulkoasu leikkeen keskivaiheilla täydentämään alkuperäistä `image_url`-avainruutua. Se auttaa ulkoasua seuraamaan kameran liikettä ajautumisen sijaan; edellyttää asetusta `image_url`. |
| `end_image_url` | `end_image` | string (image URL) \| null | no |  |  | Valinnainen kuvan ankkuroitu ulkoasu leikkeen viimeisessä ruudussa. Hyödyllinen, kun kameran liike päättyy eri paikkaan kuin aloituskuva; edellyttää asetusta `image_url`. |
| `video_strength` |  | number | no | `0.6` | 0 – 1 | Viitevideon liikkeen ja rakenteen muuttamisen vapaus määräytyy tämän ehdollistamisen voimakkuudesta: pienemmät arvot sallivat suuremmat muutokset. |
| `strength` |  | number | no | `1` | 0 – 1 | Viitevideosta videoksi -näytteenoton kohinanpoiston ohjaus, jonka vaikutus riippuu asetuksesta `preserve_original_video`. Kun tila on poissa käytöstä, se vain lyhentää kohinanpoistoaikataulua; käytössä ollessaan se hallitsee lähdepikselien muuntamista: arvo 1.0 generoi kaiken uudelleen ja pienemmät arvot säilyttävät enemmän, esimerkiksi 0.5 säilyttää noin 50 %. |
| `num_frames` |  | integer | no | `121` | 9 – 481 | Tulosteen ruutumäärä, jota rajoittaa resoluution ja ruutujen tulon perusteella määräytyvä IC-LoRA-vakausbudjetti. Vastauksen 422 tarkoittaa, että budjetti ylitettiin: pienennä resoluutiota tai arvoa `num_frames`. Budjetti sallii noin 150 ruutua 720p-luokan mitoilla ja enemmän pienemmillä mitoilla. |
| `resolution` |  | object {width, height} \| enum (string) | no | `auto` | `auto`, `square_hd`, `square`, `portrait_4_3`, `portrait_16_9`, `landscape_4_3`, `landscape_16_9` | Tulostevideon mitat, jotka vaikuttavat myös vakaaseen kestoon: pienemmät koot sallivat enemmän ruutuja, kun taas suuremmat pienentävät enimmäismäärää. Sisäinen ohjauksen estimointi pitää koon lähellä virallista ohjaustyönkulkua; suora ohjaus asetuksilla `skip_control_preprocess` ja `control_video_url` noudattaa sen sijaan määritettyjä mittoja 64 pikselin kohdistuksella. Suorassa ohjaustilassa `auto` perii lähteen mitat ja kuvasuhteen LTX:n rajoissa. |
| `frames_per_second` |  | number | no | `24` | 1 – 60 | Tulostevideon ruutunopeus ruutuina sekunnissa. |
| `num_inference_steps` |  | integer | no | `15` | 8 – 30 | Määritä suoritettavien päättelyvaiheiden määrä, enintään 30; muuttamatta jätettynä käytetään arvoa 15. |
| `guidance_scale` |  | number | no | `1` | 1 – 20 | Säädä classifier-free guidance -ohjausta tällä asteikolla; oletus on viritetty sekä korkeaan laatuun että nopeaan generointiin. |
| `generate_audio` |  | boolean | no | `true` |  | Palautettavan MP4-tiedoston ääniraidan valitsin: poissa käytöstä tuottaa vain videon sisältävän tiedoston, käytössä sisältää äänen. |
| `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` |  | Negatiivinen kehote, joka määrittää, mitä generoinnissa tulee välttää. |
| `seed` |  | integer \| null | no |  |  | Generoinnin toistettavaksi tekevä siemen. Arvon None asettaminen valitsee siemenen satunnaisesti. |
| `enable_prompt_expansion` |  | boolean | no | `true` |  | Määrittää, onko kehotteen laajennus käytössä. |
| `enable_safety_checker` |  | boolean | no | `true` |  | Määrittää, onko turvallisuustarkistus käytössä. |
| `video_quality` |  | enum (string) | no | `high` | `low`, `medium`, `high`, `maximum` | Tulostevideoon käytettävä laatu-esiasetus. |
| `video_write_mode` |  | enum (string) | no | `balanced` | `fast`, `balanced`, `small` | Tuloksena syntyvän videon kirjoitustila. |

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
{
  "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
{
  "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?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "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 = {
    "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", 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",
      "input": {
        "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",
  "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": {
    "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} | Mallin tuottama video. |
| `seed` | integer | Generoinnissa käytetty todellinen siemen. |
| `prompt` | string | Generointikehote, mukaan lukien ennen käyttöä tehty laajennus. |

## 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
- 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
- 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