Skip to main content
POST
Upscaler Precision V2 - Upscale image

Authorizations

x-magnific-api-key
string
header
required

Your Magnific API key. Required for authentication. Learn how to obtain an API key

Body

application/json
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
default:7

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.

Required range: 0 <= x <= 100
smart_grain
integer
default:7

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.

Required range: 0 <= x <= 100
ultra_detail
integer
default:30

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.

Required range: 0 <= x <= 100
flavor
enum<string>

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
Available options:
sublime,
photo,
photo_denoiser
scale_factor

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.

Required range: 2 <= x <= 16
filter_nsfw
boolean
default:false

Enable NSFW content filtering on the output image

Response

OK - The task exists and the status is returned

data
object
required
Example: