Editto

curl -X POST https://superpowers.tools/v1/run \
  -H 'Authorization: Bearer $SP_KEY' \
  -d '{"tool":"fal.editto","input":{"prompt":"","video_url":""},"idempotency_key":"example-request-1"}'

{
  "type": "object",
  "required": [
    "prompt",
    "video_url"
  ],
  "properties": {
    "shift": {
      "type": "number",
      "description": "Shift parameter for video generation.",
      "default": 5
    },
    "temporal_downsample_factor": {
      "type": "integer",
      "description": "Temporal downsample factor for the video. This is an integer value that determines how many frames to skip in the video. A value of 0 means no downsampling. For each downsample factor, one upsample factor will automatically be applied.",
      "default": 0
    },
    "video_write_mode": {
      "type": "string",
      "description": "The write mode of the generated video.",
      "default": "balanced",
      "enum": [
        "fast",
        "balanced",
        "small"
      ]
    },
    "sampler": {
      "type": "string",
      "description": "Sampler to use for video generation.",
      "default": "unipc",
      "enum": [
        "unipc",
        "dpm++",
        "euler"
      ]
    },
    "enable_safety_checker": {
      "type": "boolean",
      "description": "If set to true, the safety checker will be enabled. Disabling it requires account authorization; unauthorized requests are always checked.",
      "default": false
    },
    "match_input_num_frames": {
      "type": "boolean",
      "description": "If true, the number of frames in the generated video will match the number of frames in the input video. If false, the number of frames will be determined by the num_frames parameter.",
      "default": false
    },
    "match_input_frames_per_second": {
      "type": "boolean",
      "description": "If true, the frames per second of the generated video will match the input video. If false, the frames per second will be determined by the frames_per_second parameter.",
      "default": false
    },
    "acceleration": {
      "type": "string",
      "description": "Acceleration to use for inference. Options are 'none' or 'regular'. Accelerated inference will very slightly affect output, but will be significantly faster.",
      "default": "regular",
      "enum": [
        "none",
        "low",
        "regular"
      ]
    },
    "prompt": {
      "type": "string",
      "description": "The text prompt to guide video generation."
    },
    "negative_prompt": {
      "type": "string",
      "description": "Negative prompt for video generation.",
      "default": "letterboxing, borders, black bars, bright colors, overexposed, static, blurred details, subtitles, style, artwork, painting, picture, still, overall gray, worst quality, low quality, JPEG compression residue, ugly, incomplete, extra fingers, poorly drawn hands, poorly drawn faces, deformed, disfigured, malformed limbs, fused fingers, still picture, cluttered background, three legs, many people in the background, walking backwards"
    },
    "num_frames": {
      "type": "integer",
      "description": "Number of frames to generate. Must be between 81 to 241 (inclusive).",
      "default": 81
    },
    "num_interpolated_frames": {
      "type": "integer",
      "description": "Number of frames to interpolate between the original frames. A value of 0 means no interpolation.",
      "default": 0
    },
    "resolution": {
      "type": "string",
      "description": "Resolution of the generated video.",
      "default": "auto",
      "enum": [
        "auto",
        "240p",
        "360p",
        "480p",
        "580p",
        "720p"
      ]
    },
    "num_inference_steps": {
      "type": "integer",
      "description": "Number of inference steps for sampling. Higher values give better quality but take longer.",
      "default": 30
    },
    "return_frames_zip": {
      "type": "boolean",
      "description": "If true, also return a ZIP file containing all generated frames.",
      "default": false
    },
    "sync_mode": {
      "type": "boolean",
      "description": "If `True`, the media will be returned as a data URI and the output data won't be available in the request history.",
      "default": false
    },
    "guidance_scale": {
      "type": "number",
      "description": "Guidance scale for classifier-free guidance. Higher values encourage the model to generate images closely related to the text prompt.",
      "default": 5
    },
    "video_quality": {
      "type": "string",
      "description": "The quality of the generated video.",
      "default": "high",
      "enum": [
        "low",
        "medium",
        "high",
        "maximum"
      ]
    },
    "enable_auto_downsample": {
      "type": "boolean",
      "description": "If true, the model will automatically temporally downsample the video to an appropriate frame length for the model, then will interpolate it back to the original frame length.",
      "default": false
    },
    "aspect_ratio": {
      "type": "string",
      "description": "Aspect ratio of the generated video.",
      "default": "auto",
      "enum": [
        "auto",
        "16:9",
        "1:1",
        "9:16"
      ]
    },
    "video_url": {
      "type": "string",
      "description": "URL to the source video file. Required for inpainting."
    },
    "frames_per_second": {
      "type": "integer",
      "description": "Frames per second of the generated video. Must be between 5 to 30. Ignored if match_input_frames_per_second is true.",
      "default": 16
    },
    "seed": {
      "type": "integer",
      "description": "Random seed for reproducibility. If None, a random seed is chosen."
    }
  }
}