Skip to main content
POST
/
proxy
/
freepik
/
v1
/
ai
/
image-upscaler
Upscale an image with Magnific
curl --request POST \
  --url https://api.comfy.org/proxy/freepik/v1/ai/image-upscaler \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "image": "<string>",
  "creativity": 0,
  "engine": "automatic",
  "fractality": 0,
  "hdr": 0,
  "optimized_for": "standard",
  "prompt": "<string>",
  "resemblance": 0,
  "scale_factor": "2x",
  "webhook_url": "https://www.example.com/webhook"
}
'
{
  "data": {
    "generated": [
      "<string>"
    ],
    "status": "CREATED",
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
image
string
required

Base64 image or URL to upscale. The resulted image can't exceed maximum allowed size of 25.3 million pixels.

​
creativity
integer
default:0

Increase or decrease AI's creativity. Valid values range [-10, 10].

Required range: -10 <= x <= 10
​
engine
enum<string>
default:automatic

Magnific model engines.

Available options:
automatic,
magnific_illusio,
magnific_sharpy,
magnific_sparkle
​
fractality
integer
default:0

Control the strength of the prompt and intricacy per square pixel. Valid values range [-10, 10].

Required range: -10 <= x <= 10
​
hdr
integer
default:0

Increase or decrease the level of definition and detail. Valid values range [-10, 10].

Required range: -10 <= x <= 10
​
optimized_for
enum<string>
default:standard

Styles to optimize the upscale process.

Available options:
standard,
soft_portraits,
hard_portraits,
art_n_illustration,
videogame_assets,
nature_n_landscapes,
films_n_photography,
3d_renders,
science_fiction_n_horror
​
prompt
string

Prompt to guide the upscale process. Reusing the same prompt for AI-generated images will improve the results.

​
resemblance
integer
default:0

Adjust the level of resemblance to the original image. Valid values range [-10, 10].

Required range: -10 <= x <= 10
​
scale_factor
enum<string>
default:2x

Configure scale factor of the image. For higher scales, the image will take longer to process.

Available options:
2x,
4x,
8x,
16x
​
webhook_url
string<uri>

Optional callback URL that will receive asynchronous notifications whenever the task changes status.

Example:

"https://www.example.com/webhook"

Response

OK - The upscaling process has started

​
data
object
required