[DEMO] Image Compress

Image Compress
Compress and optimize images with customizable quality, dimensions, and format conversion. Supports both file upload and URL-based image processing with intelligent compression algorithms.

Method: POST
Path: /v1/image/image-compress
Demo: https://api.gugudata.io/v1/image/image-compress/demo

Request Parameters:

appkey (string, required): API key obtained after payment, can be passed as query parameter or in form data

file (file, optional): Image file to compress (JPEG, PNG, etc.). Either file or image_url must be provided, but not both

image_url (string, optional): URL of the image to compress. Either file or image_url must be provided, but not both

targetWidth (integer, optional): Target width in pixels. Image will be resized to this width while maintaining aspect ratio

targetHeight (integer, optional): Target height in pixels. Image will be resized to this height while maintaining aspect ratio

maxWidth (integer, optional): Maximum width in pixels. Image will be resized if it exceeds this width, maintaining aspect ratio

maxHeight (integer, optional): Maximum height in pixels. Image will be resized if it exceeds this height, maintaining aspect ratio

quality (integer, optional): Compression quality (1-95). Higher values mean better quality but larger file size. Default is 85

format (string, optional): Output format (JPEG, PNG, etc.). If not specified, original format is preserved

Response Fields Count: 1
Response Field Examples:

image: Compressed image file stream (JPEG, PNG, etc.) with appropriate Content-Type header

Key Features:

Support both file upload and URL-based image processing

Intelligent compression with customizable quality (1-95)

Flexible dimension control with target size and max size options

Automatic aspect ratio preservation during resizing

Format conversion support (JPEG, PNG, etc.)

Details:
https://gugudata.io/details/image-compress

application/json

Body

Example

{
  "image": null,
  "DataStatus": {
    "StatusCode": 100,
    "StatusDescription": "OK",
    "ResponseDateTime": "2026-01-01 00:00:00",
    "DataTotalCount": 1
  }
}

Request

Request Code Samples

Responses