API URL
POST /image-processing
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
Binary image file for processing (JPG PNG WebP GIF BMP TIFF HEIC/HEIF)
image_url
required
string
URL of remote image to process (alternative to file upload)
width
optional
integer
Target width in pixels for resize operation
height
optional
integer
Target height in pixels for resize operation
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
POST /api/v1/image-processing/resize?api_key=YOUR_API_KEY
Content-Type: multipart/form-data
image=<binary-file-data>
width=800
height=600Successful Response
Status
HTML
200 OKBody
Code
Binary image data with headers:
Content-Type: image/jpeg
Content-Length: 245760
X-Processing-Time: 150ms
X-Correlation-ID: img_abc123Field
Type
Description
status
string
email (string) – Input email address
operations
array
valid (boolean) – Overall validation result
output
object
score (number) – Confidence score 0-1
metadata
object
checks (object) – Individual check results
base64
string
domain_info (object) – Domain and MX information
processingTime
integer
risk_flags (array) – Potential issues detected
timestamp
string
suggestions (array) – Typo corrections if available
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_EMAIL – Email format is invalid
400 INVALID_DOMAIN – Domain does not exist
429 RATE_LIMIT – Daily quota exceeded
500 VALIDATION_ERROR – SMTP or DNS timeoutLast Updated: May 4, 2026