LTX2 & LTX2.3

3.2 구성 팁

품질과 지연 시간 목표에 따라 파이프라인 클래스를 선택하세요:

기능 호환성:

Two-stage 파이프라인의 경우 --ltx2-two-stage-device-mode가 트랜스포머 상주를 제어해요:

기타 배포 플래그:

• --lora-path: 커뮤니티 LoRA 어댑터 사전 로드.
• --lora-weight-name: LoRA 저장소에 여러 가중치 파일이 있을 때 정확한 safetensors 파일 선택.

3.3 빠른 멀티 GPU 프리셋

지연 시간 중심의 LTX 서빙에서는 시퀀스 병렬 처리보다 CFG parallel을 선호해요. CFG parallel은 guidance 브랜치를 GPU들에 걸쳐 분할하고, SP/Ulysses는 주로 LTX에서 메모리/장문 시퀀스 도구예요.

degree-2 CFG parallel에는 --enable-cfg-parallel을 사용하세요. --cfg-parallel-size는 다른 CFG 브랜치 수가 명시적으로 필요할 때만 사용하세요. resident가 가용 VRAM을 초과하면 같은 병렬 처리 프리셋을 유지하고 device mode만 original로 바꾸세요.

고VRAM GPU에서는 텍스트 인코딩 지연 시간이 중요하고 메모리가 충분하다면 --text-encoder-cpu-offload false를 추가하세요.

3.3.1 Two GPUs

sglang serve \
  --model-path Lightricks/LTX-2.3 \
  --pipeline-class-name LTX2TwoStagePipeline \
  --num-gpus 2 \
  --enable-cfg-parallel \
  --ltx2-two-stage-device-mode resident

3.3.2 Four GPUs

sglang serve \
  --model-path Lightricks/LTX-2.3 \
  --pipeline-class-name LTX2TwoStagePipeline \
  --num-gpus 4 \
  --tp-size 2 \
  --enable-cfg-parallel \
  --ltx2-two-stage-device-mode resident

4. 모델 호출

4.1 기본 사용

아래 예제는 재현성을 위해 현재 SGLang 샘플링 기본값을 명시해요:

4.1.1 LTX-2 one-stage 텍스트-비디오

sglang generate \
  --model-path Lightricks/LTX-2 \
  --pipeline-class-name LTX2Pipeline \
  --prompt "A quiet coastal town at sunrise, fishing boats moving slowly through golden mist, cinematic camera movement" \
  --save-output

4.1.2 LTX-2.3 one-stage 텍스트-비디오

sglang generate \
  --model-path Lightricks/LTX-2.3 \
  --pipeline-class-name LTX2Pipeline \
  --prompt "A quiet coastal town at sunrise, fishing boats moving slowly through golden mist, cinematic camera movement" \
  --save-output

4.1.3 LTX-2 two-stage 텍스트-비디오

sglang generate \
  --model-path Lightricks/LTX-2 \
  --pipeline-class-name LTX2TwoStagePipeline \
  --prompt "A handheld shot follows a red tram crossing a rainy city square at night, reflections on the pavement, cinematic lighting" \
  --save-output

4.1.4 LTX-2.3 two-stage 텍스트-비디오

sglang generate \
  --model-path Lightricks/LTX-2.3 \
  --pipeline-class-name LTX2TwoStagePipeline \
  --prompt "A handheld shot follows a red tram crossing a rainy city square at night, reflections on the pavement, cinematic lighting" \
  --save-output

4.1.5 LTX-2.3 HQ 텍스트-비디오

sglang generate \
  --model-path Lightricks/LTX-2.3 \
  --pipeline-class-name LTX2TwoStageHQPipeline \
  --prompt "A wide cinematic shot of alpine clouds rolling over a mountain ridge, soft morning light, slow aerial camera movement" \
  --save-output

4.1.6 참조 이미지 하나로 이미지-비디오

이미지 조건 생성에는 --image-path로 이미지 하나를 전달하세요:

sglang generate \
  --model-path Lightricks/LTX-2.3 \
  --pipeline-class-name LTX2TwoStagePipeline \
  --image-path ./inputs/start.png \
  --prompt "The camera slowly pushes forward as the subject turns toward warm window light, subtle natural motion, cinematic" \
  --save-output

4.1.7 참조 이미지 두 개로 first-to-last 프레임 전환

전환 스타일 TI2V에는 --image-path로 이미지 두 개를 전달하세요. 첫 번째 이미지는 시작 조건, 두 번째는 끝 조건으로 사용돼요.

sglang generate \
  --model-path Lightricks/LTX-2.3 \
  --pipeline-class-name LTX2TwoStagePipeline \
  --image-path ./inputs/start.png ./inputs/end.png \
  --prompt "A smooth cinematic transition from the first scene into the final scene, dynamic camera motion, motion blur, zhuanchang" \
  --save-output

4.2 고급 사용

4.2.1 커뮤니티 LoRA 사용

LoRA 어댑터를 로드하려면 --lora-path를 사용하세요. Hugging Face 저장소에 여러 safetensors 파일이 있으면 --lora-weight-name으로 정확한 파일을 선택하세요. --lora-scale은 표준 LoRA 병합 스케일에 대응하며 기본값은 1.0이에요.

다음 예제는 valiantcat/LTX-2.3-Transition-LORA를 사용해요:

sglang generate \
  --model-path Lightricks/LTX-2.3 \
  --pipeline-class-name LTX2TwoStagePipeline \
  --lora-path valiantcat/LTX-2.3-Transition-LORA \
  --lora-weight-name ltx2.3-transition.safetensors \
  --prompt "A low-angle tracking shot moves through a foggy forest road. The camera rises above the treetops and transitions into a clear view of a snowy mountain peak under bright sunlight, zhuanchang" \
  --save-output

Transition LoRA를 참조 이미지 두 개와 결합할 수 있어요:

sglang generate \
  --model-path Lightricks/LTX-2.3 \
  --pipeline-class-name LTX2TwoStagePipeline \
  --image-path ./inputs/start.png ./inputs/end.png \
  --lora-path valiantcat/LTX-2.3-Transition-LORA \
  --lora-weight-name ltx2.3-transition.safetensors \
  --prompt "A fast cinematic transition from the first image to the second image, whip-pan motion, atmospheric lighting, zhuanchang" \
  --save-output

5. 실용 팁

• 기본 LTX two-stage 품질 경로로 --pipeline-class-name LTX2TwoStagePipeline을 사용하세요.
• HQ 경로를 원하고 더 큰 출력을 위한 충분한 VRAM이 있다면 --pipeline-class-name LTX2TwoStageHQPipeline을 사용하세요.
• 지연 시간이 메모리 사용보다 중요하면 고VRAM GPU에서 --ltx2-two-stage-device-mode resident를 사용하세요.
• 공식 two-stage 동작과 비교할 때는 --ltx2-two-stage-device-mode original을 사용하세요.
• --width와 --height를 타겟 모델 해상도와 정렬하세요. LTX 모델에서는 이들이 출력 비디오 차원이에요.

6. ComfyUI에서 실행