--- url: /orchestration/recipes/ltx2.md --- > Documentation index: https://developer.civitai.com/llms.txt — every page on this site has a markdown version at its URL + `.md`. # LTX2 video generation LTX2 is Lightricks' open video-generation model family. The orchestrator exposes both LTX2 and the newer LTX2.3 through the `videoGen` step, running on Civitai's ComfyUI workers. This recipe covers both versions end-to-end. ## Versions at a glance | `engine` | Models | Operations | Notes | |----------|--------|------------|-------| | `ltx2.3` | `22b-dev`, `22b-distilled` | `createVideo`, `firstLastFrameToVideo`, `editVideo`, `extendVideo`, `videoToVideo`, `audioToVideo` | Current release. Adds style transfer (`videoToVideo`) and audio-driven talking-head generation (`audioToVideo`). | | `ltx2` | `19b-dev`, `19b-distilled` | `createVideo`, `firstLastFrameToVideo`, `editVideo`, `extendVideo` | Previous release. Still supported. | **Default choice**: `engine: "ltx2.3"`, `model: "22b-distilled"` for speed, `"22b-dev"` for maximum quality. ## The request shape Every LTX2 request is a single `videoGen` step on [`SubmitWorkflow`](https://developer.civitai.com/orchestration/reference/operations/SubmitWorkflow.md). Three keys select which LTX2 variant runs: ```json { "$type": "videoGen", "input": { "engine": "ltx2.3", // ltx2 | ltx2.3 "operation": "createVideo", // see table above "model": "22b-distilled" // version-specific } } ``` There's no `provider` discriminator — LTX2 currently only runs on Comfy. Each combination dispatches to its typed input schema (`ComfyLtx23CreateVideoInput`, `ComfyLtx2EditVideoInput`, …) so fields invalid for that combination get rejected with a `400`. ### Source-media inputs `editVideo`, `extendVideo`, `videoToVideo`, and `audioToVideo` accept `sourceVideo` / `sourceAudio` as either: * a Civitai AIR URN (`urn:air:…`), or * a civitai-hosted URL (`image.civitai.com`, orchestrator blob URLs, civitai-managed R2 / B2 / Spaces). Arbitrary third-party URLs (e.g. `raw.githubusercontent.com`, `cdn.jsdelivr.net`) are **not** fetched — requests that pass one are rejected with a `400`. Upload the media to Civitai first and pass the resulting URL. `images`, `firstFrame`, `lastFrame`, and `referenceImage` go through a separate image pipeline and *do* accept external URLs — only video/audio inputs have this restriction today. ## Operations All examples target production and use `` in place of your Bearer token. LTX2 jobs typically outlast [your HTTP client's timeout](https://developer.civitai.com/orchestration/guide/getting-started.md#_3-poll-if-you-didn-t-wait-inline) — submit with `wait=0` and handle completion via webhooks or polling. ### createVideo Single operation covers both **text-to-video** and **image-to-video** — add `images` to turn any text-to-video request into image-to-video. ```http POST https://orchestration.civitai.com/v2/consumer/workflows?whatif=false&wait=0 Authorization: Bearer Content-Type: application/json { "steps": [{ "$type": "videoGen", "input": { "engine": "ltx2.3", "operation": "createVideo", "model": "22b-distilled", "prompt": "A beautiful sunset over the ocean with waves crashing", "duration": 5, "width": 1280, "height": 720, "fps": 24, "generateAudio": false, "guidanceScale": 4, "numInferenceSteps": 20 } }] } ``` Image-to-video: pass one or more images via `images`. ```json { "engine": "ltx2.3", "operation": "createVideo", "model": "22b-dev", "prompt": "The cat starts walking and exploring", "images": [ "https://image.civitai.com/.../42750475.jpeg" ], "duration": 5, "width": 1280, "height": 720, "fps": 24 } ``` ### firstLastFrameToVideo Interpolate between two keyframes (or extend from a single first frame). ```json { "engine": "ltx2.3", "operation": "firstLastFrameToVideo", "model": "22b-dev", "prompt": "smooth transition from morning to night", "firstFrame": "https://.../start.jpeg", "lastFrame": "https://.../end.jpeg", "frameGuideStrength": 0.8, "duration": 5, "width": 1280, "height": 720, "fps": 24 } ``` Omit `lastFrame` to seed the motion from just the first frame. ### editVideo Input video + prompt → transformed video. Uses Canny edge-maps for structural preservation. ```json { "engine": "ltx2.3", "operation": "editVideo", "model": "22b-dev", "prompt": "Transform the scene into a cyberpunk aesthetic with neon lighting", "sourceVideo": "https://.../input.mp4", "cannyLowThreshold": 0.4, "cannyHighThreshold": 0.8, "guideStrength": 0.7 } ``` ### extendVideo Continue an existing clip for `numFrames` more frames. ```json { "engine": "ltx2.3", "operation": "extendVideo", "model": "22b-dev", "prompt": "The scene continues with gentle camera push-in", "sourceVideo": "https://.../clip.mp4", "numFrames": 48, "fps": 24 } ``` ### videoToVideo *(LTX2.3 only)* Style-transfer an entire video. ```json { "engine": "ltx2.3", "operation": "videoToVideo", "model": "22b-dev", "prompt": "Rendered in the style of a watercolor painting", "sourceVideo": "https://.../clip.mp4" } ``` ### audioToVideo *(LTX2.3 only)* Audio-driven generation. With just `sourceAudio`, produces a matching visual scene; add `referenceImage` for talking-head / lip-sync output. ```json { "engine": "ltx2.3", "operation": "audioToVideo", "model": "22b-dev", "prompt": "A person speaks directly to camera with natural lip movements", "negativePrompt": "frozen lips, off-sync lips, blurry", "sourceAudio": "https://.../voiceover.mp3", "referenceImage": "https://.../portrait.jpeg", "audioToVideoAttentionScale": 2.0, "imageGuideStrength": 0.7, "duration": 5, "width": 1280, "height": 720, "fps": 24 } ``` ## Common parameters Shared across most (engine, operation) combinations. The per-variant schema in the [API reference](https://developer.civitai.com/orchestration/reference.md) is authoritative. | Field | Typical values | Notes | |-------|----------------|-------| | `model` | `22b-dev` / `22b-distilled` (2.3); `19b-dev` / `19b-distilled` (2.0) | `-distilled` is faster with slightly lower fidelity; `-dev` is maximum quality. | | `width` / `height` | `1280×720`, `720×1280`, `1024×1024` | Vertical for phones: swap to `720×1280`. | | `duration` | `3`–`20` seconds (2.3); `3` or `5` (2.0) | Whole seconds; default `5`. | | `fps` | `24`, `30` | Frame rate of the generated clip. | | `guidanceScale` | `3`–`7` | Prompt adherence. Higher = closer to prompt but less creative. | | `numInferenceSteps` | `8`–`50` | `20`–`40` is the practical quality sweet spot. More steps = higher quality, longer runtime. | | `generateAudio` | `true` / `false` | Emit a soundtrack alongside the video. | | `negativePrompt` | string | What you *don't* want. | | `seed` | integer | Reproducibility. | | `loras` | object | Attach community LoRAs to bias style or subject. Format: `{ "urn:air:lora:civitai:@": 0.8 }` — a dictionary keyed by AIR URN with the strength as the value. | ## Choosing a model | Need | Pick | |------|------| | Fastest turnaround, batch generation | `22b-distilled` (or `19b-distilled`) | | Highest fidelity, final-quality renders | `22b-dev` | | Parity with an older pipeline | `19b-dev` / `19b-distilled` | ## Reading the result Standard `videoGen` output: a single `video` blob ([shape and URL expiry](https://developer.civitai.com/orchestration/recipes.md#reading-results)). ## Long-running jobs LTX2.3 `22b-dev` at 1280×720 / 5 s typically runs 2–5 minutes; `editVideo` and `audioToVideo` can go longer. Submit with `wait=0`, then prefer a [webhook](https://developer.civitai.com/orchestration/guide/results-and-webhooks.md) (`workflow:succeeded` / `workflow:failed`) or poll `GET /v2/consumer/workflows/{workflowId}` on a 10 s → 30 s → 60 s cadence. ## Troubleshooting | Symptom | Likely cause | Fix | |---------|--------------|-----| | `400` with unknown field | Field isn't valid for this `(engine, operation)` combo | Check the specific `ComfyLtxInput` schema via [`SubmitWorkflow`](https://developer.civitai.com/orchestration/reference/operations/SubmitWorkflow.md). | | `400` "'sourceVideo' / 'sourceAudio' must be a Civitai AIR URN…" | Passed an external URL to `sourceVideo` or `sourceAudio` | Re-upload the media to Civitai and use the civitai-hosted URL, or pass a `urn:air:…` URN. See [Source-media inputs](#source-media-inputs). | | Step `failed`, `reason = "no_provider_available"` | No Comfy worker has the requested model warm | Retry shortly; or try the other model (`-dev` ↔ `-distilled`). | | Audio-to-video lip-sync poor | Attention scale too low, or audio clipping | Raise `audioToVideoAttentionScale` (e.g. `2.0` → `3.0`); re-encode source audio at constant bitrate. | | Edit-video loses structure | Canny guide too weak | Raise `guideStrength` (`0.7` → `0.85`) or widen the Canny thresholds. | ## Cost Preview the exact charge with `whatif=true` ([Payments (Buzz)](https://developer.civitai.com/orchestration/guide/submitting-work.md#payments-buzz)). All LTX2 / LTX2.3 variants use the same formula — pixel volume × a per-pixel rate × a steps multiplier: ``` numFrames = duration × fps pixelVolumeInMP = (width × height × numFrames) / 1 000 000 stepsMultiplier = steps / 20 total = ceil(pixelVolumeInMP × 1.2 × stepsMultiplier) ``` | Shape | Buzz | |-------|------| | 720p (1280×720), 5 s @ 24 fps, `steps: 20` | **~133** | | 720p, 5 s @ 24 fps, `steps: 40` | ~266 | | 720p, 10 s @ 24 fps, `steps: 20` | ~266 | | 1080p (1920×1080), 5 s @ 24 fps, `steps: 20` | ~299 | `extendVideo` and `editVideo` scale by their total output frame count the same way. LTX2 is the cheapest video-gen path Civitai exposes — expect roughly linear cost growth with pixels × frames × steps. ## Related * [`SubmitWorkflow`](https://developer.civitai.com/orchestration/reference/operations/SubmitWorkflow.md) · [`GetWorkflow`](https://developer.civitai.com/orchestration/reference/operations/GetWorkflow.md) * [Results & webhooks](https://developer.civitai.com/orchestration/guide/results-and-webhooks.md) — production-ready result handling * [WAN video generation](https://developer.civitai.com/orchestration/recipes/wan.md) — comparable recipe for the WAN model family * Full parameter catalog: the `ComfyLtx23Input` and `ComfyLtx2Input` schemas in the [API reference](https://developer.civitai.com/orchestration/reference.md) * [`videoGen` OpenAPI spec](https://orchestration.civitai.com/v2/consumer/recipes/videoGen/openapi.yaml)