ClarityMediumUltra

Clarity Upscaler

The famous creative upscaler (30M+ runs). Instead of just enlarging, it re-imagines detail while upscaling — with controllable creativity, resemblance, prompt guidance, and tiled diffusion for high scale factors.

60 credits

per generation

Creative detail re-imagination while upscaling

Creativity and resemblance dials

Prompt-guided enhancement

Tiled diffusion for large outputs

Optional hand fix and sharpening

Run it right now

Test this model instantly in the Console Playground — no code required

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "philz1337x/clarity-upscaler",
  "input": {
    "image": "https://example.com/ai-art.png",
    "scale_factor": 2,
    "creativity": 0.35,
    "resemblance": 0.6
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`prompt`	string	No	masterpiece, best quality, highres, <lora:more_details:0.5> <lora:SDXLrender_v2.0:1>	Guidance prompt (default 'masterpiece, best quality, highres')
`image`	string	Yes	-	Input image to upscale
`negative_prompt`	string	No	(worst quality, low quality, normal quality:2) JuggernautNegative-neg	Negative Prompt
`scale_factor`	number	No	2	Upscale factor (higher factors take longer)
`dynamic`	number	No	6	HDR intensity (1-50)
`creativity`	number	No	0.35	How much new detail is invented (0-1). Higher deviates more from the original
`resemblance`	number	No	0.6	How closely to follow the original (0-3)
`tiling_width`	integer	No	112	Fractality, set lower tile width for a high Fractality 163248648096112128144160176192208224240256
`tiling_height`	integer	No	144	Fractality, set lower tile height for a high Fractality 163248648096112128144160176192208224240256
`sd_model`	string	No	juggernaut_reborn.safetensors [338b85bc4f]	Stable Diffusion model checkpoint epicrealism_naturalSinRC1VAE.safetensors [84d76a0328]juggernaut_reborn.safetensors [338b85bc4f]flat2DAnimerge_v45Sharp.safetensors
`scheduler`	string	No	DPM++ 3M SDE Karras	scheduler DPM++ 2M KarrasDPM++ SDE KarrasDPM++ 2M SDE ExponentialDPM++ 2M SDE KarrasEuler aEulerLMSHeunDPM2DPM2 aDPM++ 2S aDPM++ 2MDPM++ SDEDPM++ 2M SDEDPM++ 2M SDE HeunDPM++ 2M SDE Heun KarrasDPM++ 2M SDE Heun ExponentialDPM++ 3M SDEDPM++ 3M SDE KarrasDPM++ 3M SDE ExponentialDPM fastDPM adaptiveLMS KarrasDPM2 KarrasDPM2 a KarrasDPM++ 2S a KarrasRestartDDIMPLMSUniPC
`num_inference_steps`	integer	No	18	Number of denoising steps
`seed`	integer	No	1337	Random seed for reproducible results
`downscaling`	boolean	No	false	Downscale the image before upscaling. Can improve quality and speed for images with high resolution but lower quality
`downscaling_resolution`	integer	No	768	Downscaling resolution
`lora_links`	string	No	-	Link to a lora file you want to use in your upscaling. Multiple links possible, seperated by comma
`custom_sd_model`	string	No	-	custom_sd_model
`sharpen`	number	No	0	Sharpening amount (0-10)
`mask`	string	No	-	Mask image to mark areas that should be preserved during upscaling
`handfix`	string	No	disabled	Fix distorted hands ('disabled', 'hands_only', 'image_and_hands') disabledhands_onlyimage_and_hands
`pattern`	boolean	No	false	Upscale a pattern with seamless tiling
`output_format`	string	No	png	Format of the output images webpjpgpng

How to Provide File Input

There are 3 ways to provide files for the image parameter:

Recommended

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step needed.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=philz1337x/clarity-upscaler" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:image=@your_file.png"

Image URL

Pass a publicly accessible URL directly. You can also use file_url from the Storage API.

{
  "model": "philz1337x/clarity-upscaler",
  "input": {
    "prompt": "your prompt here",
    "image": "https://example.com/image.jpg"
  }
}

See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Print-Quality Art Upscale

2x upscale with moderate creative detail

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "philz1337x/clarity-upscaler",
  "input": {
    "image": "https://example.com/ai-art.png",
    "scale_factor": 2,
    "creativity": 0.35,
    "resemblance": 0.6
  }
}'