Smart Resize
fal-ai/smart-resizeEdit 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
| Field | Kind | 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 ` |
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 ` |
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 ` |
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. |
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.