Image Editing
Clarity Upscaler
Creative "hi-res fix" upscaler — invents detail with a steering prompt.
POST /v2/images/upscale — model: "clarity-upscale"
Clarity Upscaler (philz1337x) is a creative upscaler that hallucinates detail rather than preserving it. Best for AI-generated art, illustrations, and stylised content where you want the model to interpret and refine. Use Topaz Image Upscale instead for realistic photos.
See Image Editing overview for common request fields, response format, and error codes.
Model-specific parameters
| Parameter | Type | Description |
|---|---|---|
clarityUpscaleParams.image | string | Source image URL. |
clarityUpscaleParams.prompt | string | Optional steering prompt — describes the kind of detail to add (max 2,000 chars). |
clarityUpscaleParams.negative_prompt | string | Optional negative prompt (max 2,000 chars). |
clarityUpscaleParams.scale_factor | integer | Output multiplier. Values: 1, 2, 4, 8. |
clarityUpscaleParams.creativity | number | How much new detail Clarity is allowed to invent (0–1). |
clarityUpscaleParams.resemblance | number | How tightly to stick to the input (0–3). |
clarityUpscaleParams.dynamic | number | HDR / dynamic range (1–50). |
clarityUpscaleParams.num_inference_steps | integer | Diffusion steps (1–100). |
clarityUpscaleParams.sharpen | number | Edge-sharpen pass strength (0–10). |
clarityUpscaleParams.output_format | string | Output container. Values: "png", "jpg", "webp". |
clarityUpscaleParams.seed | integer | Reproducibility seed. |
Credit cost
3 credits per generation, regardless of scale factor.
Code examples
curl -X POST https://api.apiframe.ai/v2/images/upscale \
-H "X-API-Key: afk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"model": "clarity-upscale",
"clarityUpscaleParams": {
"image": "https://example.com/illustration.png",
"prompt": "highly detailed, sharp focus, intricate textures",
"scale_factor": 2,
"creativity": 0.35,
"resemblance": 0.6
}
}'import requests
response = requests.post(
"https://api.apiframe.ai/v2/images/upscale",
headers={
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
json={
"model": "clarity-upscale",
"clarityUpscaleParams": {
"image": "https://example.com/illustration.png",
"prompt": "highly detailed, sharp focus, intricate textures",
"scale_factor": 2,
"creativity": 0.35,
"resemblance": 0.6,
},
},
)
print(response.json())const response = await fetch("https://api.apiframe.ai/v2/images/upscale", {
method: "POST",
headers: {
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "clarity-upscale",
clarityUpscaleParams: {
image: "https://example.com/illustration.png",
prompt: "highly detailed, sharp focus, intricate textures",
scale_factor: 2,
creativity: 0.35,
resemblance: 0.6,
},
}),
});
console.log(await response.json());Try it
POST
/v2/images/upscaleTry it