Spiral gives your agent every tool with one account. Browse the tools →

falImageAvailable now

Smart Resize

fal-ai/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.

Pricing

resolution: 1K (default) $0.065 per run plus $0.195 per image, 2K $0.065 per run plus $0.195 per image, 4K $0.13 per run plus $0.39 per image. Billed on num_images_per_size, default 1.

Limits

Runs
In the background
Returns
image
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

FieldKindDefaultDescription
image_url requiredURL or file—

The URL of the source image to resize.

target_sizes requiredlist—

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.

prompttext

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_sizenumber (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.

resolutionone 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_formatone of
jpeg, png, webp
png

The output image format.

safety_toleranceone 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.

seednumber (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.

Same request in code

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>"
      ]
    }
  }'

Frequently asked questions

How much does Smart Resize cost?

`resolution`: 1K (default) $0.065 per run plus $0.195 per image, 2K $0.065 per run plus $0.195 per image, 4K $0.13 per run plus $0.39 per image. Billed on `num_images_per_size`, default 1. 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.