Siirry sisältöön

Ltx 2.3 Quality · Reference Video to Video · LoRA

Integroi

Mallin tunniste 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"

Esimerkin kaltaiset tiedostot: 0,304 $ 304 API-krediittiä · ≈ 32,70 ₽ tiedostosi mitataan ennen suorittamista Suorita tällä sivulla

Hanki API-avain
Lightricks · Video

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

•pakollinen

Generointia ohjaava kehote.

•pakollinen video_url
Pudota tiedosto tai

URL, joka osoittaa liikkeen ja rakenteen ohjaamiseen käytettävään viitevide oon.

resolution oletus auto

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.

oletus 121

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.

•pakollinen

LTX-2.3:n LoRA-lisäykset, kukin enintään 3 GB ja enintään 3 merkintää. Lataus tapahtuu vasta, kun rekisterin SSRF-turvallinen lataaja on hakenut kunkin polun.

Lisäasetukset 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
oletus color distortion, ove...

Negatiivinen kehote, joka määrittää, mitä generoinnissa tulee välttää.

Pudota tiedosto tai

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.

image_url
Pudota tiedosto tai

Valinnainen kuvan ankkurointityyli tai hahmon identiteetti ensimmäisen ruudun avainruuduksi.

Pudota tiedosto tai

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
Pudota tiedosto tai

Valinnainen kuvan ankkuroitu ulkoasu leikkeen viimeisessä ruudussa. Hyödyllinen, kun kameran liike päättyy eri paikkaan kuin aloituskuva; edellyttää asetusta `image_url`.

video_quality oletus high

Tulostevideoon käytettävä laatu-esiasetus.

video_write_mode oletus balanced

Tuloksena syntyvän videon kirjoitustila.

oletus 0.6

Viitevideon liikkeen ja rakenteen muuttamisen vapaus määräytyy tämän ehdollistamisen voimakkuudesta: pienemmät arvot sallivat suuremmat muutokset.

oletus 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 %.

oletus 24

Tulostevideon ruutunopeus ruutuina sekunnissa.

oletus 15

Määritä suoritettavien päättelyvaiheiden määrä, enintään 30; muuttamatta jätettynä käytetään arvoa 15.

oletus 1

Säädä classifier-free guidance -ohjausta tällä asteikolla; oletus on viritetty sekä korkeaan laatuun että nopeaan generointiin.

Generoinnin toistettavaksi tekevä siemen. Arvon None asettaminen valitsee siemenen satunnaisesti.

POST /run/ltx-2.3-quality/reference-video-to-video/lora?wait=20 hinta → 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"

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: Ltx 2.3 Quality · Reference Video to Video · LoRA

Luo videon pakollisen `prompt`-parametrin ja liikkeen sekä rakenteen viitteenä toimivan `video_url`-parametrin perusteella ja vaatii lisäksi `loras`-parametrin, jossa on enintään 3 LoRA-tiedostoa, kukin enintään 3 GB. Valinnaiset alku-, keski- ja loppuvaiheen avainruutukuvat (`image_url`, `mid_image_url`, `end_image_url`) ankkuroivat ulkoasun. `video_strength` ja `strength` vaihtelevat välillä 0–1 ja `num_frames` välillä 9–481.

Parametrit

Lähetä joko kanoninen nimi tai natiivi nimi, älä molempia. Kanoniset nimet

NimiTyyppi OletusSallitut Kuvaus
promptpakollinen
Tyyppistring
Generointia ohjaava kehote.
video_urlpakollinen video
Tyyppiurl · video
URL, joka osoittaa liikkeen ja rakenteen ohjaamiseen käytettävään viitevide oon.
control_video_urlvalinnainen
Tyyppiurl · video
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_preprocessvalinnainen
Tyyppiboolean
Oletusfalse
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_videovalinnainen
Tyyppiboolean
Oletusfalse
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_urlvalinnainen image
Tyyppiurl · image
Valinnainen kuvan ankkurointityyli tai hahmon identiteetti ensimmäisen ruudun avainruuduksi.
mid_image_urlvalinnainen
Tyyppiurl · image
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_urlvalinnainen end_image
Tyyppiurl · image
Valinnainen kuvan ankkuroitu ulkoasu leikkeen viimeisessä ruudussa. Hyödyllinen, kun kameran liike päättyy eri paikkaan kuin aloituskuva; edellyttää asetusta `image_url`.
video_strengthvalinnainen
Tyyppinumber
Oletus0.6
0 – 1
Viitevideon liikkeen ja rakenteen muuttamisen vapaus määräytyy tämän ehdollistamisen voimakkuudesta: pienemmät arvot sallivat suuremmat muutokset.
strengthvalinnainen
Tyyppinumber
Oletus1
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_framesvalinnainen
Tyyppiinteger
Oletus121
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.
resolutionvalinnainen
Tyyppiobject
Oletusauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_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_secondvalinnainen
Tyyppinumber
Oletus24
1 – 60
Tulostevideon ruutunopeus ruutuina sekunnissa.
num_inference_stepsvalinnainen
Tyyppiinteger
Oletus15
8 – 30
Määritä suoritettavien päättelyvaiheiden määrä, enintään 30; muuttamatta jätettynä käytetään arvoa 15.
guidance_scalevalinnainen
Tyyppinumber
Oletus1
1 – 20
Säädä classifier-free guidance -ohjausta tällä asteikolla; oletus on viritetty sekä korkeaan laatuun että nopeaan generointiin.
generate_audiovalinnainen
Tyyppiboolean
Oletustrue
Palautettavan MP4-tiedoston ääniraidan valitsin: poissa käytöstä tuottaa vain videon sisältävän tiedoston, käytössä sisältää äänen.
negative_promptvalinnainen
Tyyppistring
Oletuscolor 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ää.
seedvalinnainen
Tyyppiinteger | null
Generoinnin toistettavaksi tekevä siemen. Arvon None asettaminen valitsee siemenen satunnaisesti.
enable_prompt_expansionvalinnainen
Tyyppiboolean
Oletustrue
Määrittää, onko kehotteen laajennus käytössä.
enable_safety_checkervalinnainen
Tyyppiboolean
Oletustrue
Määrittää, onko turvallisuustarkistus käytössä.
video_qualityvalinnainen
Tyyppienum
Oletushigh
lowmediumhighmaximum
Tulostevideoon käytettävä laatu-esiasetus.
video_write_modevalinnainen
Tyyppienum
Oletusbalanced
fastbalancedsmall
Tuloksena syntyvän videon kirjoitustila.
loraspakollinen
Tyyppiobject[]
≤ 3 kohdetta
LTX-2.3:n LoRA-lisäykset, kukin enintään 3 GB ja enintään 3 merkintää. Lataus tapahtuu vasta, kun rekisterin SSRF-turvallinen lataaja on hakenut kunkin polun.
loras[].pathpakollinen
Tyyppistring
≤ 2048 characters
Suora HTTP(S)-URL-osoite enintään 3 GB:n LoRA .safetensors -tiedostoon. Lataamista edeltää SSRF-turvallisen lataajan tekemä haku.
loras[].scalevalinnainen
Tyyppinumber
Oletus1
0 – 2
LoRA:n vaikutus generoituun videoon kasvaa voimakkuuden kasvaessa välillä 0.0–2.0.
loras[].transformervalinnainen
Tyyppienum
Oletusboth
highlowboth
Transformerin valintalippu: 'both' sopii lähes kaikille LTX-2.3:n käyttäjille, koska mallissa on vain yksi transformer. Lippu tukee tulevia arkkitehtuureja, joissa on useita transformereita.
pakollinen Kanoninen nimi, myös hyväksytty

Tiedostoparametrit hyväksyvät julkisen https://-URL:n, enintään 10 MB:n data:-URI:n tai lähetyksen file_url-arvon. Tiedostot

Tulos

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"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
video
object {url, content_type, file_name, file_size}Mallin tuottama video.
seed
integerGeneroinnissa käytetty todellinen siemen.
prompt
stringGenerointikehote, mukaan lukien ennen käyttöä tehty laajennus.

Lisää malleja: Videosta videoksi

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/ltx-2.3-quality/reference-video-to-video/lora.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt