---
title: "Upscale an image with Magnific"
method: POST
path: "/proxy/freepik/v1/ai/image-upscaler"
tags: ["Freepik", "Proxy"]
---

# Upscale an image with Magnific

`POST /proxy/freepik/v1/ai/image-upscaler`

This asynchronous endpoint enables image upscaling using advanced AI algorithms.
Upon submission, it returns a unique task_id which can be used to track the progress.
For real-time production use, include the optional webhook_url parameter to receive
an automated notification once the task has been completed.

## Request body

- FreepikMagnificUpscalerCreativeRequest
  - `creativity` integer — Increase or decrease AI's creativity. Valid values range [-10, 10].
  - `engine` 'automatic' | 'magnific_illusio' | 'magnific_sharpy' | 'magnific_sparkle' — Magnific model engines.
  - `fractality` integer — Control the strength of the prompt and intricacy per square pixel. Valid values range [-10, 10].
  - `hdr` integer — Increase or decrease the level of definition and detail. Valid values range [-10, 10].
  - `image` string, required — Base64 image or URL to upscale. The resulted image can't exceed maximum allowed size of 25.3 million pixels.
  - `optimized_for` 'standard' | 'soft_portraits' | 'hard_portraits' | 'art_n_illustration' | 'videogame_assets' | 'nature_n_landscapes' | 'films_n_photography' | '3d_renders' | 'science_fiction_n_horror' — Styles to optimize the upscale process.
  - `prompt` string — Prompt to guide the upscale process. Reusing the same prompt for AI-generated images will improve the results.
  - `resemblance` integer — Adjust the level of resemblance to the original image. Valid values range [-10, 10].
  - `scale_factor` '2x' | '4x' | '8x' | '16x' — Configure scale factor of the image. For higher scales, the image will take longer to process.
  - `webhook_url` string, uri — Optional callback URL that will receive asynchronous notifications whenever the task changes status.

## Response `200`

OK - The upscaling process has started

- FreepikTaskResponse
  - `data` FreepikTaskData, required
    - `generated` string[] — URLs to the generated images.
    - `status` 'CREATED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED'
    - `task_id` string, uuid

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.dev/ac/apis/comfy-api.md) · [All operations](https://skmtc.dev/ac/apis/comfy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ac/comfy-api/revisions/c1893dffe250/schema)