LTX-2 19B Video-to-Video LoRA：高保真動作與風格轉換 | RunComfy

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/ltx/ltx-2-19b/video-to-video/lora \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "black-and-white video, a girl is playing a guitar, film grain",
    "video_url": "https://playgrounds-storage-public.runcomfy.net/tools/7312/media-files/input-1-1.mp4",
    "loras": [
      {
        "path": "Lightricks/LTX-2-19b-IC-LoRA-Detailer",
        "scale": 1
      }
    ]
  }'

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

{
  "type": "object",
  "title": "輸入結構",
  "required": [
    "prompt",
    "video_url",
    "loras"
  ],
  "properties": {
    "prompt": {
      "title": "提示詞",
      "description": "",
      "type": "string",
      "default": "black-and-white video, a girl is playing a guitar, film grain"
    },
    "video_url": {
      "title": "影片 URL",
      "description": "用於生成目標影片的來源影片 URL。",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7312/media-files/input-1-1.mp4"
    },
    "image_url": {
      "title": "圖片",
      "description": "可選圖片 URL，用作生成影片的第一幀。",
      "type": "string"
    },
    "loras": {
      "title": "LoRA 清單",
      "description": "要套用的 LoRA 清單，最多 10 個。",
      "type": "array",
      "default": [
        {
          "path": "Lightricks/LTX-2-19b-IC-LoRA-Detailer",
          "scale": 1
        }
      ],
      "items": {
        "path": {
          "title": "LoRA 路徑",
          "description": "LoRA 權重的 URL 或 Hugging Face 儲存庫 ID（owner/repo）。",
          "type": "string",
          "format": "str",
          "default": ""
        },
        "scale": {
          "title": "LoRA 強度",
          "description": "LoRA 模型的套用強度。",
          "type": "float",
          "format": "float_slider_with_range",
          "minimum": 0,
          "maximum": 4,
          "default": 1
        }
      },
      "maxItems": 10,
      "minItems": 0
    },
    "match_video_length": {
      "title": "匹配來源影片時長",
      "description": "啟用後，根據來源影片時長和 FPS 計算幀數；關閉後使用指定的 num_frames。",
      "type": "boolean",
      "default": true
    },
    "num_frames": {
      "title": "幀數",
      "description": "要生成的影片幀數。",
      "type": "integer",
      "minimum": 9,
      "maximum": 481,
      "default": 121
    },
    "video_size": {
      "title": "影片尺寸",
      "description": "生成影片的畫面尺寸。",
      "type": "string",
      "enum": [
        "auto",
        "square_hd",
        "square",
        "portrait_4_3",
        "portrait_16_9",
        "landscape_4_3",
        "landscape_16_9"
      ],
      "default": "auto"
    },
    "generate_audio": {
      "title": "生成音訊",
      "description": "是否為影片生成音訊。",
      "type": "boolean",
      "default": true
    },
    "use_multiscale": {
      "title": "使用多尺度生成",
      "description": "啟用後，模型會先生成較小尺寸的版本，再於目標尺寸上細化畫面細節。",
      "type": "boolean",
      "default": true
    },
    "match_input_fps": {
      "title": "匹配輸入幀率",
      "description": "啟用後，輸出 FPS 將匹配輸入影片的 FPS，而不是使用預設目標幀率。",
      "type": "boolean",
      "default": true
    },
    "fps": {
      "title": "幀率",
      "description": "生成影片每秒包含的幀數。",
      "type": "float",
      "minimum": 1,
      "maximum": 60,
      "default": 25
    },
    "guidance_scale": {
      "title": "引導係數",
      "description": "生成時使用的提示詞引導強度。",
      "type": "float",
      "minimum": 1,
      "maximum": 10,
      "default": 3
    },
    "num_inference_steps": {
      "title": "推論步數",
      "description": "生成時使用的推論步數。",
      "type": "integer",
      "minimum": 8,
      "maximum": 50,
      "default": 40
    },
    "camera_lora": {
      "title": "相機 LoRA",
      "description": "用於控制鏡頭動作的相機 LoRA。",
      "type": "string",
      "enum": [
        "dolly_in",
        "dolly_out",
        "dolly_left",
        "dolly_right",
        "jib_up",
        "jib_down",
        "static",
        "none"
      ],
      "default": "none"
    },
    "camera_lora_scale": {
      "title": "相機 LoRA 強度",
      "description": "相機 LoRA 控制鏡頭動作時的套用強度。",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 1
    },
    "negative_prompt": {
      "title": "負向提示詞",
      "description": "描述希望模型在生成結果中避免的內容或缺陷。",
      "type": "string",
      "default": "blurry, out of focus, overexposed, underexposed, low contrast, washed out colors, excessive noise, grainy texture, poor lighting, flickering, motion blur, distorted proportions, unnatural skin tones, deformed facial features, asymmetrical face, missing facial features, extra limbs, disfigured hands, wrong hand count, artifacts around text, inconsistent perspective, camera shake, incorrect depth of field, background too sharp, background clutter, distracting reflections, harsh shadows, inconsistent lighting direction, color banding, cartoonish rendering, 3D CGI look, unrealistic materials, uncanny valley effect, incorrect ethnicity, wrong gender, exaggerated expressions, wrong gaze direction, mismatched lip sync, silent or muted audio, distorted voice, robotic voice, echo, background noise, off-sync audio,incorrect dialogue, added dialogue, repetitive speech, jittery movement, awkward pauses, incorrect timing, unnatural transitions, inconsistent framing, tilted camera, flat lighting, inconsistent tone, cinematic oversaturation, stylized filters, or AI artifacts."
    },
    "seed": {
      "title": "隨機種子",
      "description": "",
      "type": "integer",
      "default": 0
    },
    "enable_prompt_expansion": {
      "title": "啟用提示詞擴展",
      "description": "是否自動擴展提示詞。",
      "type": "boolean",
      "default": false
    },
    "video_output_type": {
      "title": "影片輸出格式",
      "description": "生成影片的檔案格式。",
      "type": "string",
      "enum": [
        "X264 (.mp4)",
        "VP9 (.webm)",
        "PRORES4444 (.mov)",
        "GIF (.gif)"
      ],
      "default": "X264 (.mp4)"
    },
    "video_quality": {
      "title": "影片品質",
      "description": "生成影片的品質等級。",
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high",
        "maximum"
      ],
      "default": "high"
    },
    "preprocessor": {
      "title": "預處理器",
      "description": "用於處理輸入影片的預處理器。",
      "type": "string",
      "enum": [
        "depth",
        "canny",
        "pose",
        "none"
      ],
      "default": "none"
    },
    "ic_lora": {
      "title": "IC-LoRA",
      "description": "要載入的 IC-LoRA 類型。",
      "type": "string",
      "enum": [
        "match_preprocessor",
        "canny",
        "depth",
        "pose",
        "detailer",
        "none"
      ],
      "default": "match_preprocessor"
    },
    "ic_lora_scale": {
      "title": "IC-LoRA 強度",
      "description": "IC-LoRA 的套用強度。",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 1
    },
    "video_strength": {
      "title": "影片參考強度",
      "description": "影片條件控制強度。數值越低，模型改變來源影片內容的自由度越高。",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 1
    }
  }
}