Skip to main content
POST
/
v1
/
ai
/
image-upscaler-precision-v2
Upscale with precision an image with Magnific V2
curl --request POST \
  --url https://api.freepik.com/v1/ai/image-upscaler-precision-v2 \
  --header 'Content-Type: application/json' \
  --header 'x-freepik-api-key: <api-key>' \
  --data '{
  "image": "<string>",
  "webhook_url": "<string>",
  "sharpen": 7,
  "smart_grain": 7,
  "ultra_detail": 30,
  "flavor": "sublime",
  "scale_factor": 9
}'
{
  "data": {
    "generated": [],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "status": "CREATED"
  }
}

Authorizations

​
x-freepik-api-key
string
header
required

Your Freepik 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

Response

OK - The task exists and the status is returned

​
data
object
required
Example:
{
  "generated": [
    "https://openapi-generator.tech",
    "https://openapi-generator.tech"
  ],
  "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "status": "CREATED"
}