GET
/v1/schemas/fal/image/topaz/upscale/image/generative
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source tracef7dacf5266756df1334376e3a67420f90d4add103b9452901af272a66416b222{
"fetchedAt": 1793336402,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
18 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| image_url* | string | Url of the image to be upscaled. Wonder 4 supports up to 256 MP input and output. The complete upload request must fit within 500 MB. | length ≥ 1 |
| denoise | number | Denoising level (0.0-1.0). Applies to Redefine model only. | 0 ≤ n ≤ 1 · nullable |
| prompt | string | Text prompt to guide generative upscaling (max 1024 chars). Applies to Redefine model only. | length ≤ 1024 · nullable |
| face_enhancement | boolean | Whether to apply face enhancement to the image. Ignored by Wonder 4, which handles face recovery automatically. | default: true |
| enable_safety_checker | boolean | Authorized callers may set false to request relaxed screening. | default: true |
| upscale_factor | number | Factor to upscale the image by (e.g. 2.0 doubles width and height) | 1 ≤ n ≤ 4 · default: 2 |
| detail | number | Detail recovery level (0.0-1.0). Applies to Recovery V2 model only. | 0 ≤ n ≤ 1 · nullable |
| enhancement_strength | enum | Enhancement strength for generative upscaling. Applies to Wonder 3 and Wonder 3.5 models. When omitted, Topaz auto-configures it. | low | medium | high · nullable |
| autoprompt | boolean | Enable automatic prompt generation for generative upscaling. Applies to Redefine model only. | nullable |
| face_enhancement_strength | number | Strength of the face enhancement. 0.0 means no enhancement, 1.0 means maximum enhancement. Ignored if face enhancement is disabled. | 0 ≤ n ≤ 1 · default: 0.8 |
| sharpen | number | Sharpening level (0.0-1.0). Applies to Redefine model only. | 0 ≤ n ≤ 1 · nullable |
| output_format | enum | Output format of the upscaled image. | jpeg | png · default: "jpeg" |
| creativity | integer | Creativity level for generative upscaling (1-6). Higher values produce more creative/hallucinated details. Applies to Redefine model only. | 1 ≤ n ≤ 6 · nullable |
| crop_to_fill | boolean | default: false | |
| face_enhancement_creativity | number | Creativity level for face enhancement. 0.0 means no creativity, 1.0 means maximum creativity. Ignored if face enhancement is disabled. | 0 ≤ n ≤ 1 · default: 0 |
| model | enum | Generative upscaling model. Wonder 4 automatically enhances and upscales images with no model-specific controls. Wonder 3.5 offers finer detail and fewer repetitive patterns; Wonder 3 is Topaz's most advanced generative realism model (Wonder 2/Wonder are earli… | Wonder 4 | Wonder 3.5 | Wonder 3 | Wonder 2 | Wonder | Recover 3 · +4 more · default: "Wonder 3" |
| subject_detection | enum | Subject detection mode for the image enhancement. Applies to Wonder 3, Recovery and Recovery V2 models. | All | Foreground | Background · default: "All" |
| texture | integer | Texture detail level for generative upscaling (1-5). Applies to Redefine model only. | 1 ≤ n ≤ 5 · nullable |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"topaz/upscale/image/generative","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}