Clarity AI

Clarity Upscaler

Name: Clarity Upscaler
Brand: Clarity AI
Price: 0.015 USD
Availability: InStock

AI Image Editing Model

Image

ControlNet-tile based creative upscaler that adds detail while preserving structure, popular alternative to Magnific

Clarity Upscaler API OpenAI-compatible

Base URL

https://api.lumenfall.ai/openai/v1

Model

clarity-upscaler

/v1/images/edits

curl -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)

Required Supported Not available

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

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: `1` Gateway generates multiple images in parallel even if provider only supports 1.	Upscale

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

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.