API URL
POST /resize
Headers
Code
Content-Type: application/jsonBody Parameters
Param
Type
Description
Content-Type
required
string
HTTP content type header for request format specification
image
required
file
Image file to process (multipart/form-data)
image_url
required
string
Public URL to an image (JSON body)
width
optional
integer
Target width in pixels
height
optional
integer
Target height in pixels
quality
optional
integer
JPEG compression quality level (1-100 default: 80)
format
required
string
Target output format for conversion
x
required
integer
Left coordinate for crop operation (pixels from left edge)
y
required
integer
Top coordinate for crop operation (pixels from top edge)
operations
required
array
Array of operation objects for pipeline processing
output
optional
object
Output configuration for pipeline results
preserve_exif
optional
boolean
Whether to preserve EXIF metadata in processed images
progressive
optional
boolean
Enable progressive JPEG encoding for web optimization
Example Request
Code
{
"image_url": "https://upload.wikimedia.org/wikipedia/commons/4/47/PNG_transparency_demonstration_1.png",
"width": 300,
"height": 200
}Successful Response
Status
HTML
200 OKBody
Code
Binary image/jpeg returned directly in response.
Headers include Content-Type: image/jpegField
Type
status
string
operations
array
output
object
metadata
object
base64
string
processingTime
integer
timestamp
string
correlationId
string
Content-Type
string
Content-Length
string
X-Processing-Time
string
X-Correlation-ID
string
success
boolean
data
object
results
array
processed_image
string
size_bytes
integer
dimensions
object
format_info
object
compression_ratio
number
quality_used
integer
location
object
device
object
camera
object
temporal
object
file
object
error
string
details
string
basic
object
Error Response
Example
Code
400 INVALID_INPUT – Required parameters missing or invalid
400 UNSUPPORTED_FORMAT – Provided format is not supported
500 PROCESSING_ERROR – Sharp or I/O operation failedLast Updated: May 4, 2026