# Clarity Upscaler

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

## Quick Reference

- Model ID: clarity-upscaler
- Creator: Clarity AI
- Status: active
- Base URL: https://api.lumenfall.ai/openai/v1

## Specifications

- Max Input Images: 1
- Input Modalities: image
- Output Modalities: image
- Supported Modes: Upscale

## API Parameters

The compiled parameter schema for this model is available via the API: `GET /v1/models/clarity-upscaler?schema=true`.

### Media Inputs

- `image` (file) — REQUIRED: Input image to upscale
- `scale_factor` (number) — REQUIRED: Factor by which to upscale the image

### Output & Format

- `response_format` (string): How to return the image. Default: url. Values: url, b64_json
- `output_format` (string): Output image format. Values: png, jpeg, gif, webp, avif
- `output_compression` (integer): Compression level for lossy formats (JPEG, WebP, AVIF)
- `n` (integer): Number of images to generate. Default: 1

### Additional Parameters

- `creativity` (number): Creativity level for generation (0-1)
- `enable_safety_checker` (boolean): Enable safety checking. Only available via fal
- `num_inference_steps` (integer): Number of inference steps. Only available via fal
- `resemblance` (number): How closely the result resembles the input (0-3)


## Model Identifiers

- Primary Slug: clarity-upscaler

## Dates

- Released: March 2024

## Tags

image-upscaling, super-resolution, image-enhancement, creative-control

## Available Providers

### Replicate

- Config Key: replicate/clarity-upscaler
- Provider Model ID: philz1337x/clarity-upscaler
- Pricing: $0.015/image
  - Note: Replicate bills by hardware seconds; ~$0.015 per typical run. Pricing varies with input size and inference steps.
  - Source: https://replicate.com/philz1337x/clarity-upscaler

### fal.ai

- Config Key: fal/clarity-upscaler
- Provider Model ID: fal-ai/clarity-upscaler
- Pricing: $0.030/megapixel
  - Source: https://fal.ai/models/fal-ai/clarity-upscaler


## Code Examples

### Upscale (/v1/images/edits)

#### cURL

curl -X POST \
  https://api.lumenfall.ai/openai/v1/images/edits \
  -H "Authorization: Bearer $LUMENFALL_API_KEY" \
  -F "model=clarity-upscaler" \
  -F "image=@source.png" \
  -F "prompt=Add a starry night sky to this image" \
  -F "size=1024x1024"

# Response:
# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }

#### JavaScript

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

#### Python

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)


## Frequently Asked Questions

### 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.

## Links

- Model Page: https://lumenfall.ai/models/clarity-ai/clarity-upscaler
- About: https://lumenfall.ai/models/clarity-ai/clarity-upscaler/about
- Providers, Pricing & Performance: https://lumenfall.ai/models/clarity-ai/clarity-upscaler/providers
- API Reference: https://lumenfall.ai/models/clarity-ai/clarity-upscaler/api
- Benchmarks: https://lumenfall.ai/models/clarity-ai/clarity-upscaler/benchmarks
- Use Cases: https://lumenfall.ai/models/clarity-ai/clarity-upscaler/use-cases
- Playground: https://lumenfall.ai/playground?model=clarity-upscaler
- API Documentation: https://docs.lumenfall.ai