fal-upscale

Files (2)

• SKILL.md
• upscale.sh · scripts/

SKILL.md (first lines)

# fal.ai Upscale

Upscale and enhance image resolution using state-of-the-art AI models.

## How It Works

1. User provides image URL and optional scale factor
2. Script selects appropriate upscaling model
3. Sends request to fal.ai API
4. Returns upscaled image URL

## Image Upscale Models

| Model | Scale | Best For |
|-------|-------|----------|
| `fal-ai/aura-sr` | 4x | General upscaling, fast |
| `fal-ai/clarity-upscaler` | 2-4x | Detail preservation |
| `fal-ai/creative-upscaler` | 2-4x | Creative enhancement |

## Video Upscale Models

| Model | Notes |
|-------|-------|
| `fal-ai/video-upscaler` | General purpose |
| `fal-ai/topaz/upscale/video` | **Premium quality** |
| `fal-ai/bria/video/increase-resolution` | Fast |
| `fal-ai/flashvsr` | Real-time |
| `fal-ai/seedvr/upscale/video` | High fidelity |
| `fal-ai/bytedance-upscaler` | Good balance |
| `fal-ai/simalabs/sima-video-upscaler-lite` | Lightweight |

## Usage

```bash
bash /mnt/skills/user/fal-upscale/scripts/upscale.sh [options]
```

**Arguments:**
- `--image-url` - URL of image to upscale (required)
- `--model` - Model ID (defaults to `fal-ai/aura-sr`)
- `--scale` - Upscale factor: 2 or 4 (default: 4)

**Examples:**

```bash
# Image upscale with AuraSR (4x, fast)
bash /mnt/skills/user/fal-upscale/scripts/upscale.sh \
  --image-url "https://example.com/image.jpg"

# Image upscale with Clarity (detail preservation)
bash /mnt/skills/user/fal-upscale/scripts/upscale.sh \
  --image-url "https://example.com/image.jpg" \
  --model "fal-ai/clarity-upscaler" \
  --scale 2

# Video upscale (general purpose)
bash /mnt/skills/user/fal-upscale/scripts/upscale.sh \
  --video-url "https://example.com/video.mp4" \
  --model "fal-ai/video-upscaler"

# Video upscale (premium quality)
bash /mnt/skills/user/fal-upscale/scripts/upscale.sh \
  --video-url "https://example.com/video.mp4" \
  --model "fal-ai/topaz/upscale/video"
```

## MCP Tool Alternative

If MCP tools are available, prefer using:
```
mcp__fal-ai__generate({
  modelId: "fal-ai/aura-sr",
  input: {
    image_url: "https://example.com/image.jpg"
  }
})
```

## Output

```
Upscaling with fal-ai/aura-sr...
Upscale complete!

Image URL: https://v3.fal.media/files/abc123/upscaled.png
Original: 512x512
Upscaled: 2048x2048
```

JSON output:
```json
{
  "image": {
    "url": "https://v3.fal.media/files/abc123/upscaled.png",
    "width": 2048,
    "height": 2048
  }
}
```

## Present Results to User

```
Here's your upscaled image:

![Upscaled Image](https://v3.fal.media/files/...)

• 512×512 → 2048×2048 (4x)
```

## Model Selection Guide

**AuraSR** (`fal-ai/aura-sr`)
- Best for: Quick upscaling, general images
- Speed: ~2 seconds
- Fixed 4x scale

**Clarity Upscaler** (`fal-ai/clarity-upscaler`)
- Best for: Preserving fine details

From CraftOS-dev/CraftBot, MIT.

More from CraftOS-dev/CraftBot