LTX-2.3 비디오 API
API 참조
기본 URL: https://api.ltx.video/v1
인증: Authorization: Bearer <API_KEY>
응답: MP4 바이너리 (직접 다운로드, 폴링 없음)
엔드포인트
| 엔드포인트 | 입력 | 용도 |
|---|---|---|
/v1/text-to-video | prompt | 텍스트로 비디오 생성 |
/v1/image-to-video | image_uri + prompt | 정지 이미지 애니메이션 |
/v1/audio-to-video | audio_uri + image_uri + prompt | 오디오 + 이미지로 립싱크 비디오 |
/v1/extend | video_uri + prompt | 비디오 시작 또는 끝 연장 |
/v1/retake | video_uri + 시간 범위 | 비디오 구간 재생성 |
모델
| 모델 | 속도 | 품질 |
|---|---|---|
ltx-2-3-fast | ~17초 | 좋음 (테스트용) |
ltx-2-3-pro | ~30-60초 | 최고 (최종 결과물용) |
지원 해상도
1920x1080(가로 16:9)1080x1920(세로 9:16 — 네이티브 세로, 세로 데이터로 학습됨)1440x1080,4096x2160(텍스트-투-비디오 전용)
오디오-투-비디오 전용 해상도: 1920x1080 또는 1080x1920
빠른 예제
텍스트를 비디오로
curl -X POST "https://api.ltx.video/v1/text-to-video" \
-H "Authorization: Bearer $LTX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A man in a navy blue suit sits at a luxury restaurant table...",
"model": "ltx-2-3-pro",
"duration": 8,
"resolution": "1920x1080"
}' -o output.mp4
오디오를 비디오로 (립싱크)
curl -X POST "https://api.ltx.video/v1/audio-to-video" \
-H "Authorization: Bearer $LTX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"audio_uri": "https://example.com/voice.mp3",
"image_uri": "https://example.com/portrait.jpg",
"prompt": "A man speaks directly to camera...",
"model": "ltx-2-3-pro",
"resolution": "1920x1080"
}' -o output.mp4
Python 래퍼
import requests
def ltx_audio_to_video(audio_url, image_url, prompt, api_key,
model="ltx-2-3-pro", resolution="1920x1080",
output_path="output.mp4"):
r = requests.post(
"https://api.ltx.video/v1/audio-to-video",
headers={"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"},
json={"audio_uri": audio_url, "image_uri": image_url,
"prompt": prompt, "model": model, "resolution": resolution},
timeout=300, stream=True
)
if r.status_code != 200:
raise RuntimeError(f"LTX 오류 {r.status_code}: {r.text}")
with open(output_path, "wb") as f:
for chunk in r.iter_content(8192): f.write(chunk)
return output_path
⚠️ 중요 규칙 (경험을 통해 학습됨)
파일 호스팅
- URL은 HTTPS여야 함 — HTTP는 거부됨
- 파일은 올바른 MIME 유형을 반환해야 함 (
application/octet-stream아님) - uguu.se 사용 가능:
curl -F "files[][email protected]" https://uguu.se/upload로 업로드 - 오디오: MP3로 업로드 (WAV 아님) → uguu는
audio/mpeg반환 ✅ - 4K 이미지 실패 → 업로드 전 1920x1080으로 리사이즈
# MP3를 uguu.se에 업로드
AUDIO_URL=$(curl -s -F "files[][email protected]" "https://uguu.se/upload" | \
python3 -c "import sys,json; print(json.load(sys.stdin)['files'][0]['url'])")
# 이미지 업로드
IMAGE_URL=$(curl -s -F "files[][email protected]" "https://uguu.se/upload" | \
python3 -c "import sys,json; print(json.load(sys.stdin)['files'][0]['url'])")
이미지 크기 제한
# 큰 이미지 업로드 전 리사이즈
ffmpeg -y -i input_4k.png -vf "scale=1920:1080" output_1080.jpg
얼굴 일관성
- 캐릭터가 아래를 보는 프롬프트는 피할 것 — 얼굴 일관성이 깨짐
- 머리 높이와 시선은 항상 정면을 유지
- 캐릭터가 화면 밑으로 손을 내미는 대신 이미 프레임 안에 물체를 배치할 것
마지막 프레임
- LTX는 첫 번째+마지막 프레임을 기본적으로 지원하지 않음
- 해결 방법: 클립 A 생성, 클립 B 생성,
/v1/extend로 연결
프롬프팅 가이드 (LTX-2.3)
LTX-2.3은 훨씬 강력한 텍스트 연결 성능을 가집니다. 구체성이 승리합니다.
1. 명사보다 동사를 사용하세요
❌ "A dramatic portrait of a man standing"
✅ "A man stands on a rooftop. His coat flaps in the wind. He adjusts his collar and steps forward as the camera tracks right."
2. 감독처럼 장면을 구성하세요
- 왼쪽 vs 오른쪽, 전경 vs 배경을 지정하세요
- 누가 움직이는지, 무엇이 움직이는지, 어떻게 움직이는지, 카메라가 무엇을 하는지 설명하세요
- 공간 관계가 이제 존중됩니다
3. 오디오를 명시적으로 설명하세요 (텍스트-투-비디오의 경우)
- 소리 유형을 구체적으로: 대화, 배경음, 음악
- 톤과 강도를 지정하세요
- 예:
"His voice is clear and warm. Restaurant ambient sound softly in the background."
4. 정적인 사진 같은 프롬프트는 피하세요
- 프롬프트가 정지 이미지처럼 읽히면 → 출력도 그렇게 동작합니다
- 바람, 움직임, 호흡, 제스처, 카메라 움직임을 추가하세요
5. 질감과 재질을 설명하세요
- 머리카락, 직물, 표면 마감, 조명 감쇠
"Individual hair strands visible in the backlight"→ 이제 올바르게 렌더링됩니다
6. 인물 사진 (9:16) 네이티브
resolution: "1080x1920"→ 세로 데이터로 학습됨- 의도적으로 세로 방향을 염두에 두고 프레이밍하세요, 잘린 가로 화면으로 취급하지 마세요
7. 복잡한 장면도 이제 작동합니다
- 여러 동작을 레이어링하세요:
"He picks up the banana, raises it to his ear, and smirks" - 캐릭터 연기 + 환경 + 카메라 움직임을 결합하세요
립싱크 프롬프트 템플릿
A [사람에 대한 설명] sits/stands [장소]. He/she speaks directly
to camera, lips moving in perfect sync with his/her voice. [제스처 상세].
Head stays level and gaze remains locked on camera throughout.
[환경 설명 softly blurred in background].
[조명]. [카메라: holds steady at eye level, front-on].
ComfyUI 노드
ComfyUI용 커스텀 노드 (수동 API 호출 불필요):
cd ComfyUI/custom_nodes
git clone https://github.com/PauldeLavallaz/comfyui-ltx-node
노드: LTX Text to Video, LTX Image to Video, LTX Extend Video
카테고리: LTX Video
API 키
Paul의 키: ~/clawd/.env 파일에 LTX_API_KEY로 저장됨
ltxv_RfSU5hdKJb_g5dwbECZWnilE1P8dJzbavz6niP_0LQJ942ARHIVhrBCfebcytEL1efLVx_63S_PJyWTzicrBcWEkOXfCbGTl8JSzlJJk329MwRViEgOoE2KnE9LIA5t6QSFeBy7DLnTIcX0AZNbV9Jv0TuC7qcq2gV33G6ROhUVUDCuN