# Smart Resize

Edit and enhance images with Smart Resize from fal through one Spiral API key. It runs in the background and returns images. Pay as you go, with no subscription.

- Provider: fal
- Category: Image
- Runs: In the background
- Returns: image
- Tool id: `fal` / `fal-ai/smart-resize`
- Page: https://spiral.ai/tools/fal/fal-ai/smart-resize

## Pricing

Up to $0.26 per run at the default inputs. `resolution`: 1K (default) $0.26, 2K $0.26, 4K $0.52. Each item in `target_sizes` adds $0.195. $0.195 per unit of `num_images_per_size`.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 30 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `image_url` (required) | URL or file |  | — | The URL of the source image to resize. |
| `target_sizes` (required) | list |  | — | The list of target dimensions to generate, each written as ``<width>x<height>`` (e.g. ``"1920x1080"``). One output image is produced per target size (multiplied by ``num_images_per_size``). The endpoint internally picks the smallest nano-banana-pro preset that fully covers each target so the final image is a pixel-perfect match with no upscaling. |
| `prompt` | text |  |  | Optional extra instruction that is forwarded to nano-banana-pro alongside the auto-generated resize prompt. Leave empty to let the model preserve the original image content as closely as possible. |
| `num_images_per_size` | number (whole) | 1 to 4 | 1 | The number of nano-banana-pro variants to produce for each target size. The response images list will contain ``len(target_sizes) * num_images_per_size`` images in total. |
| `resolution` | one of | 1K, 2K, 4K | 1K | Hint for the minimum resolution tier to use internally. The smart-resize algorithm may pick a higher tier automatically when the requested target size is too large for this tier. This field does not affect the final output dimensions — those come from ``target_sizes``. |
| `output_format` | one of | jpeg, png, webp | png | The output image format. |
| `safety_tolerance` | one of | 1, 2, 3, 4, 5, 6 | 4 | The safety tolerance level applied to the inner nano-banana-pro /edit calls. Higher numbers loosen safety filtering. |
| `seed` | number (whole) |  | — | Optional random seed forwarded to the inner nano-banana-pro /edit calls for reproducibility. The same seed is used for every target size when set. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/smart-resize",
    "input": {
      "image_url": "https://storage.googleapis.com/falserverless/example_inputs/nano-banana-edit-input.png",
      "target_sizes": [
        "<target_sizes>"
      ]
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=fal&model=fal-ai%2Fsmart-resize

## Common questions

### Smart Resize

**How much does Smart Resize cost?**

Up to $0.26 per run at the default inputs. `resolution`: 1K (default) $0.26, 2K $0.26, 4K $0.52. Each item in `target_sizes` adds $0.195. $0.195 per unit of `num_images_per_size`. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Smart Resize through an API?**

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/smart-resize"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with fal to use Smart Resize?**

No. Spiral runs it on its own fal account and charges your Spiral balance.

**Can my AI agent use Smart Resize?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

