Introduction

A practical guide to using the Crystal Upscaler model in our Media Generator: options, costs by output size, and best practices.

Crystal Upscaler (philz1337x/crystal-upscaler) is a high-precision image upscaler that increases resolution while preserving detail. In our platform, it supports:

• Upscaling — Enlarge images with high fidelity
• Megapixel-based pricing — Cost depends on output resolution
• Reference image required — Upscales your input image
• PNG/JPG output — Quality-preserving formats

Use it when you need to upscale product photos, artwork, or screenshots for print or high-resolution display.

Where to Use Crystal Upscaler

| Location | How | |----------|-----| | Media Generator | Tools → Media Generator → Create Job → choose "Crystal Upscaler" → upload a reference image to upscale | | Image projects | Create a project with reference images and select Crystal Upscaler |

Requirements

• Reference image required — One input image to upscale
• Output aspect ratio follows the input (matchinputimage)

Platform Options

Aspect ratio

• matchinputimage only — Output keeps the input image’s aspect ratio

Output format

• PNG — Lossless
• JPG — Smaller file size

Default:

• PNG

Reference images

• Required — Exactly one image to upscale
• The model upscales this image; no multiple-reference blending

Costs (credits)

Crystal Upscaler uses megapixel-tier pricing — cost depends on the output resolution (megapixels):

| Output size (megapixels) | USD | Credits | |--------------------------|-----|----------| | Up to 8 MP | $0.10 | 0.25 | | Up to 16 MP | $0.20 | 0.50 | | Up to 25 MP | $0.40 | 1.00 |

\Credits computed with default billing config. Check the model selector in the UI for current rates.

Typical megapixels:

• 8 MP ≈ 3264×2448 or similar
• 16 MP ≈ 4608×3456 or similar
• 25 MP ≈ 5760×4320 or similar

The platform determines the tier from your input image size and scale factor.

Prompt guidelines

• Crystal Upscaler focuses on preserving and enhancing detail; the prompt can describe desired quality (e.g., “maintain sharp edges,” “minimal artifacts”).
• The main input is the image to upscale, not the text prompt.

Good practices

1. Use high-quality input — Sharp source images upscale better.
2. Know your output size — Larger outputs cost more credits.
3. Choose PNG for quality — When detail matters most.
4. Avoid tiny inputs — Very small images may not upscale well.

Limits and constraints

| Constraint | Value | |------------|-------| | Reference images | Required, 1 per generation | | Max images per request | 5 | | Aspect ratio | matchinputimage only |

Troubleshooting

| Issue | What to try | |-------|-------------| | Missing reference warning | Upload an image to upscale | | Higher cost than expected | Output may fall into a higher megapixel tier | | Artifacts or blur | Ensure input is sharp; try a smaller target size | | Model not available | Confirm Replicate API token is configured |