—
LTX 2.3 Quality — Video to Video with LoRA
Generate high-quality video with audio from reference video, text and images using LTX-2.3 and custom LoRA
Input
Add your inputs and customize the generation settings.
Result & Pricing
Video output — your generated video will appear here.
Your video will appear here
Choose your inputs and customize your settings.
Model pricing (tax excluded) per generated video megapixel
| Specification | Webot INR |
|---|---|
| Rate | ₹0.32 |
Calculate credits in the input panel for your selected settings.
Prices, estimates and credit deductions exclude tax. Any applicable tax is charged only when you buy plans or credits.
Detail-pass cost factor: ×4. Prices are converted to INR. Credits use your current plan rate.
- Prices shown are estimates, not final charges. Final billing details will be available in Reports after generation is complete.
API
WEBOT API · Video to Video with LoRA
Generate from your server with your WEBOT account credits.
Use your 120-character WEBOT customer key (a–z, A–Z, 0–9). Send
Authorization: Bearer YOUR_KEY. Keys are secrets: call from a server, never from public frontend code. Results come from verified webhooks and remain saved if your stream disconnects.1. Configure your server
WEBOT_BASE_URL=https://webot.online
WEBOT_API_KEY=<your-server-side-WEBOT-key>This base URL is resolved from verified domain mappings and your direct creator reseller. Forwarded Host headers are not trusted. New custom reseller domains need DNS, TLS and platform verification before activation.
2. Quote, then generate
| Method | Endpoint | Purpose |
|---|---|---|
| POST | https://webot.online/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/quote | Validate input and calculate credits (no deduction). |
| POST | https://webot.online/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/requests | Reserve quoted credits and queue an asynchronous job. |
| GET | https://webot.online/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/requests/{request_id}/result | Read your saved result: 202 pending, 200 terminal. |
| GET | https://webot.online/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/requests/{request_id}/events | Authenticated SSE: generation / terminal events. |
Send JSON {"input":{…}} to quote. Send the same input plus integer quoted_credits to generate, with Authorization: Bearer … and Idempotency-Key. Use a unique 16–128 character key per new job; persist it and reuse the same key and input on any uncertain response. Never retry with a new key: that creates a second chargeable job.
Credits are reserved only after validation and a durable request is saved. A changed quote or insufficient balance returns 409. Credits exclude purchase taxes. The quoted amount is an initial reservation. After generation, the final charge replaces it using confirmed usage. Any verified unused allocation becomes available automatically; additional usage may require more credits. Missing billing stays pending, including for failed jobs.
3. Input example
Save this as input.json. Replace sample prompts, files and media URLs with your own. Schemas do not guarantee provider acceptance of the content.
{
"loras": [
{
"path": "https://example.com/source.png",
"scale": 1,
"transformer": "both"
}
],
"prompt": "Audit sample text",
"video_url": "https://example.com/video.mp4",
"resolution": {
"width": 1024,
"height": 576
},
"skip_control_preprocess": true,
"control_video_url": "https://example.com/control.mp4",
"num_inference_steps": 15,
"video_quality": "high",
"guidance_scale": 1,
"enable_safety_checker": true,
"video_strength": 0.6,
"preserve_original_video": false,
"enable_prompt_expansion": true,
"video_write_mode": "balanced",
"frames_per_second": 24,
"strength": 1,
"generate_audio": true,
"sync_mode": false,
"num_frames": 121,
"negative_prompt": "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"
}4. Language examples
# Save the model's example input as input.json, then replace prompts/media URLs.
# Requires curl and jq. Store NONCE once for this job; reuse it on any retry.
export NONCE="$(openssl rand -hex 16)"
BASE="${WEBOT_BASE_URL%/}"
jq -n --slurpfile input input.json '{input:$input[0]}' > quote-body.json
curl --fail-with-body -sS "$BASE/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/quote" \
-H "Authorization: Bearer $WEBOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @quote-body.json > quote.json
CREDITS=$(jq -er '.quote.credits_consumed' quote.json)
jq --argjson credits "$CREDITS" '. + {quoted_credits:$credits}' quote-body.json > request-body.json
curl --fail-with-body -sS "$BASE/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/requests" \
-H "Authorization: Bearer $WEBOT_API_KEY" -H "Idempotency-Key: $NONCE" \
-H 'Content-Type: application/json' --data-binary @request-body.json > job.json
# Subscribe; after a nonterminal disconnect, reconnect this SAME URL.
curl --fail-with-body -N "$(jq -er '.events_url' job.json)" -H "Authorization: Bearer $WEBOT_API_KEY"
# Read saved output after terminal notification (never call provider status/results).
curl --fail-with-body -sS "$(jq -er '.result_url' job.json)" -H "Authorization: Bearer $WEBOT_API_KEY"// Node.js 18+. Save your customized input in input.json.
import { readFileSync } from 'node:fs';
import { randomUUID } from 'node:crypto';
const base = process.env.WEBOT_BASE_URL.replace(/\/$/, '');
const key = process.env.WEBOT_API_KEY;
const input = JSON.parse(readFileSync('input.json', 'utf8'));
const nonce = process.env.WEBOT_JOB_NONCE || randomUUID(); // Persist before submission.
async function post(path, body, nonce) {
const response = await fetch(base + path, {method:'POST', headers:{
Authorization:`Bearer ${key}`, 'Content-Type':'application/json',
...(nonce ? {'Idempotency-Key':nonce} : {})}, body:JSON.stringify(body)});
const json = await response.json();
if (!response.ok) throw new Error(JSON.stringify(json));
return json;
}
const {quote} = await post('/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/quote', {input});
const job = await post('/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/requests', {input, quoted_credits:quote.credits_consumed}, nonce);
console.log(job); // Stable WEBOT request_id, events_url, result_url.
// Stream saved webhook state. Reconnect ONLY the event stream, not the generation.
while (!job.terminal || job.financial_pending) {
const stream = await fetch(job.events_url, {headers:{Authorization:`Bearer ${key}`}});
if (!stream.ok) throw new Error(`Event stream HTTP ${stream.status}`);
let buffer = '';
for await (const chunk of stream.body.pipeThrough(new TextDecoderStream())) {
buffer += chunk;
let end;
while ((end = buffer.indexOf('\n\n')) !== -1) {
const event = buffer.slice(0, end); buffer = buffer.slice(end + 2);
const data = event.split('\n').find(line => line.startsWith('data: '));
if (!data) continue;
const state = JSON.parse(data.slice(6));
if (state.error && !state.status) throw new Error(JSON.stringify(state.error));
if (state.terminal && !state.financial_pending) { console.log(state.output ?? state.error); process.exit(0); }
}
}
await new Promise(resolve => setTimeout(resolve, 1500));
}
console.log(job.output ?? job.error);// Node.js 18+. Save your customized input in input.json.
import { readFileSync } from 'node:fs';
import { randomUUID } from 'node:crypto';
const base = process.env.WEBOT_BASE_URL!.replace(/\/$/, '');
const key = process.env.WEBOT_API_KEY!;
const input = JSON.parse(readFileSync('input.json', 'utf8'));
const nonce = process.env.WEBOT_JOB_NONCE || randomUUID(); // Persist before submission.
async function post(path: string, body: unknown, nonce?: string) {
const response = await fetch(base + path, {method:'POST', headers:{
Authorization:`Bearer ${key}`, 'Content-Type':'application/json',
...(nonce ? {'Idempotency-Key':nonce} : {})}, body:JSON.stringify(body)});
const json = await response.json();
if (!response.ok) throw new Error(JSON.stringify(json));
return json;
}
const {quote} = await post('/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/quote', {input});
const job = await post('/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/requests', {input, quoted_credits:quote.credits_consumed}, nonce);
console.log(job); // Stable WEBOT request_id, events_url, result_url.
// Stream saved webhook state. Reconnect ONLY the event stream, not the generation.
while (!job.terminal || job.financial_pending) {
const stream = await fetch(job.events_url, {headers:{Authorization:`Bearer ${key}`}});
if (!stream.ok) throw new Error(`Event stream HTTP ${stream.status}`);
let buffer = '';
for await (const chunk of stream.body.pipeThrough(new TextDecoderStream())) {
buffer += chunk;
let end;
while ((end = buffer.indexOf('\n\n')) !== -1) {
const event = buffer.slice(0, end); buffer = buffer.slice(end + 2);
const data = event.split('\n').find(line => line.startsWith('data: '));
if (!data) continue;
const state = JSON.parse(data.slice(6));
if (state.error && !state.status) throw new Error(JSON.stringify(state.error));
if (state.terminal && !state.financial_pending) { console.log(state.output ?? state.error); process.exit(0); }
}
}
await new Promise(resolve => setTimeout(resolve, 1500));
}
console.log(job.output ?? job.error);# Python 3.9+, pip install requests
import json, os, time, uuid, requests
base = os.environ['WEBOT_BASE_URL'].rstrip('/')
headers = {'Authorization': 'Bearer ' + os.environ['WEBOT_API_KEY']}
with open('input.json', encoding='utf-8') as file:
input_data = json.load(file)
nonce = os.environ.get('WEBOT_JOB_NONCE') or str(uuid.uuid4()) # Persist before submitting.
def post(path, body, extra=None):
response = requests.post(base + path, headers={**headers, **(extra or {})}, json=body, timeout=180)
response.raise_for_status()
return response.json()
quote = post('/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/quote', {'input': input_data})['quote']
job = post('/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/requests', {'input': input_data, 'quoted_credits': quote['credits_consumed']}, {'Idempotency-Key': nonce})
state = job
while not state['terminal'] or state.get('financial_pending', False):
# Reconnect while nonterminal; this reads WEBOT's database, never a provider status API.
with requests.get(job['events_url'], headers=headers, stream=True, timeout=(10, 40)) as stream:
stream.raise_for_status()
for line in stream.iter_lines(decode_unicode=True):
if line and line.startswith('data: '):
state = json.loads(line[6:])
if 'status' not in state: raise RuntimeError(state)
if state['terminal'] and not state.get('financial_pending', False): break
if not state['terminal'] or state.get('financial_pending', False): time.sleep(1.5)
print(state['output'] if state['status'] == 'completed' else state['error'])<?php // PHP 8.1+ with cURL
$base = rtrim(getenv('WEBOT_BASE_URL'), '/');
$input = json_decode(file_get_contents('input.json'), false, 64, JSON_THROW_ON_ERROR);
$nonce = getenv('WEBOT_JOB_NONCE') ?: bin2hex(random_bytes(16)); // Persist this before submission.
function post(string $path, array $body, ?string $nonce = null): array {
global $base;
$headers = ['Authorization: Bearer '.getenv('WEBOT_API_KEY'), 'Content-Type: application/json'];
if ($nonce) $headers[] = 'Idempotency-Key: '.$nonce;
$ch = curl_init($base.$path);
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER=>true, CURLOPT_POST=>true,
CURLOPT_TIMEOUT=>180, CURLOPT_HTTPHEADER=>$headers,
CURLOPT_POSTFIELDS=>json_encode($body, JSON_THROW_ON_ERROR)]);
$raw = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch);
if ($raw === false || $status < 200 || $status >= 300) throw new RuntimeException('WEBOT HTTP '.$status);
return json_decode($raw, true, 64, JSON_THROW_ON_ERROR);
}
$quote = post('/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/quote', ['input'=>$input])['quote'];
$job = post('/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/requests', ['input'=>$input, 'quoted_credits'=>$quote['credits_consumed']], $nonce);
echo json_encode($job, JSON_PRETTY_PRINT); // Connect to events_url with the same Bearer header.// Go 1.20+; save as main.go.
package main
import ("bytes"; "encoding/json"; "fmt"; "io"; "net/http"; "os"; "strings"; "time"; "crypto/rand"; "encoding/hex")
func main() {
base := strings.TrimRight(os.Getenv("WEBOT_BASE_URL"), "/")
raw, err := os.ReadFile("input.json"); if err != nil { panic(err) }
nonce := os.Getenv("WEBOT_JOB_NONCE")
if nonce == "" { b := make([]byte,16); if _,err:=rand.Read(b);err!=nil {panic(err)}; nonce=hex.EncodeToString(b) }
// Persist nonce before the submission; reuse on ambiguous responses.
client := &http.Client{Timeout:180*time.Second}
post := func(path string, body any, id string) map[string]any {
data, err := json.Marshal(body); if err != nil {panic(err)}
req, err := http.NewRequest("POST",base+path,bytes.NewReader(data)); if err!=nil {panic(err)}
req.Header.Set("Authorization","Bearer "+os.Getenv("WEBOT_API_KEY")); req.Header.Set("Content-Type","application/json")
if id!="" {req.Header.Set("Idempotency-Key",id)}
res,err:=client.Do(req); if err!=nil {panic(err)}; defer res.Body.Close()
data,err=io.ReadAll(res.Body); if err!=nil {panic(err)}
if res.StatusCode<200||res.StatusCode>=300 {panic(string(data))}
var result map[string]any; if err=json.Unmarshal(data,&result);err!=nil {panic(err)}; return result
}
input:=json.RawMessage(raw)
quote:=post("/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/quote",map[string]any{"input":input},"")["quote"].(map[string]any)
job:=post("/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/requests",map[string]any{"input":input,"quoted_credits":quote["credits_consumed"]},nonce)
fmt.Println(job) // Stream events_url with the same Authorization header.
}// Java 11+, Jackson databind dependency; class Main in Main.java.
import java.net.URI;
import java.net.http.*;
import java.nio.file.*;
import java.time.Duration;
import java.util.UUID;
import com.fasterxml.jackson.databind.*;
import com.fasterxml.jackson.databind.node.ObjectNode;
public class Main {
static final ObjectMapper json = new ObjectMapper();
static final HttpClient client = HttpClient.newHttpClient();
static final String base = System.getenv("WEBOT_BASE_URL").replaceAll("/$", "");
static JsonNode post(String path, JsonNode body, String nonce) throws Exception {
var b = HttpRequest.newBuilder(URI.create(base+path)).timeout(Duration.ofSeconds(180))
.header("Authorization","Bearer "+System.getenv("WEBOT_API_KEY")).header("Content-Type","application/json")
.POST(HttpRequest.BodyPublishers.ofString(json.writeValueAsString(body)));
if(nonce!=null)b.header("Idempotency-Key",nonce);
var r=client.send(b.build(),HttpResponse.BodyHandlers.ofString());
if(r.statusCode()<200||r.statusCode()>=300)throw new IllegalStateException(r.body());
return json.readTree(r.body());
}
public static void main(String[] args) throws Exception {
var input=json.readTree(Files.readString(Path.of("input.json")));
ObjectNode body=json.createObjectNode();body.set("input",input);
var quote=post("/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/quote",body,null).get("quote");
body.put("quoted_credits",quote.get("credits_consumed").asInt());
String nonce=System.getenv("WEBOT_JOB_NONCE");if(nonce==null)nonce=UUID.randomUUID().toString(); // Persist before POST.
var job=post("/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/requests",body,nonce);System.out.println(job);
// Subscribe to job.events_url with Authorization; use BodyHandlers.ofLines().
}
}// .NET 8 console app, top-level statements.
using System.Net.Http;
using System.Text;
using System.Text.Json.Nodes;
var client = new HttpClient { Timeout = TimeSpan.FromSeconds(180) };
var root = Environment.GetEnvironmentVariable("WEBOT_BASE_URL")!.TrimEnd('/');
var key = Environment.GetEnvironmentVariable("WEBOT_API_KEY");
async Task<JsonNode> Post(string path, JsonNode body, string? nonce = null) {
using var req = new HttpRequestMessage(HttpMethod.Post, root + path);
req.Headers.Add("Authorization", "Bearer " + key);
if (nonce != null) req.Headers.Add("Idempotency-Key", nonce);
req.Content = new StringContent(body.ToJsonString(), Encoding.UTF8, "application/json");
using var res = await client.SendAsync(req);
var raw = await res.Content.ReadAsStringAsync();res.EnsureSuccessStatusCode();
return JsonNode.Parse(raw)!;
}
var input = JsonNode.Parse(await File.ReadAllTextAsync("input.json"));
var body = new JsonObject { ["input"] = input };
var quote = await Post("/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/quote", body);
body["quoted_credits"] = quote["quote"]!["credits_consumed"]!.GetValue<int>();
var nonce = Environment.GetEnvironmentVariable("WEBOT_JOB_NONCE") ?? Guid.NewGuid().ToString(); // Persist before submitting.
var job = await Post("/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/requests", body, nonce);
Console.WriteLine(job); // Subscribe to events_url with the same Bearer header and ResponseHeadersRead.# Ruby 3+, standard library only.
require 'net/http'
require 'json'
require 'securerandom'
base = ENV.fetch('WEBOT_BASE_URL').sub(%r{/$}, '')
post = lambda do |path, body, nonce = nil|
uri = URI(base + path)
req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer ' + ENV.fetch('WEBOT_API_KEY')
req['Content-Type'] = 'application/json'
req['Idempotency-Key'] = nonce if nonce
req.body = JSON.generate(body)
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true, read_timeout: 180) { |http| http.request(req) }
raise res.body unless res.is_a?(Net::HTTPSuccess)
JSON.parse(res.body)
end
input = JSON.parse(File.read('input.json'))
quote = post.call('/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/quote', {'input' => input})['quote']
nonce = ENV['WEBOT_JOB_NONCE'] || SecureRandom.uuid # Persist this before submission.
job = post.call('/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/requests', {'input' => input, 'quoted_credits' => quote['credits_consumed']}, nonce)
puts JSON.pretty_generate(job) # Subscribe to events_url with the same Authorization header.// Swift 5.9 server-side/CLI only. Do not embed customer keys in shipped apps.
import Foundation
#if canImport(FoundationNetworking)
import FoundationNetworking
#endif
@main struct Main {
static func main() async throws {
let env=ProcessInfo.processInfo.environment
let base=env["WEBOT_BASE_URL"]!.trimmingCharacters(in: CharacterSet(charactersIn:"/"))
let input=try JSONSerialization.jsonObject(with: Data(contentsOf:URL(fileURLWithPath:"input.json")))
func post(_ path:String,_ body:[String:Any],_ nonce:String?=nil) async throws -> [String:Any] {
var req=URLRequest(url:URL(string:base+path)!);req.httpMethod="POST";req.timeoutInterval=180
req.setValue("Bearer "+env["WEBOT_API_KEY"]!,forHTTPHeaderField:"Authorization")
req.setValue("application/json",forHTTPHeaderField:"Content-Type")
if let nonce {req.setValue(nonce,forHTTPHeaderField:"Idempotency-Key")}
req.httpBody=try JSONSerialization.data(withJSONObject:body)
let (data,res)=try await URLSession.shared.data(for:req)
guard let http=res as? HTTPURLResponse,(200..<300).contains(http.statusCode) else {throw NSError(domain:"WEBOT",code:1)}
return try JSONSerialization.jsonObject(with:data) as! [String:Any]
}
let quote=try await post("/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/quote",["input":input])["quote"] as! [String:Any]
let nonce=env["WEBOT_JOB_NONCE"] ?? UUID().uuidString // Persist before submission.
let job=try await post("/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/requests",["input":input,"quoted_credits":quote["credits_consumed"]!],nonce)
print(job) // Subscribe to events_url with the same Authorization header.
}
}// Server-side Kotlin/JVM 17+, Gradle dependencies: OkHttp 4.12, org.json 20240303.
import okhttp3.*
import okhttp3.MediaType.Companion.toMediaType
import okhttp3.RequestBody.Companion.toRequestBody
import org.json.JSONObject
import java.io.File
import java.util.UUID
import java.util.concurrent.TimeUnit
fun main() {
val base=System.getenv("WEBOT_BASE_URL").trimEnd('/')
val client=OkHttpClient.Builder().readTimeout(180,TimeUnit.SECONDS).build()
fun post(path:String,body:JSONObject,nonce:String?=null):JSONObject {
val b=Request.Builder().url(base+path).header("Authorization","Bearer "+System.getenv("WEBOT_API_KEY"))
.post(body.toString().toRequestBody("application/json".toMediaType()))
if(nonce!=null)b.header("Idempotency-Key",nonce)
return client.newCall(b.build()).execute().use {res ->
val raw=res.body!!.string();check(res.isSuccessful){raw};JSONObject(raw)
}
}
val body=JSONObject().put("input",JSONObject(File("input.json").readText()))
val quote=post("/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/quote",body).getJSONObject("quote")
body.put("quoted_credits",quote.getInt("credits_consumed"))
val nonce=System.getenv("WEBOT_JOB_NONCE") ?: UUID.randomUUID().toString() // Persist before submission.
val job=post("/api/v1/models/ltx_2_3_quality_reference_video_to_video_lora/requests",body,nonce)
println(job) // Subscribe to events_url with the same Authorization header.
}5. Receive all results
The response includes a stable WEBOT request_id, events_url and result_url. Subscribe with a Bearer-authenticated HTTP stream. Nonterminal streams end after 25 seconds; reconnect to the same URL after at least 1.5 seconds. Current saved state is replayed immediately, including completion that happened while disconnected. A terminal event contains the result envelope. The JSON terminal flag describes generation completion. Keep reconnecting while financial_pending is true; stop after the terminal event confirms financial settlement. Never poll provider status/results. Native browser EventSource cannot send a Bearer header; keep the key on your server.
Completed output contains the full model result, including every generated media/document item, not just the first URL. Failed output is null with error and refund_state. Results are strictly limited to the key owner, including on reseller domains. Model-independent aliases: /api/v1/requests/{request_id}/result and /events. Revoking a key blocks subsequent reads and streams; saved results remain accessible with another valid key of the same account.
6. Schemas and parameter defaults
Required fields are marked with *. Required text must contain non-whitespace content. Defaults apply when an optional parameter is omitted; null, false, 0 and an empty array are distinct values. “No documented default” means WEBOT does not invent one. Examples are sample inputs, not defaults. WEBOT generation constraints can require an explicit value even when the provider publishes an automatic default.
Input schema · fields, constraints and defaults
| Parameter | Type | Required | Default when omitted | Description / constraints |
|---|---|---|---|---|
num_inference_steps | integer | No | 15 | Number of inference steps. Defaults to 15 and can be increased up to 30. minimum: 8 · maximum: 30 |
image_url | string | null | No | No documented default | Optional reference image for style/character anchoring. This is the FIRST-frame keyframe. |
video_quality | string | No | "high" | The quality preset of the generated video. enum: ["low","medium","high","maximum"] |
seed | integer | null | No | No documented default | Random seed for reproducibility. If None, a random seed is chosen. |
guidance_scale | number | No | 1 | Classifier-free guidance scale. The default is tuned for fast, high-quality generation. minimum: 1 · maximum: 20 |
enable_safety_checker | boolean | No | true | Whether to enable the safety checker. |
video_strength | number | No | 0.6 | Video conditioning strength. Lower values give the model more freedom to change the reference video motion/structure. minimum: 0 · maximum: 1 |
preserve_original_video | boolean | No | false | True video-to-video: the base video_url is used as the generation's starting point, while control_video_url still drives the structure. The amount of the original preserved is controlled by `strength` (denoise): lower `strength` keeps more of the original video's pixels. Requires skip_control_preprocess, video_url and control_video_url. Default off leaves the standard control path unchanged. |
enable_prompt_expansion | boolean | No | true | Whether to enable prompt expansion. |
mid_image_url | string | null | No | No documented default | Optional middle-frame keyframe image. When set, the look/appearance is anchored to this image around the middle of the clip (in addition to image_url at the start), so the appearance follows a moving camera instead of drifting. Requires image_url. |
end_image_url | string | null | No | No documented default | Optional last-frame keyframe image. When set, the look/appearance is anchored to this image at the end of the clip. Useful for shots where the camera travels to a different place than the start image. Requires image_url. |
control_video_url | string | null | Yes * | No documented default | Optional pre-computed control video (e.g. an already-rendered depth / edge / pose composite). When provided together with skip_control_preprocess, the built-in control estimation is skipped and this video is used directly as the control signal, resampled to the output resolution and frame count. |
video_write_mode | string | No | "balanced" | The write mode of the generated video. enum: ["fast","balanced","small"] |
frames_per_second | number | No | 24 | Frames per second of the generated video. minimum: 1 · maximum: 60 |
strength | number | No | 1 | Sampler denoise strength for reference-video-to-video. With preserve_original_video on, this is the video-to-video amount: lower values keep more of the original video's pixels (e.g. 0.5 = keep ~50%), 1.0 fully regenerates. Without preserve_original_video it only trims the denoise schedule. minimum: 0 · maximum: 1 |
loras | array | Yes * | No documented default | Up to 3 LoRAs to apply on top of LTX-2.3. Each path is downloaded through the registry SSRF-safe downloader before it is loaded. Max size: 3 GB per LoRA. maxItems: 3 |
loras[].path | string | Yes * | No documented default | Direct HTTP(S) download URL of the LoRA file (.safetensors). The file is downloaded through an SSRF-safe downloader before it is loaded. Max size: 3 GB. maxLength: 2048 |
loras[].scale | number | No | 1 | Strength of the LoRA application (0.0 to 2.0). Higher values = stronger effect on the generated video. minimum: 0 · maximum: 2 |
loras[].transformer | string | No | "both" | Forward-compatibility flag for multi-transformer architectures. LTX-2.3 has a single transformer, so 'both' is the right choice for almost all users. enum: ["high","low","both"] |
generate_audio | boolean | No | true | Whether to include audio in the returned video. When disabled, the final MP4 is returned without an audio track. |
video_url | string | Yes * | No documented default | The URL of the reference video that supplies motion/structure. |
sync_mode | boolean | No | false | If True, the media is returned as a data URI inline in the response. Useful for short-lived requests and tests. |
num_frames | integer | No | 121 | The number of output frames to generate. This IC-LoRA endpoint caps the resolution x frames volume for stability (~150 frames at 720p-class; more at smaller sizes). A request above the budget returns a 422 — reduce num_frames or use a smaller resolution. minimum: 9 · maximum: 481 |
skip_control_preprocess | boolean | No | true | Skip the built-in control estimation (depth / edge / pose) and use control_video_url directly as the control signal. Requires control_video_url; ignored if it is not set. With resolution='auto', the output follows the source video size/aspect up to the LTX limits. Explicit resolutions are honored and 64-aligned so the RGB video and control video stay matched. const: true |
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" | The negative prompt to steer generation away from. |
resolution | object | string | No | "auto" | The size of the generated video. In direct-control mode (skip_control_preprocess with control_video_url), 'auto' follows the source video size/aspect up to the LTX limits and explicit sizes are honored with 64px alignment. In the built-in control estimation mode, the output stays near the official control workflow size. Higher resolutions reduce the maximum stable frame count; lower resolutions can run longer. |
resolution.variant0.width | integer | No | 512 | The width of the generated image. maximum: 14142 · exclusiveMinimum: 0 |
resolution.variant0.height | integer | No | 512 | The height of the generated image. maximum: 14142 · exclusiveMinimum: 0 |
prompt | string | Yes * | No documented default | The prompt to guide generation. |
{
"title": "LTX23QualityLoRAReferenceVideoToVideoInput",
"type": "object",
"properties": {
"num_inference_steps": {
"title": "Number of Inference Steps",
"minimum": 8,
"type": "integer",
"description": "Number of inference steps. Defaults to 15 and can be increased up to 30.",
"maximum": 30,
"default": 15
},
"image_url": {
"title": "Reference Image URL",
"description": "Optional reference image for style/character anchoring. This is the FIRST-frame keyframe.",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"video_quality": {
"title": "Video Quality",
"enum": [
"low",
"medium",
"high",
"maximum"
],
"type": "string",
"description": "The quality preset of the generated video.",
"default": "high"
},
"seed": {
"title": "Seed",
"description": "Random seed for reproducibility. If None, a random seed is chosen.",
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"guidance_scale": {
"title": "Guidance Scale",
"minimum": 1,
"type": "number",
"description": "Classifier-free guidance scale. The default is tuned for fast, high-quality generation.",
"maximum": 20,
"default": 1
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"type": "boolean",
"description": "Whether to enable the safety checker.",
"default": true
},
"video_strength": {
"title": "Video Strength",
"minimum": 0,
"type": "number",
"description": "Video conditioning strength. Lower values give the model more freedom to change the reference video motion/structure.",
"maximum": 1,
"default": 0.6
},
"preserve_original_video": {
"title": "Preserve Original Video",
"type": "boolean",
"description": "True video-to-video: the base video_url is used as the generation's starting point, while control_video_url still drives the structure. The amount of the original preserved is controlled by `strength` (denoise): lower `strength` keeps more of the original video's pixels. Requires skip_control_preprocess, video_url and control_video_url. Default off leaves the standard control path unchanged.",
"default": false
},
"enable_prompt_expansion": {
"title": "Enable Prompt Expansion",
"type": "boolean",
"description": "Whether to enable prompt expansion.",
"default": true
},
"mid_image_url": {
"title": "Middle Image URL",
"description": "Optional middle-frame keyframe image. When set, the look/appearance is anchored to this image around the middle of the clip (in addition to image_url at the start), so the appearance follows a moving camera instead of drifting. Requires image_url.",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"end_image_url": {
"title": "End Image URL",
"description": "Optional last-frame keyframe image. When set, the look/appearance is anchored to this image at the end of the clip. Useful for shots where the camera travels to a different place than the start image. Requires image_url.",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"control_video_url": {
"title": "Control Video URL",
"description": "Optional pre-computed control video (e.g. an already-rendered depth / edge / pose composite). When provided together with skip_control_preprocess, the built-in control estimation is skipped and this video is used directly as the control signal, resampled to the output resolution and frame count.",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"video_write_mode": {
"title": "Video Write Mode",
"enum": [
"fast",
"balanced",
"small"
],
"type": "string",
"description": "The write mode of the generated video.",
"default": "balanced"
},
"frames_per_second": {
"title": "FPS",
"minimum": 1,
"type": "number",
"description": "Frames per second of the generated video.",
"maximum": 60,
"default": 24
},
"strength": {
"title": "Strength",
"minimum": 0,
"type": "number",
"description": "Sampler denoise strength for reference-video-to-video. With preserve_original_video on, this is the video-to-video amount: lower values keep more of the original video's pixels (e.g. 0.5 = keep ~50%), 1.0 fully regenerates. Without preserve_original_video it only trims the denoise schedule.",
"maximum": 1,
"default": 1
},
"loras": {
"title": "LoRAs",
"type": "array",
"items": {
"title": "LoRAInput",
"type": "object",
"properties": {
"path": {
"title": "Path",
"type": "string",
"examples": [
"https://example.com/path/to/lora.safetensors"
],
"description": "Direct HTTP(S) download URL of the LoRA file (.safetensors). The file is downloaded through an SSRF-safe downloader before it is loaded. Max size: 3 GB.",
"maxLength": 2048
},
"scale": {
"title": "Scale",
"minimum": 0,
"type": "number",
"description": "Strength of the LoRA application (0.0 to 2.0). Higher values = stronger effect on the generated video.",
"maximum": 2,
"default": 1
},
"transformer": {
"title": "Transformer",
"enum": [
"high",
"low",
"both"
],
"type": "string",
"description": "Forward-compatibility flag for multi-transformer architectures. LTX-2.3 has a single transformer, so 'both' is the right choice for almost all users.",
"default": "both"
}
},
"x-webot-order-properties": [
"path",
"scale",
"transformer"
],
"description": "A single LoRA to apply on top of the LTX-2.3 base model.\n\nLoaded at request time through the registry SSRF-safe downloader.",
"required": [
"path"
]
},
"maxItems": 3,
"description": "Up to 3 LoRAs to apply on top of LTX-2.3. Each path is downloaded through the registry SSRF-safe downloader before it is loaded. Max size: 3 GB per LoRA."
},
"generate_audio": {
"title": "Generate Audio",
"type": "boolean",
"description": "Whether to include audio in the returned video. When disabled, the final MP4 is returned without an audio track.",
"default": true
},
"video_url": {
"title": "Video URL",
"type": "string",
"description": "The URL of the reference video that supplies motion/structure."
},
"sync_mode": {
"title": "Sync Mode",
"type": "boolean",
"description": "If True, the media is returned as a data URI inline in the response. Useful for short-lived requests and tests.",
"default": false
},
"num_frames": {
"minimum": 9,
"type": "integer",
"title": "Number of Frames",
"description": "The number of output frames to generate. This IC-LoRA endpoint caps the resolution x frames volume for stability (~150 frames at 720p-class; more at smaller sizes). A request above the budget returns a 422 \u2014 reduce num_frames or use a smaller resolution.",
"maximum": 481,
"default": 121
},
"skip_control_preprocess": {
"title": "Skip Control Preprocess",
"type": "boolean",
"description": "Skip the built-in control estimation (depth / edge / pose) and use control_video_url directly as the control signal. Requires control_video_url; ignored if it is not set. With resolution='auto', the output follows the source video size/aspect up to the LTX limits. Explicit resolutions are honored and 64-aligned so the RGB video and control video stay matched.",
"default": true,
"const": true
},
"negative_prompt": {
"title": "Negative Prompt",
"type": "string",
"description": "The negative prompt to steer generation away from.",
"default": "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"
},
"resolution": {
"title": "Resolution",
"default": "auto",
"description": "The size of the generated video. In direct-control mode (skip_control_preprocess with control_video_url), 'auto' follows the source video size/aspect up to the LTX limits and explicit sizes are honored with 64px alignment. In the built-in control estimation mode, the output stays near the official control workflow size. Higher resolutions reduce the maximum stable frame count; lower resolutions can run longer.",
"anyOf": [
{
"title": "ImageSize",
"type": "object",
"properties": {
"width": {
"title": "Width",
"exclusiveMinimum": 0,
"type": "integer",
"description": "The width of the generated image.",
"maximum": 14142,
"default": 512
},
"height": {
"title": "Height",
"exclusiveMinimum": 0,
"type": "integer",
"description": "The height of the generated image.",
"maximum": 14142,
"default": 512
}
},
"x-webot-order-properties": [
"width",
"height"
]
},
{
"enum": [
"auto",
"square_hd",
"square",
"portrait_4_3",
"portrait_16_9",
"landscape_4_3",
"landscape_16_9"
],
"type": "string"
}
]
},
"prompt": {
"title": "Prompt",
"type": "string",
"examples": [
"A dancer in a flowing red dress against a black backdrop, studio lighting, cinematic."
],
"description": "The prompt to guide generation."
}
},
"x-webot-order-properties": [
"prompt",
"video_url",
"control_video_url",
"skip_control_preprocess",
"preserve_original_video",
"image_url",
"mid_image_url",
"end_image_url",
"video_strength",
"strength",
"num_frames",
"resolution",
"frames_per_second",
"num_inference_steps",
"guidance_scale",
"generate_audio",
"negative_prompt",
"seed",
"enable_prompt_expansion",
"enable_safety_checker",
"video_quality",
"video_write_mode",
"sync_mode",
"loras"
],
"required": [
"loras",
"prompt",
"video_url",
"control_video_url"
],
"allOf": [
{
"if": {
"required": [
"mid_image_url"
],
"properties": {
"mid_image_url": {
"type": "string",
"minLength": 1
}
}
},
"then": {
"required": [
"image_url"
],
"properties": {
"image_url": {
"type": "string",
"minLength": 1
}
}
},
"x-webot-message": "Middle Image URL requires Reference Image URL."
},
{
"if": {
"required": [
"preserve_original_video"
],
"properties": {
"preserve_original_video": {
"type": "boolean",
"const": true
}
}
},
"then": {
"required": [
"skip_control_preprocess"
],
"properties": {
"skip_control_preprocess": {
"const": true
}
}
},
"x-webot-message": "Preserve Original Video requires Skip Control Preprocess enabled."
},
{
"if": {
"required": [
"end_image_url"
],
"properties": {
"end_image_url": {
"type": "string",
"minLength": 1
}
}
},
"then": {
"required": [
"image_url"
],
"properties": {
"image_url": {
"type": "string",
"minLength": 1
}
}
},
"x-webot-message": "End Image URL requires Reference Image URL."
}
]
}Output (inside result.output) schema · fields, constraints and defaults
| Parameter | Type | Required | Default when omitted | Description / constraints |
|---|---|---|---|---|
seed | integer | Yes * | No documented default | The seed actually used for generation. |
prompt | string | Yes * | No documented default | The prompt used for generation (after any expansion). |
video | object | Yes * | No documented default | The generated video. |
video.url | string | Yes * | No documented default | The URL where the file can be downloaded from. |
video.content_type | string | null | No | No documented default | The mime type of the file. |
video.file_size | integer | null | No | No documented default | The size of the file in bytes. |
video.file_name | string | null | No | No documented default | The name of the file. It will be auto-generated if not provided. |
{
"title": "LTX23QualityOutput",
"type": "object",
"properties": {
"seed": {
"title": "Seed",
"type": "integer",
"description": "The seed actually used for generation."
},
"prompt": {
"title": "Prompt",
"type": "string",
"description": "The prompt used for generation (after any expansion)."
},
"video": {
"title": "File",
"type": "object",
"properties": {
"url": {
"title": "Url",
"type": "string",
"description": "The URL where the file can be downloaded from."
},
"content_type": {
"title": "Content Type",
"examples": [
"image/png"
],
"description": "The mime type of the file.",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"file_size": {
"title": "File Size",
"examples": [
4404019
],
"description": "The size of the file in bytes.",
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"file_name": {
"title": "File Name",
"examples": [
"z9RV14K95DvU.png"
],
"description": "The name of the file. It will be auto-generated if not provided.",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"x-webot-order-properties": [
"url",
"content_type",
"file_name",
"file_size"
],
"required": [
"url"
],
"description": "The generated video."
}
},
"x-webot-order-properties": [
"video",
"seed",
"prompt"
],
"description": "Standard output for every endpoint on this app.",
"required": [
"video",
"seed",
"prompt"
]
}Errors and limits
401 invalid/expired/revoked key · 403 key scope or domain mismatch · 404 unavailable model or unowned request · 409 quote changed, balance, concurrency or idempotency conflict · 413 JSON exceeds 2 MB · 415 wrong content type · 422 invalid fields/media · 429 rate limit · 503 temporary/ambiguous submission. Respect Retry-After. Current limits per account: 12 quotes/submissions, 120 result reads and 8 stream connections per minute. One submission preparation at a time per account. Do not automatically regenerate failed jobs.
Your requests
LTX 2.3 Quality - Video to Video with LoRA · Your account only
Select Requests to load your history.
| Request ID | Created at (IST) | Status | Credits used | Refunded | Processing time | Report |
|---|
Your model analytics
LTX 2.3 Quality - Video to Video with LoRA · Request dates in IST
Select Analytics to load your metrics.
Request counts
Daily requests by their current status
Request outcomes
Completed, failed and pending requests
Credits used
Daily recorded charges before refunds
Processing time
Daily average for completed requests with recorded timing
Processing percentiles
Completed requests only · Time from submission to recorded completion
How to use LTX 2.3 Quality — Video to Video with LoRA
Start with an existing video and use this model’s editing or transformation tools to change it. The exact kind of change depends on this particular endpoint.
Required inputs
- LoRAs: A compatible learned adapter that changes a model’s style, subject or behaviour. It is an add-on to a base model, not a normal reference photo. Use adapters made for the supported base model.
- Prompt: Your instructions to the model. Say what you want, include the important details and avoid contradictory directions. For a video, describe the action as well as the scene.
- Video URL: The source video or videos. The model needs an accessible file in a supported format. Check length, resolution and audio requirements in the form before submitting.
- Control Video URL: The source video or videos. The model needs an accessible file in a supported format. Check length, resolution and audio requirements in the form before submitting.
Workflow
- Prepare your source material and fill the required inputs above. Review the supported settings for this model.
- Sign in to calculate the credit estimate. Review the estimate before choosing Generate.
- Keep this model page open while the request runs. Completed results arrive in the result area; use the available player or download controls to review the output.
When to use this workflow
- Apply the transformation described for this model.
- Use an existing clip as the starting material.
Key settings
- LoRAs
- A compatible learned adapter that changes a model’s style, subject or behaviour. It is an add-on to a base model, not a normal reference photo. Use adapters made for the supported base model. Maximum items: 3
- Path
- A compatible saved model or learned adapter file. This is not an ordinary picture. Use the exact format and base-model compatibility required by this tool. Maximum characters: 2048
- Scale
- A scale or enlargement amount. For an image enlargement factor, 2× doubles both width and height, producing four times as many pixels. Other uses of “scale” can differ; check this model’s description. Minimum: 0. Maximum: 2
- Transformer
- Select the internal model component used by a supported architecture. This is an advanced compatibility option; choose the documented default rather than treating it as a style setting. Supported choices: "high", "low", "both"
- Prompt
- Your instructions to the model. Say what you want, include the important details and avoid contradictory directions. For a video, describe the action as well as the scene.
- Video URL
- The source video or videos. The model needs an accessible file in a supported format. Check length, resolution and audio requirements in the form before submitting.