falImage to imageAvailable now
faltopaz/upscale/image/generative
topaz/upscale/image/generative is an image to image tool from fal that runs in the background and returns images. Pay as you go from $0.104 per block, with one API key.
Try itfrom $0.104 / block
Pricing
$0.104 per started 8 megapixels of output with model Wonder 3 or Wonder 3.5, and per started 4 megapixels with other models. Output is the input size × upscale_factor squared. The final charge comes from usage.
Limits
- Runs
- In the background
- Returns
- image
- Longest queue wait
- 3600s
- Run deadline
- 1800s
- Largest inline input
- 1024 KB
- Largest input file
- 500 MB
- Largest output
- 4768 MB
- Outputs per run
- 16
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"
}
}'