# Crystal Upscaler

> High-precision image upscaler optimized for portraits, faces and products, powered by Clarity AI with support up to 10K resolution

## Quick Reference

- Model ID: crystal-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

## Model Identifiers

- Primary Slug: crystal-upscaler


## Tags

image-upscaling, super-resolution, portrait-enhancement

## Available Providers

### fal.ai

- Config Key: fal/crystal-upscaler
- Provider Model ID: clarityai/crystal-upscaler
- Pricing: $0.016/megapixel
  - Source: https://fal.ai/models/clarityai/crystal-upscaler

### Replicate

- Config Key: replicate/crystal-upscaler
- Provider Model ID: philz1337x/crystal-upscaler
- Pricing: 
  - Note: Tiered pricing based on output image resolution (megapixels):
  - Note: 0-4.4 MP: $0.05/image, 4.4-8.8 MP: $0.10/image, 8.8-17.6 MP: $0.20/image
  - Note: 17.6-27.5 MP: $0.40/image, 27.5-55 MP: $0.80/image, 55-110 MP: $1.60/image, 110+ MP: $3.20/image
  - Source: https://replicate.com/philz1337x/crystal-upscaler


## Arena Benchmarks

### Feather Fidelity Challenge

- Elo: 1227
- Record: 7W / 1L / 0T (8 battles)
- Rank: #1 of 2

### Weave Warfare

- Elo: 1196
- Record: 8W / 0L / 0T (8 battles)
- Rank: #1 of 4

### Freckle Fortress Challenge

- Elo: 1194
- Record: 7W / 0L / 0T (7 battles)
- Rank: #1 of 2

### Tokaji Text Trials

- Elo: 1170
- Record: 6W / 0L / 0T (6 battles)
- Rank: #1 of 2


## Image Gallery

4 images available for this model. Browse all at https://lumenfall.ai/models/clarity-ai/crystal-upscaler/gallery

### Arena Competition Results

- [Feather Fidelity Challenge](https://assets.lumenfall.ai/RmU-eQd4cwHNHaszxKtXkQTykVskZGQ6syezl98rEbU/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/2qu5y0mqwbfqnkrm5zxin7fary6q@jpeg): #1 of 2 (Elo 1227)
- [Weave Warfare](https://assets.lumenfall.ai/cqk89yKGftNBwrplEi0mNYD6u5ZUSEESE7cquGTHVwg/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/6phwwpnzskj4186v4q6dc41bjdsz@jpeg): #1 of 4 (Elo 1196)
- [Freckle Fortress Challenge](https://assets.lumenfall.ai/z2OdY0nPqtg2u1fvzJwnKlj9JNwEDWmaU7ODOKNCU8k/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/cy97cl61rzr1zanzqvj28n8pei3n@jpeg): #1 of 2 (Elo 1194)
- [Tokaji Text Trials](https://assets.lumenfall.ai/D3yLz-cPrKo5isCQ0NJS8gUKd42uzxzN4NBxa2KSsX8/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/couxaaifiyh6zv4f32ghtkakeb76@jpeg): #1 of 2 (Elo 1170)

## 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=crystal-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: 'crystal-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="crystal-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)


## About

## Overview
Crystal Upscaler is a high-precision super-resolution model developed by Clarity AI, specifically engineered to enhance the fidelity of portraits, facial features, and product photography. It distinguishes itself by supporting output resolutions up to 10K, allowing for significant upscaling factors while maintaining structural integrity. The model is designed to bridge the gap between low-resolution captures and high-definition print or digital display requirements.

## Strengths
*   **Facial Reconstruction:** Excels at restoring micro-details in human faces, such as skin texture, iris definition, and hair strands, without introducing the "uncanny valley" artifacts common in generic upscalers.
*   **High-Scale Factor:** Supports ultra-high resolution outputs up to 10K, making it suitable for billboard-scale printing and large-format digital assets.
*   **Edge Definition in Products:** Maintains sharp, clean lines on product edges and packaging text, preventing the blurring or "bleeding" of colors often seen when blowing up small product shots.
*   **Noise Reduction:** Effectively filters out compression artifacts and sensor noise from the source image while simultaneously synthesizing missing high-frequency details.

## Limitations
*   **Generic Texture Hallucination:** While optimized for specific subjects like faces and products, the model may struggle with complex, non-standard textures like abstract art or dense foliage, where it might hallucinate patterns that weren't in the original.
*   **Compute Requirements:** Due to the 10K resolution ceiling, processing times for maximum-scale outputs are significantly higher than standard 2x or 4x upscalers.
*   **Stylistic Rigidity:** The model prioritizes realism and clarity; it is not intended for artistic style transfer or altering the fundamental composition of the input image.

## Technical Background
Crystal Upscaler is built upon the Clarity AI framework, utilizing a specialized super-resolution architecture that emphasizes local feature refinement. The training regimen focused heavily on high-bitrate photographic datasets, specifically curated to teach the model the relationship between low-resolution pixel grids and high-fidelity skin and material textures. This enables the model to perform predictive detail synthesis rather than simple interpolation.

## Best For
Crystal Upscaler is ideal for photographers needing to rescue "soft" portraits, e-commerce managers preparing product thumbnails for high-resolution displays, and print designers working with legacy assets. It is a reliable choice for any workflow requiring professional-grade clarity for human subjects. 

Crystal Upscaler is available for testing and integration through Lumenfall’s unified API and interactive playground, providing a streamlined way to incorporate 10K upscaling into existing production pipelines.

## Frequently Asked Questions

### How much does Crystal Upscaler cost?

Crystal Upscaler starts at $0.016 per image through Lumenfall. Pricing varies by provider. Lumenfall does not add any markup to provider pricing.

### How do I use Crystal Upscaler via API?

You can use Crystal Upscaler through Lumenfall's OpenAI-compatible API. Send requests to the unified endpoint with model ID "crystal-upscaler". Code examples are available in Python, JavaScript, and cURL.

### Which providers offer Crystal Upscaler?

Crystal Upscaler is available through fal.ai and Replicate on Lumenfall. Lumenfall automatically routes requests to the best available provider.

## Links

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