Topaz Upscale Image

Upscale images to ultra-high resolutions up to 12K

POST /v1/enhance-upscale

Enhance and Upscale Image

cURL

curl --request POST \
  --url https://api.legnext.ai/api/v1/enhance-upscale \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "image_url": "https://example.com/photo.jpg",
  "jobId": "1868588555208310784",
  "imageNo": 0,
  "target_resolution": "4K",
  "content_type": "photo",
  "aspect_ratio": "keep",
  "crop_mode": "letterbox",
  "output_format": "jpeg",
  "face_enhancement_level": "moderate",
  "callback": "https://your-domain.com/webhook"
}
'

400

{
  "code": 400,
  "message": "Invalid request, image_url must start with http:// or https://",
  "raw_message": "image_url must start with http:// or https://",
  "detail": null
}

Supports direct image URLs or images from previous Midjourney tasks.

Input Methods

Choose one of the following input methods:

Option 1: Direct Image URL

Parameter	Type	Required	Description
image_url	string	Yes	Publicly accessible image URL (HTTP/HTTPS). Supports JPEG, PNG, TIFF. Max: 100MB

Option 2: Midjourney Task

Parameter	Type	Required	Description
jobId	string	Yes	ID from previous Midjourney task
imageNo	integer	Yes	Image index from grid (0-3)

Common Parameters

All enhancement requests support the following parameters:

Parameter	Type	Default	Description
target_resolution	string	2K	Output resolution: HD, FHD, 2K, 4K, 6K, 8K, 12K
content_type	string	standard	Enhancement model: standard, photo, illustration, text, low_res
aspect_ratio	string	keep	Aspect ratio: keep, 1:1, 16:9, 9:16, 4:5, 5:4, 3:2, 2:3, 4:3, 3:4
crop_mode	string	letterbox	Crop handling: letterbox, crop, stretch
output_format	string	jpeg	Output format: jpeg, jpg, png, tiff, tif
face_enhancement_level	string	moderate	Face enhancement: off, none, subtle, moderate, strong
callback	string	-	Webhook URL for completion notifications

Resolution Options

Resolution	Long Edge	Credits	Cost	Recommended For
HD/FHD	1920px	120	$0.12	Web, social media
2K	2560px	120	$0.12	Web, social media (default)
4K	3840px	160	$0.16	Digital displays
6K	6144px	200	$0.20	Professional printing
8K	7680px	300	$0.30	Large format prints
12K	12288px	540	$0.54	Billboards, posters

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

Content Type Models

Type	Best For
standard	General purpose, mixed content (default)
photo	Photographs, realistic images
illustration	Digital art, CGI, drawings
text	Documents, screenshots with text
low_res	Very low quality source images

Face Enhancement

Level	Effect
off / none	Disabled (no faces in image)
subtle	Gentle enhancement for natural portraits
moderate	Balanced enhancement (default)
strong	Aggressive enhancement for low-quality faces

Examples

Using Image URL

cURL

curl -X POST "https://api.legnext.ai/api/v1/enhance-upscale" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.jpg",
    "target_resolution": "4K",
    "content_type": "photo"
  }'

Using Midjourney Task

cURL

curl -X POST "https://api.legnext.ai/api/v1/enhance-upscale" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jobId": "1868588555208310784",
    "imageNo": 0,
    "target_resolution": "8K",
    "content_type": "illustration"
  }'

Response

Success Response

Returns a task object with the following structure:

{
    "job_id": "f3efd852-18ad-483d-87f2-0685a60df014",
    "model": "midjourney",
    "task_type": "enhance_upscale",
    "status": "pending",
    "config": {
        "service_mode": "public",
        "webhook_config": {
            "endpoint": "",
            "secret": ""
        }
    },
    "input": null,
    "output": {
        "image_url": "",
        "image_urls": null,
        "seed": ""
    },
    "meta": {
        "created_at": "2025-12-17T03:22:29+08:00",
        "started_at": "0001-01-01T00:00:00Z",
        "ended_at": "0001-01-01T00:00:00Z",
        "usage": {
            "type": "point",
            "frozen": 300,
            "consume": 0
        }
    },
    "detail": null,
    "logs": [],
    "error": {
        "code": 0,
        "raw_message": "",
        "message": "",
        "detail": null
    }
}

Response Fields

Field	Type	Description
job_id	string	Unique task identifier (UUID)
model	string	Model used: midjourney
task_type	string	Task type: enhance_upscale
status	string	Current status: pending, processing, completed, failed
config	object	Service configuration
config.service_mode	string	Service mode: public
config.webhook_config	object	Webhook configuration
config.webhook_config.endpoint	string	Webhook endpoint URL (empty if not set)
config.webhook_config.secret	string	Webhook secret (empty if not set)
input	object/null	Input parameters (null for this endpoint)
output	object	Task output (empty until completed)
output.image_url	string	Primary enhanced image URL (available when status is completed)
output.image_urls	array/null	Array of enhanced image URLs (null until completed)
output.seed	string	Generation seed (empty for enhancement tasks)
meta	object	Task metadata
meta.created_at	string	Task creation timestamp (ISO 8601)
meta.started_at	string	Task start timestamp (ISO 8601, 0001-01-01T00:00:00Z if not started)
meta.ended_at	string	Task completion timestamp (ISO 8601, 0001-01-01T00:00:00Z if not completed)
meta.usage	object	Credit usage information
meta.usage.type	string	Usage type: point
meta.usage.frozen	integer	Credits frozen/reserved for this task
meta.usage.consume	integer	Credits actually consumed (0 if task failed)
detail	object/null	Additional task details (null if none)
logs	array	Processing logs (empty array)
error	object	Error information
error.code	integer	Error code (0 if successful)
error.raw_message	string	Raw error message from service (empty if successful)
error.message	string	Human-readable error message (empty if successful)
error.detail	object/null	Additional error details (null if none)

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

Option 1

Option 2

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

200

application/json

Enhancement task created successfully