2K or 4K output
Pick the target with a single field: resolution = "2k" (2560 px on the long edge) or "4k" (3840 px). Aspect ratio is kept. Same price for both.
Catalog
Latency Synchronous; typically 2–10 seconds Async false Rate Limit Per API key Max Input JPEG, PNG or WebP up to 4096×4096 pixels. The source must be smaller than the target (long edge under 2560 px for 2K, under 3840 px for 4K). One image per request.
cn8/studio-upscale-image
Send the URL of an image and get it back at 2K or 4K resolution. The upscaler
Learn more about Image Upscale ImagesyncInstant previewimageprocessingupscale
Input
string
Public URL of the source image (JPEG, PNG or WebP, up to 4096×4096; must be smaller than the target resolution)
Instant sample preview — no cost, no account. Sign up free to run with your own input.
Result
Completed Instant previewJson
{
"status": "success",
"data": {
"url": "https://cdn.example.com/images/upscale/abc123.png",
"key": "images/upscale/ab/cd/abcd1234.png",
"folder_id": "abcd1234",
"content_type": "image/png",
"resolution": "2k",
"width": 2560,
"height": 1810,
"source_width": 1000,
"source_height": 707
},
"cost": {
"tokens": 1,
"unit_price": 6,
"balance": 1234
}
}Example response from this endpoint's API reference. Sign in to run it on your own input.
This request costs 6 credits per item.
Overview
Send the URL of an image and get it back at 2K or 4K resolution. The upscaler does not just stretch pixels: a neural super-resolution network (Real-ESRGAN) rebuilds edges and texture, so low-resolution photos, scans, thumbnails and AI-generated images come back sharp enough for print, large displays and further editing. The response is synchronous: you get the URL of the finished PNG directly in the reply.
Key capabilities
Real detail, not blur
Neural super-resolution restores edges and texture instead of the soft look of classic resizing, and it stays faithful to the source — no invented objects or altered faces.
Synchronous response
No job to poll — the finished PNG URL comes back directly in the response body, typically within a few seconds.
When to use it
Print and large-format display
Bring web-sized product shots, portraits and marketing images up to print resolution.
Restoring old or compressed images
Sharpen low-resolution archives, scans and heavily compressed uploads.
AI image pipelines
Generate at a fast, low resolution and upscale only the picks you keep — cheaper than generating everything at full size.
Input & output
input
Public URL of a JPEG, PNG or WebP image; target resolution (2k or 4k)
JSON body
output
Output image URL (PNG) returned synchronously
JSON
Guides & tips
How it works
- Send the URL of your source image and the target resolution.
- The image is upscaled with a neural super-resolution network (Real-ESRGAN) that reconstructs edges and texture rather than interpolating pixels, then sized exactly to the target.
- The finished PNG is returned as a URL in the response — ready to download or use straight away.
Input limits
- Formats: JPEG, PNG or WebP. Convert HEIC or GIF before sending. PNG transparency is kept.
- Size: up to 4096×4096 pixels.
- The source must be smaller than the target: a long edge under 2560 px for 2K, under 3840 px for 4K. Larger sources are rejected (400) and not charged.
- One image per request.
Choosing 2K vs 4K
- 2K is enough for screens, social media and most web use, and it finishes faster.
- 4K is for print, large-format display and images you will crop or edit further.
- Both cost the same, so choose by where the image will be used.
What to expect
- The result is faithful to the source: edges and texture are sharpened, nothing is invented or redrawn.
- Very small sources (a few hundred pixels) are enlarged in two passes; they get sharper, but detail that was never there cannot be recovered.
- The aspect ratio is preserved exactly; the long edge lands on 2560 or 3840 px.
Specs
Schema
Request body
imageUrlrequiredstringPublic URL of the source image (JPEG, PNG or WebP, up to 4096×4096; must be smaller than the target resolution)
resolutionstring · default: 2kTarget resolution: "2k" (default, 2560 px long edge) or "4k" (3840 px long edge). Aspect ratio is preserved.
enum: 2k, 4k
Pricing
Billed per image processed.
| Service | Unit | Price |
|---|---|---|
| Image Upscale | image | 6 credits/image |
One image is charged per successful request, regardless of source size or target resolution (2K and 4K cost the same).
Rejected or failed requests are not charged.