Skip to main content
POST
Enhance and Upscale Image
Supports direct image URLs or images from previous Midjourney tasks.

Input Methods

Choose one of the following input methods:

Option 1: Direct Image URL

Option 2: Midjourney Task

Common Parameters

All enhancement requests support the following parameters:

Resolution Options

Higher resolutions consume more credits and take longer to process. Choose the minimum resolution that meets your requirements.

Content Type Models

Face Enhancement

Examples

Using Image URL

Using Midjourney Task

Response

Success Response

Returns a task object with the following structure:

Response Fields

Use the job_id to check task status via the Get Task Status endpoint.

Authorizations

x-api-key
string
header
required

API key for authentication

Body

application/json
image_url
string<uri>
required

Direct image URL to enhance. Must be publicly accessible. Supports JPEG, PNG, TIFF formats. Maximum file size: 100MB.

Maximum string length: 2048
Pattern: ^https?://
Example:

"https://example.com/photo.jpg"

jobId
string

Task ID from a previous Midjourney generation task. Use this to enhance images from prior generations.

Example:

"1868588555208310784"

imageNo
integer

Image index from the Midjourney grid (0-3). Required when using jobId.

Required range: 0 <= x <= 3
Example:

0

target_resolution
enum<string>
default:2K

Target output resolution. Higher resolutions cost more credits.

Available options:
HD,
FHD,
2K,
4K,
6K,
8K,
12K
Example:

"4K"

content_type
enum<string>
default:standard

Content-aware enhancement model selection.

Available options:
standard,
photo,
illustration,
text,
low_res
Example:

"photo"

aspect_ratio
enum<string>
default:keep

Output aspect ratio. Use 'keep' to maintain original proportions.

Available options:
keep,
1:1,
16:9,
9:16,
4:5,
5:4,
3:2,
2:3,
4:3,
3:4
Example:

"keep"

crop_mode
enum<string>
default:letterbox

How to handle aspect ratio changes when aspect_ratio is not 'keep'.

Available options:
letterbox,
crop,
stretch
Example:

"letterbox"

output_format
enum<string>
default:jpeg

Output image format.

Available options:
jpeg,
jpg,
png,
tiff,
tif
Example:

"jpeg"

face_enhancement_level
enum<string>
default:moderate

AI-powered face enhancement strength.

Available options:
off,
none,
subtle,
moderate,
strong
Example:

"moderate"

callback
string<uri>

Webhook URL for task completion notifications.

Example:

"https://your-domain.com/webhook"

Response

Enhancement task created successfully