Clarity Upscaler
fal-ai/clarity-upscalerEdit and enhance images with Clarity Upscaler from fal through one Spiral API key. It runs in the background and returns images. Pay as you go, with no subscription.
Pricing
Up to $0.039 per run at the default inputs.
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 image to upscale. |
prompt | text | masterpiece, best quality, highres | The prompt to use for generating the image. Be as descriptive as possible for best results. |
upscale_factor | number 1 to 4 | 2 | The upscale factor |
negative_prompt | text | (worst quality, low quality, normal quality:2) | The negative prompt to use. Use it to address details that you don't want in the image. |
creativity | number 0 to 1 | 0.35 | The creativity of the model. The higher the creativity, the more the model will deviate from the prompt. Refers to the denoise strength of the sampling. |
resemblance | number 0 to 1 | 0.6 | The resemblance of the upscaled image to the original image. The higher the resemblance, the more the model will try to keep the original image. Refers to the strength of the ControlNet. |
guidance_scale | number 0 to 20 | 4 | The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. |
num_inference_steps | number (whole) 4 to 50 | 18 | The number of inference steps to perform. |
seed | number (whole) 0 to … | — | The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time. |
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/clarity-upscaler",
"input": {
"image_url": "https://storage.googleapis.com/falserverless/gallery/NOCA_Mick-Thompson.resized.resized.jpg"
}
}'Frequently asked questions
How much does Clarity Upscaler cost?
Up to $0.039 per run at the default inputs. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use Clarity Upscaler through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/clarity-upscaler"` 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 Clarity Upscaler?
No. Spiral runs it on its own fal account and charges your Spiral balance.
Can my AI agent use Clarity Upscaler?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.