# Topaz > Use the powerful and accurate topaz image enhancer to enhance your images. ## Overview - **Endpoint**: `https://fal.run/fal-ai/topaz/upscale/image` - **Model ID**: `fal-ai/topaz/upscale/image` - **Category**: image-to-image - **Kind**: inference **Tags**: image-to-image ## Pricing For a single image, your request will cost **$0.08** for up to **24MP**, **$0.16** for up to **48MP**, **$0.32** for up to **96MP**, and up to **$1.36** for **512MP** output resolution. For more details, see [fal.ai pricing](https://fal.ai/pricing). ## API Information This model can be used via our HTTP API or more conveniently via our client libraries. See the input and output schema below, as well as the usage examples. ### Input Schema The API accepts the following input parameters: - **`model`** (`ModelEnum`, _optional_): Model to use for image enhancement. Default value: `"Standard V2"` - Default: `"Standard V2"` - Options: `"Low Resolution V2"`, `"Standard V2"`, `"CGI"`, `"High Fidelity V2"`, `"Text Refine"`, `"Recovery"`, `"Redefine"`, `"Recovery V2"`, `"Standard MAX"`, `"Wonder"`, `"Wonder 3"` - **`upscale_factor`** (`float`, _optional_): Factor to upscale the image by (e.g. 2.0 doubles width and height) Default value: `2` - Default: `2` - Range: `1` to `4` - **`crop_to_fill`** (`boolean`, _optional_) - Default: `false` - **`image_url`** (`string`, _required_): Url of the image to be upscaled - Examples: "https://storage.googleapis.com/falserverless/model_tests/codeformer/codeformer_poor_1.jpeg" - **`output_format`** (`OutputFormatEnum`, _optional_): Output format of the upscaled image. Default value: `"jpeg"` - Default: `"jpeg"` - Options: `"jpeg"`, `"png"` - **`subject_detection`** (`SubjectDetectionEnum`, _optional_): Subject detection mode for the image enhancement. Applies to standard enhance and Recovery V2 models. Default value: `"All"` - Default: `"All"` - Options: `"All"`, `"Foreground"`, `"Background"` - **`face_enhancement`** (`boolean`, _optional_): Whether to apply face enhancement to the image. Applies to standard enhance and Recovery V2 models. Default value: `true` - Default: `true` - **`face_enhancement_creativity`** (`float`, _optional_): Creativity level for face enhancement. 0.0 means no creativity, 1.0 means maximum creativity. Ignored if face enhancement is disabled. - Default: `0` - Range: `0` to `1` - **`face_enhancement_strength`** (`float`, _optional_): Strength of the face enhancement. 0.0 means no enhancement, 1.0 means maximum enhancement. Ignored if face enhancement is disabled. Default value: `0.8` - Default: `0.8` - Range: `0` to `1` - **`sharpen`** (`float`, _optional_): Sharpening level (0.0-1.0). Applies to Standard V2, Low Resolution V2, CGI, High Fidelity V2, Text Refine, and Redefine models. - Range: `0` to `1` - **`denoise`** (`float`, _optional_): Denoising level (0.0-1.0). Applies to Standard V2, Low Resolution V2, CGI, High Fidelity V2, Text Refine, and Redefine models. - Range: `0` to `1` - **`fix_compression`** (`float`, _optional_): Compression artifact removal level (0.0-1.0). Applies to Standard V2, Low Resolution V2, High Fidelity V2, and Text Refine models. - Range: `0` to `1` - **`strength`** (`float`, _optional_): Enhancement strength (0.01-1.0). Applies to Text Refine model only. - Range: `0.01` to `1` - **`creativity`** (`integer`, _optional_): Creativity level for generative upscaling (1-6). Higher values produce more creative/hallucinated details. Applies to Redefine model only. - Range: `1` to `6` - **`texture`** (`integer`, _optional_): Texture detail level for generative upscaling (1-5). Applies to Redefine model only. - Range: `1` to `5` - **`prompt`** (`string`, _optional_): Text prompt to guide generative upscaling (max 1024 chars). Applies to Redefine model only. - **`autoprompt`** (`boolean`, _optional_): Enable automatic prompt generation for generative upscaling. Applies to Redefine model only. - **`detail`** (`float`, _optional_): Detail recovery level (0.0-1.0). Applies to Recovery V2 model only. - Range: `0` to `1` - **`enhancement_strength`** (`Enum`, _optional_): Enhancement strength for generative upscaling. Applies to Wonder 3 model only. When omitted, Topaz auto-configures it. - Options: `"low"`, `"medium"`, `"high"` **Required Parameters Example**: ```json { "image_url": "https://storage.googleapis.com/falserverless/model_tests/codeformer/codeformer_poor_1.jpeg" } ``` **Full Example**: ```json { "model": "Standard V2", "upscale_factor": 2, "image_url": "https://storage.googleapis.com/falserverless/model_tests/codeformer/codeformer_poor_1.jpeg", "output_format": "jpeg", "subject_detection": "All", "face_enhancement": true, "face_enhancement_strength": 0.8 } ``` ### Output Schema The API returns the following output format: - **`image`** (`File`, _required_): The upscaled image. **Example Response**: ```json { "image": { "url": "", "content_type": "image/png", "file_name": "z9RV14K95DvU.png", "file_size": 4404019 } } ``` ## Usage Examples ### cURL ```bash curl --request POST \ --url https://fal.run/fal-ai/topaz/upscale/image \ --header "Authorization: Key $FAL_KEY" \ --header "Content-Type: application/json" \ --data '{ "image_url": "https://storage.googleapis.com/falserverless/model_tests/codeformer/codeformer_poor_1.jpeg" }' ``` ### Python Ensure you have the Python client installed: ```bash pip install fal-client ``` Then use the API client to make requests: ```python import fal_client def on_queue_update(update): if isinstance(update, fal_client.InProgress): for log in update.logs: print(log["message"]) result = fal_client.subscribe( "fal-ai/topaz/upscale/image", arguments={ "image_url": "https://storage.googleapis.com/falserverless/model_tests/codeformer/codeformer_poor_1.jpeg" }, with_logs=True, on_queue_update=on_queue_update, ) print(result) ``` ### JavaScript Ensure you have the JavaScript client installed: ```bash npm install --save @fal-ai/client ``` Then use the API client to make requests: ```javascript import { fal } from "@fal-ai/client"; const result = await fal.subscribe("fal-ai/topaz/upscale/image", { input: { image_url: "https://storage.googleapis.com/falserverless/model_tests/codeformer/codeformer_poor_1.jpeg" }, logs: true, onQueueUpdate: (update) => { if (update.status === "IN_PROGRESS") { update.logs.map((log) => log.message).forEach(console.log); } }, }); console.log(result.data); console.log(result.requestId); ``` ## Additional Resources ### Documentation - [Model Playground](https://fal.ai/models/fal-ai/topaz/upscale/image) - [API Documentation](https://fal.ai/models/fal-ai/topaz/upscale/image/api) - [OpenAPI Schema](https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/topaz/upscale/image) ### fal.ai Platform - [Platform Documentation](https://docs.fal.ai) - [Python Client](https://docs.fal.ai/clients/python) - [JavaScript Client](https://docs.fal.ai/clients/javascript)