---
title: "Upscaler Precision V2 - Upscale image"
method: POST
path: "/v1/ai/image-upscaler-precision-v2"
tags: ["upscaler-precision"]
---

# Upscaler Precision V2 - Upscale image

`POST /v1/ai/image-upscaler-precision-v2`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/image-upscaler-precision-v2`
- Auth: API key in header `x-magnific-api-key`

Upscales an image while adding new visual elements or details (V2).
This endpoint may modify the original image content based on the prompt and inferred context.

## Request body

- RequestContent3
  - `image` string, required: Source image to upscale. Accepts either: - A publicly accessible HTTPS URL pointing to the image - A base64-encoded image string This image will be enhanced with AI-powered upscaling technology that intelligently adds details and improves image quality while increasing resolution.
  - `webhook_url` string, uri: Optional callback URL that will receive asynchronous notifications when the upscaling task completes. The webhook will be called with the task status and the upscaled image URL.
  - `sharpen` integer: Image sharpness intensity control. Higher values increase edge definition and clarity in the upscaled image. Valid values range from 0 (no sharpening) to 100 (maximum sharpness). Default is 7.
  - `smart_grain` integer: Intelligent grain/texture enhancement for the upscaled image. Helps preserve natural film grain and texture detail. Higher values add more fine-grained texture to prevent the upscaled image from looking too smooth or artificial. Valid values range from 0 (no grain) to 100 (maximum grain). Default is 7.
  - `ultra_detail` integer: Ultra detail enhancement level for the image upscaling process. This parameter controls how much fine detail the AI adds to the upscaled image, such as textures, patterns, and micro-details. Higher values create more intricate details. Valid values range from 0 to 100. Default is 30.
  - `flavor` 'sublime' | 'photo' | 'photo_denoiser': Image processing flavor that determines the upscaling style and optimization for different image types: - `sublime`: Optimized for artistic and illustrated images with smooth gradients and vibrant colors - `photo`: Optimized for photographic images, preserving natural colors and realistic details - `photo_denoiser`: Specialized for photos with noise reduction, ideal for low-light or grainy photographs
  - `scale_factor` union: Image scaling factor for upscaling. Determines how much larger the output image will be compared to the input. For example, a scale ratio of 2 will double the dimensions (2x width and 2x height, resulting in 4x total pixels). Valid values range from 2 to 16. Can be provided as an integer or string.
    - integer
    - string
  - `filter_nsfw` boolean: Enable NSFW content filtering on the output image

## Response `200`

OK - The task exists and the status is returned

- InlineObject4
  - `data` TaskDetail1, required
    - `task_id` string, uuid, required: Task identifier
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: Task status
    - `generated` string[], required

## Other responses

- `400`: Bad Request - The server could not understand the request due to invalid syntax.
- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)