Ltx 2.3 Quality

curl -X POST https://superpowers.tools/v1/run \
  -H 'Authorization: Bearer $SP_KEY' \
  -d '{"tool":"fal.ltx-2.3-quality-reference-video-to-video-lora","input":{"loras":["marketing digital"],"prompt":"","video_url":""},"idempotency_key":"example-request-1"}'

{
  "type": "object",
  "required": [
    "loras",
    "prompt",
    "video_url"
  ],
  "properties": {
    "sync_mode": {
      "type": "boolean",
      "description": "If True, the media is returned as a data URI inline in the response. Useful for short-lived requests and tests.",
      "default": false
    },
    "strength": {
      "type": "number",
      "description": "Sampler denoise strength for reference-video-to-video. With preserve_original_video on, this is the video-to-video amount: lower values keep more of the original video's pixels (e.g. 0.5 = keep ~50%), 1.0 fully regenerates. Without preserve_original_video it only trims the denoise schedule.",
      "default": 1
    },
    "num_frames": {
      "type": "integer",
      "description": "The number of output frames to generate. This IC-LoRA endpoint caps the resolution x frames volume for stability (~150 frames at 720p-class; more at smaller sizes). A request above the budget returns a 422 — reduce num_frames or use a smaller resolution.",
      "default": 121
    },
    "loras": {
      "type": "array",
      "description": "Up to 3 LoRAs to apply on top of LTX-2.3. Each path is downloaded through the registry SSRF-safe downloader before it is loaded. Max size: 3 GB per LoRA."
    },
    "num_inference_steps": {
      "type": "integer",
      "description": "Number of inference steps. Defaults to 15 and can be increased up to 30.",
      "default": 15
    },
    "skip_control_preprocess": {
      "type": "boolean",
      "description": "Skip the built-in control estimation (depth / edge / pose) and use control_video_url directly as the control signal. Requires control_video_url; ignored if it is not set. With resolution='auto', the output follows the source video size/aspect up to the LTX limits. Explicit resolutions are honored an",
      "default": false
    },
    "enable_safety_checker": {
      "type": "boolean",
      "description": "Whether to enable the safety checker.",
      "default": true
    },
    "negative_prompt": {
      "type": "string",
      "description": "The negative prompt to steer generation away from.",
      "default": "color 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"
    },
    "resolution": {
      "type": "string",
      "description": "The size of the generated video. In direct-control mode (skip_control_preprocess with control_video_url), 'auto' follows the source video size/aspect up to the LTX limits and explicit sizes are honored with 64px alignment. In the built-in control estimation mode, the output stays near the official c",
      "default": "auto",
      "enum": [
        "auto",
        "square_hd",
        "square",
        "portrait_4_3",
        "portrait_16_9",
        "landscape_4_3",
        "landscape_16_9"
      ]
    },
    "enable_prompt_expansion": {
      "type": "boolean",
      "description": "Whether to enable prompt expansion.",
      "default": true
    },
    "mid_image_url": {
      "type": "string",
      "description": "Optional middle-frame keyframe image. When set, the look/appearance is anchored to this image around the middle of the clip (in addition to image_url at the start), so the appearance follows a moving camera instead of drifting. Requires image_url."
    },
    "seed": {
      "type": "integer",
      "description": "Random seed for reproducibility. If None, a random seed is chosen."
    },
    "guidance_scale": {
      "type": "number",
      "description": "Classifier-free guidance scale. The default is tuned for fast, high-quality generation.",
      "default": 1
    },
    "video_strength": {
      "type": "number",
      "description": "Video conditioning strength. Lower values give the model more freedom to change the reference video motion/structure.",
      "default": 0.6
    },
    "prompt": {
      "type": "string",
      "description": "The prompt to guide generation."
    },
    "generate_audio": {
      "type": "boolean",
      "description": "Whether to include audio in the returned video. When disabled, the final MP4 is returned without an audio track.",
      "default": true
    },
    "control_video_url": {
      "type": "string",
      "description": "Optional pre-computed control video (e.g. an already-rendered depth / edge / pose composite). When provided together with skip_control_preprocess, the built-in control estimation is skipped and this video is used directly as the control signal, resampled to the output resolution and frame count."
    },
    "video_write_mode": {
      "type": "string",
      "description": "The write mode of the generated video.",
      "default": "balanced",
      "enum": [
        "fast",
        "balanced",
        "small"
      ]
    },
    "image_url": {
      "type": "string",
      "description": "Optional reference image for style/character anchoring. This is the FIRST-frame keyframe."
    },
    "preserve_original_video": {
      "type": "boolean",
      "description": "True video-to-video: the base video_url is used as the generation's starting point, while control_video_url still drives the structure. The amount of the original preserved is controlled by `strength` (denoise): lower `strength` keeps more of the original video's pixels. Requires skip_control_prepro",
      "default": false
    },
    "video_url": {
      "type": "string",
      "description": "The URL of the reference video that supplies motion/structure."
    },
    "video_quality": {
      "type": "string",
      "description": "The quality preset of the generated video.",
      "default": "high",
      "enum": [
        "low",
        "medium",
        "high",
        "maximum"
      ]
    },
    "end_image_url": {
      "type": "string",
      "description": "Optional last-frame keyframe image. When set, the look/appearance is anchored to this image at the end of the clip. Useful for shots where the camera travels to a different place than the start image. Requires image_url."
    },
    "frames_per_second": {
      "type": "number",
      "description": "Frames per second of the generated video.",
      "default": 24
    }
  }
}