ControlNet-tile based creative upscaler that adds detail while preserving structure, popular alternative to Magnific
Example outputs coming soon
Details
clarity-upscaler
Starting from
Prices shown are in USD · Some prices estimated from per-megapixel or per-token pricing
See all providersProviders & Pricing (2)
Clarity Upscaler is available from 2 providers, with per-image pricing starting at $0.015 through Replicate.
Output
Pricing Notes (1)
- • Replicate bills by hardware seconds; ~$0.015 per typical run. Pricing varies with input size and inference steps.
Clarity Upscaler API OpenAI-compatible
https://api.lumenfall.ai/openai/v1
clarity-upscaler
Code Examples
Upscale
/v1/images/editscurl -X POST \
https://api.lumenfall.ai/openai/v1/images/edits \
-H "Authorization: Bearer $LUMENFALL_API_KEY" \
-F "model=clarity-upscaler" \
-F "[email protected]" \
-F "prompt=Add a starry night sky to this image" \
-F "size=1024x1024"
# Response:
# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }
import OpenAI from 'openai';
import fs from 'fs';
const client = new OpenAI({
apiKey: 'YOUR_API_KEY',
baseURL: 'https://api.lumenfall.ai/openai/v1'
});
const response = await client.images.edit({
model: 'clarity-upscaler',
image: fs.createReadStream('source.png'),
prompt: 'Add a starry night sky to this image',
size: '1024x1024'
});
// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
console.log(response.data[0].url);
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.lumenfall.ai/openai/v1"
)
response = client.images.edit(
model="clarity-upscaler",
image=open("source.png", "rb"),
prompt="Add a starry night sky to this image",
size="1024x1024"
)
# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
print(response.data[0].url)
Parameter Reference
Media Inputs
| Parameter | Type | Description | Modes |
|---|---|---|---|
image
|
file |
Required.
Input image to upscale
Single image per request.
|
Upscale
|
scale_factor
|
number | Required. Factor by which to upscale the image |
Upscale
|
Output & Format
| Parameter | Type | Description | Modes |
|---|---|---|---|
response_format
|
string |
How to return the image
url
b64_json
Default:
"url" |
Upscale
|
output_format
|
string |
Output image format
png
jpeg
gif
webp
avif
Gateway converts to requested format if provider doesn't support it natively.
|
Upscale
|
output_compression
|
integer | Compression level for lossy formats (JPEG, WebP, AVIF) |
Upscale
|
n
|
integer |
Number of images to generate
Default:
1Gateway generates multiple images in parallel even if provider only supports 1.
|
Upscale
|
Additional Parameters
Provider-specific passthrough fields, available only when the request is routed to the listed provider.
| Parameter | Type | Description | Modes |
|---|---|---|---|
|
Universal
|
|||
creativity
|
number | Creativity level for generation (0-1) |
Upscale
|
resemblance
|
number | How closely the result resembles the input (0-3) |
Upscale
|
|
fal
|
|||
enable_safety_checker
|
boolean | Enable safety checking |
Upscale
|
num_inference_steps
|
integer | Number of inference steps |
Upscale
|
Parameter Normalization
How we handle parameters across different providers
Not every provider speaks the same language. When you send a parameter, we handle it in one of four ways depending on what the model supports:
| Behavior | What happens | Example |
|---|---|---|
passthrough |
Sent as-is to the provider | style, quality |
renamed |
Same value, mapped to the field name the provider expects | prompt |
converted |
Transformed to the provider's native format | size |
emulated |
Works even if the provider has no concept of it | n, response_format |
Parameters we don't recognize pass straight through to the upstream API, so provider-specific options still work.
Clarity Upscaler FAQ
How much does Clarity Upscaler cost?
Clarity Upscaler starts at $0.015 per image through Lumenfall. Pricing varies by provider. Lumenfall does not add any markup to provider pricing.
How do I use Clarity Upscaler via API?
You can use Clarity Upscaler through Lumenfall's OpenAI-compatible API. Send requests to the unified endpoint with model ID "clarity-upscaler". Code examples are available in Python, JavaScript, and cURL.
Which providers offer Clarity Upscaler?
Clarity Upscaler is available through Replicate and fal.ai on Lumenfall. Lumenfall automatically routes requests to the best available provider.
Try Clarity Upscaler in Playground
Generate images with custom prompts — no API key needed.