Op den Inhalt sprangen

Ltx 2.3 Quality · Reference Video to Video

Integréieren

Modell-ID ltx-2.3-quality/reference-video-to-video
# 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": "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"

Dateie wéi am Beispill: 0,27 $ 270 API-Kreditter · ≈ 29,05 ₽ Är Dateie gi virun der Ausféierung gemooss Op dëser Säit ausféieren

API-Schlëssel kréien
Lightricks · Video

Äin éischt Resultat kënnt hei hin

Baut hei drënner eng Ufro a féiert se mat Ärem API-Schlëssel aus. Output gëtt an eis Späicherung kopéiert, fir ëmmer oder 7 Deeg gratis gespäichert.

Eng Ufro erstellen

D'Kontrolle ginn aus dem Modellschema generéiert. De Code an de Präis aktualiséiere sech, wann s du se ännerst.

•obligatoresch

Prompt, deen d'Generatioun steiert.

•obligatoresch video_url
Fichier erofzéien, oder

URL op e Referenzvideo, deen d'Beweegung an d'Struktur steiert.

resolution Standard auto

Output-Video-Dimensiounen, déi och d'stabil Dauer beaflossen: méi kleng Gréissten erlaben méi Frames, wärend méi grouss d'Maximum reduzéieren. Déi integréiert Kontrollschätzung hält d'Gréisst no um offiziellen Kontroll-Workflow; direkt Kontroll iwwer `skip_control_preprocess` an `control_video_url` respektéiert amplaz explizit Dimensioune mat 64px-Ausrichtung. Am Direkt-Kontrollmodus iwwerhëlt `auto` d'Quell-Dimensiounen an d'Aspektverhältnis bannent den LTX-Limiten.

Standard 121

Zuel vun den Output-Frames, ënnerleien engem IC-LoRA-Stabilitéitsbudget op Basis vun Opléisung multiplizéiert mat Frames. Eng 422-Äntwert bedeit, datt dëse Budget iwwerschratt gouf: reduzéiert d'Opléisung oder `num_frames`. De Budget erlaabt ongeféier 150 Frames bei 720p-Klass-Dimensiounen a méi bei méi klengen Dimensiounen.

Erweidert negative_prompt · control_video_url · image · mid_image_url · end_image · video_quality · video_write_mode · video_strength · strength · frames_per_second · num_inference_steps · guidance_scale · seed · skip_control_preprocess · preserve_original_video · enable_prompt_expansion · enable_safety_checker
Standard color distortion, ove...

Negativen Prompt, deen ugëtt, wat d'Generatioun vermeide soll.

Fichier erofzéien, oder

Optional virbereete Kontrollvideo, dat amplaz vun der integréierter Kontrollschätzung benotzt gëtt, wann et zesumme mat `skip_control_preprocess` geliwwert gëtt. No der Neiskaléierung op d'Output-Dimensiounen an d'Framezuel gëtt et zum direkte Kontrollsignal. De Video kann zum Beispill eng scho gerenderte Kompositioun aus Déift, Kanten oder Pose enthalen.

image_url
Fichier erofzéien, oder

Optional Bildverankerungsstil oder Charakteridentitéit als Keyframe vum éischte Frame.

Fichier erofzéien, oder

Optional Bildverankerungsoptrieden no beim Mëttelpunkt vum Clips, als Ergänzung zum initialen `image_url`-Keyframe. Et hëlleft, datt d'Optriede der Kamerabeweegung follegt amplaz ofzedriften; erfuerdert `image_url`.

end_image_url
Fichier erofzéien, oder

Optional Bildverankerungsoptrieden um leschte Frame vum Clips. Nëtzlech, wann d'Kamerabeweegung op enger anerer Positioun wéi d'Startbild ophält; erfuerdert `image_url`.

video_quality Standard high

Qualitéitsvirstellung, déi op den Output-Video applizéiert gëtt.

video_write_mode Standard balanced

Schreifmodus vum resultéierende Video.

Standard 0.6

D'Fräiheet, d'Beweegung an d'Struktur vum Referenzvideo z'änneren, gëtt duerch dës Conditioning-Stäerkt gesteiert: méi kleng Astellunge erlaben méi grouss Ännerungen.

Standard 1

Denoising-Kontroll fir d'Referenzvideo-zu-Video-Sampling, där hiren Effekt vun `preserve_original_video` ofhänkt. Wann dëse Modus aus ass, verkierzt en nëmmen den Denoising-Zäitplang; wann en un ass, steiert en d'Transformatioun vun de Quellpixel, woubäi 1.0 alles nei generéiert a méi niddreg Astellunge méi erhalen (zum Beispill erhält 0.5 ongeféier 50%).

Standard 24

Output-Video-Frame-Rate, gemooss a Frames pro Sekonn.

Standard 15

Setzt d'Zuel vun den Inference-Schrëtt op bis zu 30; wann onverännert, ginn 15 benotzt.

Standard 1

Passt classifier-free guidance mat dëser Skala un; de Standard ass op héich Qualitéit a séier Generatioun ofgestëmmt.

Seed, deen d'Generatioun reproduzéierbar mécht. Wann et op None gesat gëtt, gëtt e Seed zoufälleg gewielt.

POST /run/ltx-2.3-quality/reference-video-to-video?wait=20 Präis → 0,27 $
# 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": "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"

Dës Ufro ausféieren

Äre Schlëssel bleift an dësem Browser: e gëtt nëmmen un d'Doitong API geschéckt an nëmme gespäichert (localStorage), wann s du „Erënneren“ aktivéiers. En API-Schlëssel kréien

Iwwer Ltx 2.3 Quality · Reference Video to Video

Erstellt en neie Video aus engem obligatoresche `prompt` an engem Referenz-`video_url`, deen d'Beweegung an d'Struktur liwwert. Optional `image_url`, `mid_image_url` an `end_image_url` fixéiere de Look um Ufank, an der Mëtt an um Enn. `video_strength` an `strength` (béid 0 to 1) steieren, wéi enk de Video der Quell follegt oder wéi vill se erhale bleift, an `control_video_url` kann e virberechent Kontrollsignal liwweren. `resolution` bitt automatesch oder fix Presets wéi quadratesch an 16:9 Portrait- oder Landschaftsformat.

Parameteren

Schéck entweder den kanoneschen Numm oder den natierlechen Numm, net béid. Kanonesch Nimm

NummTyp StandardErlaabt Beschreiwung
promptobligatoresch
Typstring
Prompt, deen d'Generatioun steiert.
video_urlobligatoresch video
Typurl · video
URL op e Referenzvideo, deen d'Beweegung an d'Struktur steiert.
control_video_urloptional
Typurl · video
Optional virbereete Kontrollvideo, dat amplaz vun der integréierter Kontrollschätzung benotzt gëtt, wann et zesumme mat `skip_control_preprocess` geliwwert gëtt. No der Neiskaléierung op d'Output-Dimensiounen an d'Framezuel gëtt et zum direkte Kontrollsignal. De Video kann zum Beispill eng scho gerenderte Kompositioun aus Déift, Kanten oder Pose enthalen.
skip_control_preprocessoptional
Typboolean
Standardfalse
Direkte Kontrollmodus mat `control_video_url` amplaz vun enger interner Schätzung vun Déift, Kanten oder Pose; ouni dës URL gëtt d'Astellung ignoréiert. D'Output-Gréisst an dësem Modus respektéiert explizit Dimensioune mat 64er-Ausrichtung, fir RGB- a Kontrollvideoen ofzestëmmen, wärend `auto` d'Quell-Dimensiounen an d'Aspektverhältnis bannent den LTX-Limite iwwerhëlt.
preserve_original_videooptional
Typboolean
Standardfalse
Modus fir d'Erhale vum Originalvideo, nëmme verfügbar mat `skip_control_preprocess`, `video_url` an `control_video_url`. Standardméisseg deaktivéiert, léisst en déi normal Kontrollveraarbechtung intakt; beim Aktivéiere fänkt d'Generatioun mat `video_url` un, wärend strukturell Guidance vu `control_video_url` erhale bleift. Denoising iwwer `strength` bestëmmt de preservéierte Montant, woubäi méi niddreg Astellunge méi originell Pixel behalen.
image_urloptional image
Typurl · image
Optional Bildverankerungsstil oder Charakteridentitéit als Keyframe vum éischte Frame.
mid_image_urloptional
Typurl · image
Optional Bildverankerungsoptrieden no beim Mëttelpunkt vum Clips, als Ergänzung zum initialen `image_url`-Keyframe. Et hëlleft, datt d'Optriede der Kamerabeweegung follegt amplaz ofzedriften; erfuerdert `image_url`.
end_image_urloptional end_image
Typurl · image
Optional Bildverankerungsoptrieden um leschte Frame vum Clips. Nëtzlech, wann d'Kamerabeweegung op enger anerer Positioun wéi d'Startbild ophält; erfuerdert `image_url`.
video_strengthoptional
Typnumber
Standard0.6
0 – 1
D'Fräiheet, d'Beweegung an d'Struktur vum Referenzvideo z'änneren, gëtt duerch dës Conditioning-Stäerkt gesteiert: méi kleng Astellunge erlaben méi grouss Ännerungen.
strengthoptional
Typnumber
Standard1
0 – 1
Denoising-Kontroll fir d'Referenzvideo-zu-Video-Sampling, där hiren Effekt vun `preserve_original_video` ofhänkt. Wann dëse Modus aus ass, verkierzt en nëmmen den Denoising-Zäitplang; wann en un ass, steiert en d'Transformatioun vun de Quellpixel, woubäi 1.0 alles nei generéiert a méi niddreg Astellunge méi erhalen (zum Beispill erhält 0.5 ongeféier 50%).
num_framesoptional
Typinteger
Standard121
9 – 481
Zuel vun den Output-Frames, ënnerleien engem IC-LoRA-Stabilitéitsbudget op Basis vun Opléisung multiplizéiert mat Frames. Eng 422-Äntwert bedeit, datt dëse Budget iwwerschratt gouf: reduzéiert d'Opléisung oder `num_frames`. De Budget erlaabt ongeféier 150 Frames bei 720p-Klass-Dimensiounen a méi bei méi klengen Dimensiounen.
resolutionoptional
Typobject
Standardauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Output-Video-Dimensiounen, déi och d'stabil Dauer beaflossen: méi kleng Gréissten erlaben méi Frames, wärend méi grouss d'Maximum reduzéieren. Déi integréiert Kontrollschätzung hält d'Gréisst no um offiziellen Kontroll-Workflow; direkt Kontroll iwwer `skip_control_preprocess` an `control_video_url` respektéiert amplaz explizit Dimensioune mat 64px-Ausrichtung. Am Direkt-Kontrollmodus iwwerhëlt `auto` d'Quell-Dimensiounen an d'Aspektverhältnis bannent den LTX-Limiten.
frames_per_secondoptional
Typnumber
Standard24
1 – 60
Output-Video-Frame-Rate, gemooss a Frames pro Sekonn.
num_inference_stepsoptional
Typinteger
Standard15
8 – 30
Setzt d'Zuel vun den Inference-Schrëtt op bis zu 30; wann onverännert, ginn 15 benotzt.
guidance_scaleoptional
Typnumber
Standard1
1 – 20
Passt classifier-free guidance mat dëser Skala un; de Standard ass op héich Qualitéit a séier Generatioun ofgestëmmt.
generate_audiooptional
Typboolean
Standardtrue
Audio-Spur-Toggle fir den zeréckginnene MP4: ausgeschalt produzéiert eng Video-nëmmen-Datei, ageschalt enthält Audio.
negative_promptoptional
Typstring
Standardcolor 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
Negativen Prompt, deen ugëtt, wat d'Generatioun vermeide soll.
seedoptional
Typinteger | null
Seed, deen d'Generatioun reproduzéierbar mécht. Wann et op None gesat gëtt, gëtt e Seed zoufälleg gewielt.
enable_prompt_expansionoptional
Typboolean
Standardtrue
Steiert, ob d'Prompt-Erweiderung aktivéiert ass.
enable_safety_checkeroptional
Typboolean
Standardtrue
Steiert, ob d'Sécherheetskontroll aktivéiert ass.
video_qualityoptional
Typenum
Standardhigh
lowmediumhighmaximum
Qualitéitsvirstellung, déi op den Output-Video applizéiert gëtt.
video_write_modeoptional
Typenum
Standardbalanced
fastbalancedsmall
Schreifmodus vum resultéierende Video.
obligatoresch Kanoneschen Numm, och akzeptéiert

Fichierparameter akzeptéieren eng ëffentlech https:// URL, eng data: URI bis zu 10 MB oder de file_url vun engem Upload. Fichieren

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "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"
  }
}
Är Fichieren, Är WielAll outputs[].url ass eng Kopie an eiser Späicherung: fir ëmmer gespäichert (bezuelbar pro GB-Mount) oder 7 Deeg gratis, jee no Ärer Kontastellung oder ?storage=.
D'selwecht Struktur bei all Modelltype, url, content_type, width, height an duration, fir Biller, Video an Audio gläichermoossen. output ass dem Modell säin eegent Resultatobjet.
Output-Felder
video
object {url, content_type, file_name, file_size}Video, dee vum Modell produzéiert gëtt.
seed
integerTatsächlech Seed, deen wärend der Generatioun applizéiert gëtt.
prompt
stringGeneratiouns-Prompt, inklusiv all Erweiderung, déi virun der Benotzung applizéiert gouf.

Méi Modeller: Video zu Video

Fir AI-Agenten: dës Säit als Markdown ass ënner https://doitong.com/lb/developers/models/ltx-2.3-quality/reference-video-to-video.md. All Modeller a Guiden: https://doitong.com/developers/llms.txt