Przejdź do treści

Ltx 2.3 Quality · Reference Video to Video · LoRA

Integracja

Identyfikator modelu 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"

Pliki takie jak przykład: 0,304 $ 304 kredyty API · ≈ 32,70 ₽ Twoje pliki są mierzone przed uruchomieniem Uruchom na tej stronie

Uzyskaj klucz API
Lightricks · Wideo

Tutaj pojawi się pierwszy wynik

Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.

Zbuduj żądanie

Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.

•wymagane

Prompt używany do kierowania generowaniem.

•wymagane video_url
Upuść plik lub

URL wskazujący wideo referencyjne używane do sterowania ruchem i strukturą.

resolution domyślnie auto

Wymiary wideo wyniku, które wpływają również na stabilny czas trwania: mniejsze rozmiary pozwalają na więcej klatek, a większe obniżają maksimum. Wbudowane szacowanie sterowania utrzymuje rozmiar blisko oficjalnego przepływu sterowania; bezpośrednie sterowanie przez `skip_control_preprocess` i `control_video_url` respektuje jawne wymiary z wyrównaniem do 64px. W trybie bezpośredniego sterowania `auto` dziedziczy wymiary i proporcje źródła w granicach LTX.

domyślnie 121

Liczba klatek wyniku, ograniczona budżetem stabilności IC-LoRA opartym na iloczynie rozdzielczości i klatek. Odpowiedź 422 oznacza przekroczenie budżetu: zmniejsz rozdzielczość lub `num_frames`. Budżet pozwala na około 150 klatek przy wymiarach klasy 720p i więcej przy mniejszych rozmiarach.

•wymagane

Dodatki LoRA dla LTX-2.3, każdy ograniczony do 3 GB, z limitem 3 elementów. Ładowanie następuje dopiero po pobraniu każdej ścieżki przez bezpieczny dla SSRF downloader rejestru.

Zaawansowane 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
domyślnie color distortion, ove...

Negatywny prompt określający, czego generowanie powinno unikać.

Upuść plik lub

Opcjonalne, wstępnie obliczone wideo sterujące, używane zamiast wbudowanego szacowania sterowania, gdy zostanie podane razem z `skip_control_preprocess`. Po przeskalowaniu do zgodnych wymiarów wyniku i liczby klatek staje się bezpośrednim sygnałem sterującym. Wideo może zawierać np. wyrenderowaną wcześniej mapę głębi, krawędzi lub pozy.

image_url
Upuść plik lub

Opcjonalny styl zakotwiczenia obrazu lub tożsamość postaci jako klatka kluczowa pierwszej klatki.

Upuść plik lub

Opcjonalny wygląd zakotwiczenia obrazu w pobliżu środka klipu, uzupełniający początkową klatkę kluczową `image_url`. Pomaga dopasować wygląd do ruchu kamery zamiast powodować dryf; wymaga `image_url`.

end_image_url
Upuść plik lub

Opcjonalny wygląd zakotwiczenia obrazu w końcowej klatce klipu. Przydatny, gdy ruch kamery kończy się w miejscu innym niż obraz początkowy; wymaga `image_url`.

video_quality domyślnie high

Ustawienie jakości stosowane do wynikowego wideo.

video_write_mode domyślnie balanced

Tryb zapisu wynikowego wideo.

domyślnie 0.6

Swoboda zmiany ruchu i struktury wideo referencyjnego jest sterowana tą siłą uwarunkowania: niższe wartości pozwalają na większe zmiany.

domyślnie 1

Sterowanie odszumianiem przy próbkowaniu wideo z wideo referencyjnego, którego działanie zależy od `preserve_original_video`. Gdy tryb jest wyłączony, skraca tylko harmonogram odszumiania; gdy jest włączony, steruje transformacją pikseli źródłowych: 1.0 regeneruje wszystko, a niższe wartości zachowują więcej (np. 0.5 zachowuje około 50%).

domyślnie 24

Liczba klatek na sekundę wynikowego wideo.

domyślnie 15

Ustaw liczbę kroków wnioskowania, maksymalnie 30; pozostawienie bez zmian używa 15.

domyślnie 1

Dostosuj classifier-free guidance za pomocą tej skali; jej domyślne strojenie ma zapewniać wysoką jakość i szybkie generowanie.

Ziarno zapewniające powtarzalność generowania. Ustawienie None wybiera ziarno losowo.

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

Uruchom to żądanie

Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Uzyskaj klucz API

Informacje o Ltx 2.3 Quality · Reference Video to Video · LoRA

Generuje wideo na podstawie wymaganego `prompt` i referencyjnego `video_url` określającego ruch oraz strukturę, a dodatkowo wymaga `loras` — maksymalnie 3 plików LoRA o rozmiarze do 3 GB każdy. Opcjonalne obrazy pierwszej, środkowej i ostatniej klatki kluczowej (`image_url`, `mid_image_url`, `end_image_url`) ustalają wygląd. `video_strength` i `strength` przyjmują wartości od 0 do 1, a `num_frames` od 9 do 481.

Parametry

Wyślij nazwę kanoniczną albo natywną, nie obie. Nazwy kanoniczne

NazwaTyp DomyślneDozwolone Opis
promptwymagane
Typstring
Prompt używany do kierowania generowaniem.
video_urlwymagane video
Typurl · video
URL wskazujący wideo referencyjne używane do sterowania ruchem i strukturą.
control_video_urlopcjonalne
Typurl · video
Opcjonalne, wstępnie obliczone wideo sterujące, używane zamiast wbudowanego szacowania sterowania, gdy zostanie podane razem z `skip_control_preprocess`. Po przeskalowaniu do zgodnych wymiarów wyniku i liczby klatek staje się bezpośrednim sygnałem sterującym. Wideo może zawierać np. wyrenderowaną wcześniej mapę głębi, krawędzi lub pozy.
skip_control_preprocessopcjonalne
Typboolean
Domyślnefalse
Bezpośredni tryb sterowania używający `control_video_url` zamiast wewnętrznego szacowania głębi, krawędzi lub pozy; bez tego URL ustawienie jest ignorowane. Rozmiar wyniku w tym trybie respektuje jawne wymiary z wyrównaniem do 64, aby dopasować wideo RGB i sterujące, natomiast `auto` używa wymiarów i proporcji źródła w granicach LTX.
preserve_original_videoopcjonalne
Typboolean
Domyślnefalse
Tryb zachowania oryginalnego wideo, dostępny tylko z `skip_control_preprocess`, `video_url` i `control_video_url`. Domyślnie wyłączony, pozostawia standardowe przetwarzanie sterowania; po włączeniu rozpoczyna generowanie od `video_url`, zachowując wskazówki strukturalne z `control_video_url`. Odszumianie przez `strength` określa zachowywaną ilość; niższe wartości zachowują więcej oryginalnych pikseli.
image_urlopcjonalne image
Typurl · image
Opcjonalny styl zakotwiczenia obrazu lub tożsamość postaci jako klatka kluczowa pierwszej klatki.
mid_image_urlopcjonalne
Typurl · image
Opcjonalny wygląd zakotwiczenia obrazu w pobliżu środka klipu, uzupełniający początkową klatkę kluczową `image_url`. Pomaga dopasować wygląd do ruchu kamery zamiast powodować dryf; wymaga `image_url`.
end_image_urlopcjonalne end_image
Typurl · image
Opcjonalny wygląd zakotwiczenia obrazu w końcowej klatce klipu. Przydatny, gdy ruch kamery kończy się w miejscu innym niż obraz początkowy; wymaga `image_url`.
video_strengthopcjonalne
Typnumber
Domyślne0.6
0 – 1
Swoboda zmiany ruchu i struktury wideo referencyjnego jest sterowana tą siłą uwarunkowania: niższe wartości pozwalają na większe zmiany.
strengthopcjonalne
Typnumber
Domyślne1
0 – 1
Sterowanie odszumianiem przy próbkowaniu wideo z wideo referencyjnego, którego działanie zależy od `preserve_original_video`. Gdy tryb jest wyłączony, skraca tylko harmonogram odszumiania; gdy jest włączony, steruje transformacją pikseli źródłowych: 1.0 regeneruje wszystko, a niższe wartości zachowują więcej (np. 0.5 zachowuje około 50%).
num_framesopcjonalne
Typinteger
Domyślne121
9 – 481
Liczba klatek wyniku, ograniczona budżetem stabilności IC-LoRA opartym na iloczynie rozdzielczości i klatek. Odpowiedź 422 oznacza przekroczenie budżetu: zmniejsz rozdzielczość lub `num_frames`. Budżet pozwala na około 150 klatek przy wymiarach klasy 720p i więcej przy mniejszych rozmiarach.
resolutionopcjonalne
Typobject
Domyślneauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Wymiary wideo wyniku, które wpływają również na stabilny czas trwania: mniejsze rozmiary pozwalają na więcej klatek, a większe obniżają maksimum. Wbudowane szacowanie sterowania utrzymuje rozmiar blisko oficjalnego przepływu sterowania; bezpośrednie sterowanie przez `skip_control_preprocess` i `control_video_url` respektuje jawne wymiary z wyrównaniem do 64px. W trybie bezpośredniego sterowania `auto` dziedziczy wymiary i proporcje źródła w granicach LTX.
frames_per_secondopcjonalne
Typnumber
Domyślne24
1 – 60
Liczba klatek na sekundę wynikowego wideo.
num_inference_stepsopcjonalne
Typinteger
Domyślne15
8 – 30
Ustaw liczbę kroków wnioskowania, maksymalnie 30; pozostawienie bez zmian używa 15.
guidance_scaleopcjonalne
Typnumber
Domyślne1
1 – 20
Dostosuj classifier-free guidance za pomocą tej skali; jej domyślne strojenie ma zapewniać wysoką jakość i szybkie generowanie.
generate_audioopcjonalne
Typboolean
Domyślnetrue
Przełącznik ścieżki audio dla zwracanego MP4: wyłączenie tworzy plik zawierający tylko wideo, a włączenie dołącza audio.
negative_promptopcjonalne
Typstring
Domyślnecolor 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
Negatywny prompt określający, czego generowanie powinno unikać.
seedopcjonalne
Typinteger | null
Ziarno zapewniające powtarzalność generowania. Ustawienie None wybiera ziarno losowo.
enable_prompt_expansionopcjonalne
Typboolean
Domyślnetrue
Określa, czy rozwijanie promptu jest włączone.
enable_safety_checkeropcjonalne
Typboolean
Domyślnetrue
Określa, czy sprawdzanie bezpieczeństwa jest włączone.
video_qualityopcjonalne
Typenum
Domyślnehigh
lowmediumhighmaximum
Ustawienie jakości stosowane do wynikowego wideo.
video_write_modeopcjonalne
Typenum
Domyślnebalanced
fastbalancedsmall
Tryb zapisu wynikowego wideo.
loraswymagane
Typobject[]
≤ 3 elementy
Dodatki LoRA dla LTX-2.3, każdy ograniczony do 3 GB, z limitem 3 elementów. Ładowanie następuje dopiero po pobraniu każdej ścieżki przez bezpieczny dla SSRF downloader rejestru.
loras[].pathwymagane
Typstring
≤ 2048 characters
Bezpośredni URL HTTP(S) do pliku LoRA .safetensors o rozmiarze nie większym niż 3 GB. Ładowanie jest poprzedzone pobraniem przez bezpieczny dla SSRF downloader.
loras[].scaleopcjonalne
Typnumber
Domyślne1
0 – 2
Wpływ LoRA na generowane wideo rośnie wraz z tą siłą w zakresie 0.0–2.0.
loras[].transformeropcjonalne
Typenum
Domyślneboth
highlowboth
Flaga wyboru transformera: 'both' pasuje niemal każdemu użytkownikowi LTX-2.3, ponieważ model ma tylko jeden transformer. Flaga istnieje na potrzeby przyszłych architektur z wieloma transformerami.
wymagane Nazwa kanoniczna, również akceptowana

Parametry plików przyjmują publiczny URL https://, identyfikator URI data: do 10 MB albo file_url przesłanego pliku. Pliki

Wynik

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"
  }
}
Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.
Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.
Pola wyniku
video
object {url, content_type, file_name, file_size}Wideo utworzone przez model.
seed
integerRzeczywiste ziarno zastosowane podczas generowania.
prompt
stringPrompt generowania, w tym wszelkie rozszerzenia zastosowane przed użyciem.

Więcej modeli: Wideo na wideo

Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/ltx-2.3-quality/reference-video-to-video/lora.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt