LTX-2.3 影片 API
API 參考
基礎 URL: https://api.ltx.video/v1
認證: Authorization: Bearer <API_KEY>
回應: MP4 二進位檔(直接下載,無需輪詢)
端點
| 端點 | 輸入 | 用途 |
|---|---|---|
/v1/text-to-video | 提示詞 | 從文字產生影片 |
/v1/image-to-video | image_uri + 提示詞 | 將靜態圖片動畫化 |
/v1/audio-to-video | audio_uri + image_uri + 提示詞 | 從音訊 + 圖片進行唇形同步 |
/v1/extend | video_uri + 提示詞 | 在影片開頭或結尾擴展影片 |
/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.
[背景環境柔和模糊的描述].
[光線]. [攝影機:固定於視線水平,正面拍攝].
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