image-upscaler

Upscaler Creative - Upscale image

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 of the upscaling process. For real-time production use, include the optional webhook_url parameter to receive an automated notification once the task has been completed. This allows for seamless integration and efficient task management without the need for continuous polling.

post/v1/ai/image-upscaler

Request

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

Request body

imagestring byte required

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

webhook_urlstring uri

Optional callback URL that will receive asynchronous notifications whenever the task changes status. The payload sent to this URL is the same as the corresponding GET endpoint response, but without the data field.

scale_factor'2x' | '4x' | '8x' | '16x'

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

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

promptstring

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

creativityinteger

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

hdrinteger

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

resemblanceinteger

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

fractalityinteger

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

engine'automatic' | 'magnific_illusio' | 'magnific_sharpy' | 'magnific_sparkle'

Magnific model engines

filter_nsfwboolean

Controls NSFW (Not Safe For Work) content filtering on the upscaled image.

When set to true, the output image will be scanned and filtered to prevent NSFW content from being returned.

Default is false.

Example request

{
  "webhook_url": "https://www.example.com/webhook"
}

Response

OK - The request has succeeded and the upscaling process has started. The result will be notified by a Webhook call

Example response

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

Changes

No recorded changes to this operation across all 1 revision of this API.