> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magnific.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upscaler Precision V2 – AI Image Upscaling API

> Upscale images with Precision V2. Advanced detail enhancement with sharpen, smart grain, and ultra detail controls. Scale 2x to 16x with photo and illustration flavors.

<Frame>
  <video autoPlay muted loop playsInline controls className="w-full aspect-video" width="800">
    <source src="https://media.magnific.com/images/ai/image-upscaler/hero/hero.webm" type="video/webm" />

    Your browser does not support the video tag.
  </video>
</Frame>

<Card title="Magnific API uses Magnific.ai technology, now available as a comprehensive API service." icon="arrow-up-right-dots">
  Precision V2 delivers enhanced upscaling with fine-grained controls for sharpness, texture, and detail while preserving image fidelity.
</Card>

Upscaler Precision V2 is an advanced image upscaling API that enhances resolution while intelligently adding details and improving image quality. Building on the original Precision upscaler, V2 introduces granular control over sharpness, grain texture, and ultra-fine detail enhancement. The API supports multiple image types through specialized processing flavors optimized for photos, illustrations, and noisy images. Looking for creative, prompt-guided upscaling? See <a href="/api-reference/image-upscaler-creative/image-upscaler">Upscaler Creative</a>.

### Key capabilities

* **Scale factors 2x to 16x**: Multiply image dimensions from 2x up to 16x (up to 256x total pixels)
* **Sharpen control**: Adjustable sharpening intensity (0-100, default 7) for edge definition and clarity
* **Smart grain**: Intelligent texture enhancement (0-100, default 7) to preserve natural film grain and prevent artificial smoothness
* **Ultra detail**: Fine detail enhancement level (0-100, default 30) for textures, patterns, and micro-details
* **Processing flavors**: Three optimized modes: `sublime` for illustrations, `photo` for photographs, `photo_denoiser` for noisy images
* **Async processing**: Webhook notifications or polling for task completion
* **Flexible input**: Accepts HTTPS URLs or base64-encoded images

### Use cases

* **E-commerce**: Upscale product photos with enhanced sharpness while preserving color accuracy and texture
* **Photography restoration**: Enhance old photos with smart grain to maintain natural film characteristics
* **Print production**: Scale digital images for large-format printing with ultra detail for crisp output
* **Illustration enhancement**: Upscale digital art with the sublime flavor for smooth gradients and vibrant colors
* **Real estate**: Enhance property photos with the photo flavor for realistic detail preservation
* **Archival digitization**: Restore scanned documents and photos with noise reduction via photo\_denoiser

### Upscale images with Precision V2

Create an upscaling task by submitting a request to the API. The service returns a task ID for async polling or webhook notification.

<div className="my-11">
  <Columns cols={2}>
    <Card title="POST /v1/ai/image-upscaler-precision-v2" icon="arrow-up-right-dots" href="/api-reference/image-upscaler-precision-v2/post-image-upscaler-precision-v2">
      Create a new image upscaling task
    </Card>

    <Card title="GET /v1/ai/image-upscaler-precision-v2" icon="list" href="/api-reference/image-upscaler-precision-v2/get-image-upscaler-precision-v2">
      List all Precision V2 tasks
    </Card>

    <Card title="GET /v1/ai/image-upscaler-precision-v2/{task-id}" icon="magnifying-glass" href="/api-reference/image-upscaler-precision-v2/get-{task-id}-by-id">
      Get task status and results by ID
    </Card>
  </Columns>
</div>

### Parameters

| Parameter      | Type                  | Required | Default | Description                                                               |
| -------------- | --------------------- | -------- | ------- | ------------------------------------------------------------------------- |
| `image`        | `string`              | Yes      | -       | Source image as HTTPS URL or base64-encoded string                        |
| `scale_factor` | `integer` or `string` | No       | -       | Scaling multiplier: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, or 16 |
| `sharpen`      | `integer`             | No       | `7`     | Sharpness intensity (0-100). Higher values increase edge definition       |
| `smart_grain`  | `integer`             | No       | `7`     | Grain/texture enhancement (0-100). Preserves natural film grain           |
| `ultra_detail` | `integer`             | No       | `30`    | Fine detail level (0-100). Controls textures and micro-details            |
| `flavor`       | `string`              | No       | -       | Processing mode: `sublime`, `photo`, or `photo_denoiser`                  |
| `webhook_url`  | `string`              | No       | -       | URL for completion notification with task status and output URL           |

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="What is Upscaler Precision V2 and how does it work?">
    Upscaler Precision V2 is an AI-powered image upscaling API that increases image resolution while intelligently enhancing details. You submit an image via URL or base64, receive a task ID, then poll for results or receive a webhook notification when processing completes. The API adds fine details based on the content type and your parameter settings.
  </Accordion>

  <Accordion title="What is the difference between Precision V2 and Precision V1?">
    Precision V2 introduces granular control parameters that V1 does not have: sharpen (edge definition), smart\_grain (texture preservation), and ultra\_detail (micro-detail enhancement). V2 also supports processing flavors optimized for different image types. Use V2 when you need fine-tuned control over the upscaling output.
  </Accordion>

  <Accordion title="What are the processing flavors and when should I use each?">
    The three flavors are: **sublime** for artistic and illustrated images with smooth gradients and vibrant colors; **photo** for photographic images preserving natural colors and realistic details; **photo\_denoiser** for photos with noise reduction, ideal for low-light or grainy photographs. Choose based on your source image type.
  </Accordion>

  <Accordion title="How do sharpen, smart_grain, and ultra_detail affect results?">
    **Sharpen** (default 7) controls edge clarity and definition. **Smart grain** (default 7) adds natural texture to prevent artificial smoothness. **Ultra detail** (default 30) enhances fine patterns and micro-details. All range from 0-100. Start with defaults and adjust based on your specific image needs.
  </Accordion>

  <Accordion title="What scale factors are supported?">
    Precision V2 supports scale factors from 2 to 16. A scale factor of 2 doubles dimensions (4x total pixels), while 16 increases dimensions 16-fold (256x total pixels). Higher scale factors increase processing time and output file size.
  </Accordion>

  <Accordion title="What are the rate limits for Upscaler Precision V2?">
    Rate limits vary by subscription tier. See the <a href="/ratelimits">Rate Limits</a> page for current limits by plan.
  </Accordion>

  <Accordion title="How much does Upscaler Precision V2 cost?">
    Pricing is based on output image area in pixels, determined by input dimensions and scale factor. See the <a href="/pricing">Pricing</a> page for current rates and subscription options.
  </Accordion>

  <Accordion title="What is the difference between Precision V2 and Upscaler Creative?">
    **Precision V2** focuses on faithful upscaling with controlled detail enhancement, preserving the original content while adding sharpness and texture. **Creative** uses prompts to introduce or infer new visual elements and stylization. Choose Precision V2 when fidelity matters; choose Creative when you want artistic enhancement.
  </Accordion>
</AccordionGroup>

## Best practices

* **Input quality**: Start from the highest-quality source available. Avoid heavily compressed images as artifacts may be amplified
* **Flavor selection**: Use `sublime` for illustrations and digital art, `photo` for natural photographs, `photo_denoiser` for noisy or low-light images
* **Parameter tuning**: Start with default values (sharpen: 7, smart\_grain: 7, ultra\_detail: 30) and adjust incrementally based on results
* **Scale factor**: Begin with 2x-4x for most use cases. Higher factors (8x-16x) work best with high-quality source images
* **Grain for realism**: Increase smart\_grain for photographic images to avoid the "plastic" look common in AI upscaling
* **Production integration**: Use webhooks instead of polling for scalable, event-driven applications
* **Error handling**: Implement retry logic with exponential backoff for 503 errors during high traffic

## Related APIs

* **[Upscaler Creative](/api-reference/image-upscaler-creative/image-upscaler)**: Prompt-guided upscaling with creative detail generation and stylization
* **[Upscaler Precision](/api-reference/image-upscaler-precision/image-upscaler)**: Original precision upscaler without V2's granular controls