Topaz Upscale · Generative Image Upscaling
topaz/upscale/image/generativeEdit and enhance images with Topaz Upscale · Generative Image Upscaling from fal through one Spiral API key. Upscales an image up to 4x with Topaz generative models such as Wonder and Redefine, which add fresh detail and can enhance faces. It runs in the background and returns images. Pay as you go, with no subscription.
Pricing
$0.104 per started 8 megapixels of output with Wonder 3 or 3.5 (per started 4 megapixels with other models). Output is the input size × the upscale factor squared.
Limits
- Runs
- In the background
- Returns
- image
- Longest queue wait
- 1 hour
- Run deadline
- 30 minutes
- Longest run, end to end
- 4 hours
- 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 | — | Url of the image to be upscaled |
model | one of Wonder 3.5, Wonder 3, Wonder 2, Wonder, Recover 3, Standard MAX, Redefine, Recovery V2, Recovery | Wonder 3 | Generative upscaling model. Wonder 3.5 is the latest Wonder with finer detail and fewer repetitive patterns; Wonder 3 is Topaz's most advanced generative realism model (Wonder 2/Wonder are earlier generations); Recover 3 rebuilds natural detail; Standard MAX is high-quality precision-leaning upscaling; Redefine adds prompt-guided creative detail; Recovery and Recovery V2 rebuild extreme low-resolution images. |
upscale_factor | number 1 to 4 | 2 | Factor to upscale the image by (e.g. 2.0 doubles width and height) |
crop_to_fill | true or false | false | |
output_format | one of jpeg, png | jpeg | Output format of the upscaled image. |
subject_detection | one of All, Foreground, Background | All | Subject detection mode for the image enhancement. Applies to Wonder 3, Recovery and Recovery V2 models. |
face_enhancement | true or false | true | Whether to apply face enhancement to the image. |
face_enhancement_creativity | number 0 to 1 | 0 | Creativity level for face enhancement. 0.0 means no creativity, 1.0 means maximum creativity. Ignored if face enhancement is disabled. |
face_enhancement_strength | number 0 to 1 | 0.8 | Strength of the face enhancement. 0.0 means no enhancement, 1.0 means maximum enhancement. Ignored if face enhancement is disabled. |
enhancement_strength | one of low, medium, high | — | Enhancement strength for generative upscaling. Applies to Wonder 3 and Wonder 3.5 models. When omitted, Topaz auto-configures it. |
creativity | number (whole) 1 to 6 | — | Creativity level for generative upscaling (1-6). Higher values produce more creative/hallucinated details. Applies to Redefine model only. |
texture | number (whole) 1 to 5 | — | Texture detail level for generative upscaling (1-5). Applies to Redefine model only. |
prompt | text | — | Text prompt to guide generative upscaling (max 1024 chars). Applies to Redefine model only. |
autoprompt | true or false | — | Enable automatic prompt generation for generative upscaling. Applies to Redefine model only. |
sharpen | number 0 to 1 | — | Sharpening level (0.0-1.0). Applies to Redefine model only. |
denoise | number 0 to 1 | — | Denoising level (0.0-1.0). Applies to Redefine model only. |
detail | number 0 to 1 | — | Detail recovery level (0.0-1.0). Applies to Recovery V2 model only. |
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": "topaz/upscale/image/generative",
"input": {
"image_url": "https://storage.googleapis.com/falserverless/model_tests/codeformer/codeformer_poor_1.jpeg"
}
}'Frequently asked questions
How much does Topaz Upscale · Generative Image Upscaling cost?
$0.104 per started 8 megapixels of output with Wonder 3 or 3.5 (per started 4 megapixels with other models). Output is the input size × the upscale factor squared. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use Topaz Upscale · Generative Image Upscaling through an API?
Send `POST /v1/runs` with `"provider": "fal"`, `"model": "topaz/upscale/image/generative"` 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 Topaz Upscale · Generative Image Upscaling?
No. Spiral runs it on its own fal account and charges your Spiral balance.
Can my AI agent use Topaz Upscale · Generative Image Upscaling?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.