Ugrás a tartalomhoz

Ltx 2.3 Quality · Reference Video to Video · LoRA

Integráció

Modellazonosító ltx-2.3-quality/reference-video-to-video/lora
# 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 '{
    "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",
    "loras": [
      {
        "path": "https://example.com/your-file.safetensors"
      }
    ]
  }'

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

A példához hasonló fájlok: 0,304 $ 304 API-jóváírás · ≈ 32,40 ₽ a fájljaidat a futtatás előtt megmérjük Futtatás ezen az oldalon

API-kulcs beszerzése
Lightricks · Videó

Az első eredményed itt jelenik meg

Állíts össze egy kérést alább, majd futtasd az API-kulcsoddal. A kimeneteket a tárhelyünkre másoljuk, és örökre vagy 7 nap ideig ingyenesen őrizzük meg.

Kérés összeállítása

A vezérlők a modell sémájából jönnek létre. A kód és az ár a módosításokkal együtt frissül.

•kötelező

A generálást irányító prompt.

•kötelező video_url
Húzz egy fájlt ide, vagy

A mozgás és a struktúra vezérléséhez használt referencia-videóra mutató URL.

resolution alapértelmezett: auto

A kimeneti videó méretei, amelyek a stabil időtartamra is hatással vannak: a kisebb méretek több képkockát engednek, a nagyobbak pedig csökkentik a maximumot. A beépített vezérlőbecslés a méretet a hivatalos vezérlési munkafolyamathoz közel tartja; a `skip_control_preprocess` és a `control_video_url` használatával végzett közvetlen vezérlés ehelyett a megadott méreteket 64px-es igazítással követi. Közvetlen vezérlési módban az `auto` a forrás méretét és képarányát örökli az LTX korlátain belül.

alapértelmezett: 121

A kimenet képkockaszáma, amelyet a felbontás és a képkockák szorzatán alapuló IC-LoRA-stabilitási keret korlátoz. A 422-es válasz azt jelenti, hogy a keret túllépésre került: csökkentsd a felbontást vagy a `num_frames` értékét. A keret körülbelül 150 képkockát engedélyez 720p-osztályú méreteknél, kisebb méreteknél pedig többet.

•kötelező

LTX-2.3-hoz tartozó LoRA-kiegészítések, egyenként legfeljebb 3 GB mérettel és legfeljebb 3 megengedett elemmel. A betöltés csak azután történik, hogy a regisztráció SSRF-biztos letöltője lekérte az egyes elérési utakat.

Speciális 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
alapértelmezett: color distortion, ove...

A generálás során kerülendő tartalmat meghatározó negatív prompt.

Húzz egy fájlt ide, vagy

Opcionális, előre kiszámított vezérlővideó, amely a beépített vezérlőbecslés helyett használatos, ha a `skip_control_preprocess` beállítással együtt van megadva. Az újramintavételezés után, a kimeneti méretekhez és a képkockaszámhoz igazítva, közvetlen vezérlőjellé válik. A videó például már renderelt mélység-, él- vagy pózkompozitot is tartalmazhat.

image_url
Húzz egy fájlt ide, vagy

Opcionális képanker-stílus vagy karakterazonosság az első képkocka kulcsképeként.

Húzz egy fájlt ide, vagy

Opcionális képanker-megjelenés a klip közepe táján, amely kiegészíti a kezdeti `image_url` kulcsképet. Segít, hogy a megjelenés kövesse a kamera mozgását, és ne sodródjon el; `image_url` szükséges hozzá.

end_image_url
Húzz egy fájlt ide, vagy

Opcionális képanker-megjelenés a klip utolsó képkockáján. Akkor hasznos, ha a kameramozgás a kezdőképtől eltérő helyen ér véget; `image_url` szükséges hozzá.

video_quality alapértelmezett: high

A kimeneti videóra alkalmazott minőségi előbeállítás.

video_write_mode alapértelmezett: balanced

A létrejövő videó írási módja.

alapértelmezett: 0.6

A referencia-videó mozgásának és struktúrájának módosítási szabadságát ez a kondicionálási erősség vezérli: az alacsonyabb értékek nagyobb változtatást engednek.

alapértelmezett: 1

A referencia-videóból videóba mintavételezés zajtalanítási vezérlése, amelynek hatása a `preserve_original_video` beállítástól függ. Kikapcsolt módban csak lerövidíti a zajtalanítási ütemezést; bekapcsolva a forráspixelek átalakítását vezérli: az 1.0 mindent újragenerál, az alacsonyabb értékek pedig többet őriznek meg (például a 0.5 körülbelül 50%-ot).

alapértelmezett: 24

A kimeneti videó képkockasebessége, képkocka/másodpercben mérve.

alapértelmezett: 15

A futtatandó következtetési lépések száma, legfeljebb 30; változatlanul hagyva 15 lépést használ.

alapértelmezett: 1

A classifier-free guidance beállítása ezzel a skálával; alapértelmezett hangolása a jó minőséget és a gyors generálást egyaránt célozza.

A generálást reprodukálhatóvá tevő seed. A None érték véletlenszerű seedet választ.

POST /run/ltx-2.3-quality/reference-video-to-video/lora?wait=20 ár → 0,304 $
# 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 '{
    "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",
    "loras": [
      {
        "path": "https://example.com/your-file.safetensors"
      }
    ]
  }'

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

Kérés futtatása

A kulcsod ebben a böngészőben marad: csak a Doitong API-nak küldjük el, és csak akkor mentjük a localStorage-ba, ha bejelölöd az Emlékezz rám lehetőséget. API-kulcs igénylése

A(z) Ltx 2.3 Quality · Reference Video to Video · LoRA bemutatása

Videót generál a kötelező `prompt` és a mozgást, illetve szerkezetet biztosító referencia-`video_url` alapján, továbbá legfeljebb 3, egyenként legfeljebb 3 GB-os LoRA-fájlt igénylő `loras` értéket fogad. Az opcionális első, középső és utolsó kulcskép (`image_url`, `mid_image_url`, `end_image_url`) rögzíti a megjelenést. A `video_strength` és a `strength` értéke 0 to 1, a `num_frames` értéke pedig 9 to 481 között mozog.

Paraméterek

Küldd el a kanonikus nevet vagy a natív nevet, de ne mindkettőt. Kanonikus nevek

NévTípus AlapértelmezettEngedélyezett Leírás
promptkötelező
Típusstring
A generálást irányító prompt.
video_urlkötelező video
Típusurl · video
A mozgás és a struktúra vezérléséhez használt referencia-videóra mutató URL.
control_video_urlnem kötelező
Típusurl · video
Opcionális, előre kiszámított vezérlővideó, amely a beépített vezérlőbecslés helyett használatos, ha a `skip_control_preprocess` beállítással együtt van megadva. Az újramintavételezés után, a kimeneti méretekhez és a képkockaszámhoz igazítva, közvetlen vezérlőjellé válik. A videó például már renderelt mélység-, él- vagy pózkompozitot is tartalmazhat.
skip_control_preprocessnem kötelező
Típusboolean
Alapértelmezettfalse
Közvetlen vezérlési mód, amely a `control_video_url` használatával belső mélység-, él- vagy pózbecslés helyett közvetlen vezérlést végez; URL nélkül ez a beállítás figyelmen kívül marad. Ebben a módban a kimeneti méretezés a megadott méreteket 64-es igazítással követi, hogy az RGB- és vezérlővideó illeszkedjen, míg az `auto` a forrás méretét és képarányát használja az LTX korlátain belül.
preserve_original_videonem kötelező
Típusboolean
Alapértelmezettfalse
Az eredeti videó megőrzési módja, amely csak a `skip_control_preprocess`, a `video_url` és a `control_video_url` együttes használatával érhető el. Alapértelmezés szerint le van tiltva, így a normál vezérlőfeldolgozás változatlan marad; engedélyezésekor a generálás a `video_url` alapján indul, miközben a `control_video_url` szerkezeti vezérlését megtartja. A `strength` értékkel végzett zajtalanítás határozza meg a megőrzés mértékét; az alacsonyabb értékek több eredeti képpontot tartanak meg.
image_urlnem kötelező image
Típusurl · image
Opcionális képanker-stílus vagy karakterazonosság az első képkocka kulcsképeként.
mid_image_urlnem kötelező
Típusurl · image
Opcionális képanker-megjelenés a klip közepe táján, amely kiegészíti a kezdeti `image_url` kulcsképet. Segít, hogy a megjelenés kövesse a kamera mozgását, és ne sodródjon el; `image_url` szükséges hozzá.
end_image_urlnem kötelező end_image
Típusurl · image
Opcionális képanker-megjelenés a klip utolsó képkockáján. Akkor hasznos, ha a kameramozgás a kezdőképtől eltérő helyen ér véget; `image_url` szükséges hozzá.
video_strengthnem kötelező
Típusnumber
Alapértelmezett0.6
0 – 1
A referencia-videó mozgásának és struktúrájának módosítási szabadságát ez a kondicionálási erősség vezérli: az alacsonyabb értékek nagyobb változtatást engednek.
strengthnem kötelező
Típusnumber
Alapértelmezett1
0 – 1
A referencia-videóból videóba mintavételezés zajtalanítási vezérlése, amelynek hatása a `preserve_original_video` beállítástól függ. Kikapcsolt módban csak lerövidíti a zajtalanítási ütemezést; bekapcsolva a forráspixelek átalakítását vezérli: az 1.0 mindent újragenerál, az alacsonyabb értékek pedig többet őriznek meg (például a 0.5 körülbelül 50%-ot).
num_framesnem kötelező
Típusinteger
Alapértelmezett121
9 – 481
A kimenet képkockaszáma, amelyet a felbontás és a képkockák szorzatán alapuló IC-LoRA-stabilitási keret korlátoz. A 422-es válasz azt jelenti, hogy a keret túllépésre került: csökkentsd a felbontást vagy a `num_frames` értékét. A keret körülbelül 150 képkockát engedélyez 720p-osztályú méreteknél, kisebb méreteknél pedig többet.
resolutionnem kötelező
Típusobject
Alapértelmezettauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
A kimeneti videó méretei, amelyek a stabil időtartamra is hatással vannak: a kisebb méretek több képkockát engednek, a nagyobbak pedig csökkentik a maximumot. A beépített vezérlőbecslés a méretet a hivatalos vezérlési munkafolyamathoz közel tartja; a `skip_control_preprocess` és a `control_video_url` használatával végzett közvetlen vezérlés ehelyett a megadott méreteket 64px-es igazítással követi. Közvetlen vezérlési módban az `auto` a forrás méretét és képarányát örökli az LTX korlátain belül.
frames_per_secondnem kötelező
Típusnumber
Alapértelmezett24
1 – 60
A kimeneti videó képkockasebessége, képkocka/másodpercben mérve.
num_inference_stepsnem kötelező
Típusinteger
Alapértelmezett15
8 – 30
A futtatandó következtetési lépések száma, legfeljebb 30; változatlanul hagyva 15 lépést használ.
guidance_scalenem kötelező
Típusnumber
Alapértelmezett1
1 – 20
A classifier-free guidance beállítása ezzel a skálával; alapértelmezett hangolása a jó minőséget és a gyors generálást egyaránt célozza.
generate_audionem kötelező
Típusboolean
Alapértelmezetttrue
A visszaadott MP4 hangsáv-kapcsolója: kikapcsolva csak videót tartalmazó fájlt ad, bekapcsolva hangot is.
negative_promptnem kötelező
Típusstring
Alapértelmezettcolor 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
A generálás során kerülendő tartalmat meghatározó negatív prompt.
seednem kötelező
Típusinteger | null
A generálást reprodukálhatóvá tevő seed. A None érték véletlenszerű seedet választ.
enable_prompt_expansionnem kötelező
Típusboolean
Alapértelmezetttrue
A promptbővítés engedélyezését vezérli.
enable_safety_checkernem kötelező
Típusboolean
Alapértelmezetttrue
Meghatározza, hogy engedélyezve van-e a biztonsági ellenőrzés.
video_qualitynem kötelező
Típusenum
Alapértelmezetthigh
lowmediumhighmaximum
A kimeneti videóra alkalmazott minőségi előbeállítás.
video_write_modenem kötelező
Típusenum
Alapértelmezettbalanced
fastbalancedsmall
A létrejövő videó írási módja.
loraskötelező
Típusobject[]
≤ 3 elem
LTX-2.3-hoz tartozó LoRA-kiegészítések, egyenként legfeljebb 3 GB mérettel és legfeljebb 3 megengedett elemmel. A betöltés csak azután történik, hogy a regisztráció SSRF-biztos letöltője lekérte az egyes elérési utakat.
loras[].pathkötelező
Típusstring
≤ 2048 characters
Közvetlen HTTP(S)-URL legfeljebb 3 GB méretű LoRA .safetensors fájlhoz. A betöltést lekérés előzi meg SSRF-biztos letöltő használatával.
loras[].scalenem kötelező
Típusnumber
Alapértelmezett1
0 – 2
A LoRA hatása a generált videóra a 0.0–2.0 tartományban az erősség növekedésével nő.
loras[].transformernem kötelező
Típusenum
Alapértelmezettboth
highlowboth
Transformer-kiválasztási jelző: az LTX-2.3-at használók többségéhez a 'both' illik, mert a modell csak egy transformert tartalmaz. A jelző a több transformert használó jövőbeli architektúrák támogatására szolgál.
kötelező Kanonikus név, szintén elfogadva

A fájlparaméterek nyilvános https:// URL-t, legfeljebb 10 MB-os data: URI-t vagy egy feltöltés file_url értékét fogadják el. Fájlok

Kimenet

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "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"
  }
}
Az Ön fájljai, az Ön döntéseMinden outputs[].url a tárhelyünkön lévő másolat: örökre megőrizve (GB-hónaponként fizetve) vagy 7 nap ideig ingyenesen, a fiókbeállításod vagy a ?storage= alapján.
Azonos struktúra minden modellentype, url, content_type, width, height és duration képekhez, videókhoz és hanganyagokhoz egyaránt. Az output a modell saját eredményobjektuma.
A kimenet mezői
video
object {url, content_type, file_name, file_size}A modell által létrehozott videó.
seed
integerA generálás során ténylegesen alkalmazott seed.
prompt
stringGenerálási prompt, a használat előtt alkalmazott esetleges bővítéssel együtt.

További modellek: Videóból videó

AI-ügynököknek: ez az oldal Markdown formátumban itt található: https://doitong.com/hu/developers/models/ltx-2.3-quality/reference-video-to-video/lora.md. Minden modell és útmutató: https://doitong.com/developers/llms.txt