Bestseller
Image Processing Image Optimization File Compression

Image Compression

Compress and resize JPEG, PNG, or WebP images

What can this API do?

Uploads and public image URLs

Optimize files supplied by users or images already available through a public HTTP(S) URL.

JPEG, PNG, and WebP

Accept the three common web image formats and choose the output format your workflow needs.

Aspect-ratio-preserving resize

Fit images within target dimensions without distortion or unnecessary upscaling.

Quality control

Balance file size and visual quality for JPEG and WebP while keeping PNG output lossless.

Direct optimized image bytes

Receive the processed image with the correct media type and a usable download filename.

Faster media delivery

Reduce image payloads for websites, mobile apps, storage, email, archives, and publishing pipelines.

Image Compression
Annual plan
$49$99
Subscribe Annually Try Demo Request
Try it for free!
Sign in to get a trial key and test all APIs.
Sign In
Secure checkout powered by Stripe

API Document

HTTP Protocol:HTTPS

HTTP Method:POST

HTTP Endpoint:https://api.gugudata.io/v1/image/image-compress

Response Type:application/json; charset=utf-8

DEMO Endpoint:https://api.gugudata.io/v1/image/image-compress/demo

Live Demo:Try Interactive Demo

Full API Docs:developers.gugudata.io

API Request Parameters

NameTypeIs RequiredDefault ValueRemark
appkeystringtrueYOUR_APPKEYApplication key used for request authentication. Supply it as a query parameter.
filefilefalseJPEG, PNG, or WebP multipart upload up to 10 MiB. Supply either file or image_url, but not both.
image_urlstringfalseComplete public HTTP or HTTPS image URL up to 2,048 characters. Supply either image_url or file, but not both.
targetWidthintegerfalseOutput width bound from 1 to 8,192 pixels. Aspect ratio is preserved and smaller images are not enlarged.
targetHeightintegerfalseOutput height bound from 1 to 8,192 pixels. Aspect ratio is preserved and smaller images are not enlarged.
maxWidthintegerfalseMaximum output width from 1 to 8,192 pixels while preserving aspect ratio.
maxHeightintegerfalseMaximum output height from 1 to 8,192 pixels while preserving aspect ratio.
qualityintegerfalse85JPEG or WebP output quality from 1 to 95. PNG output remains lossless.
formatstringfalseOutput format: jpeg, jpg, png, or webp. The source format is used when omitted.

API Response Parameters

NameTypeRemark
imagebinaryCompressed image bytes. The response media type and download filename match the selected output format.

API Response Status Codes

Status CodeExplanation of Status CodeRemarks
200Request processed successfully.Some endpoints expose a separate application-level status field in the response body, such as `dataStatus.statusCode`.
400Invalid request parameters or request format.Check required fields, data types, and request body format.
401Missing or unknown application key.Provide a valid `appkey` with the request.
403The application key is recognized but access is not allowed.The key may be expired, inactive, or not permitted for the requested API.
429Request rate or trial usage limit exceeded.Reduce concurrency or retry after the limit window resets.
500Internal service error.Retry later or contact support if the error persists.
503Upstream service unavailable.Retry later; the requested upstream dependency is temporarily unavailable.

Remote MCP

AI client access

Use this API through GuGuData Remote MCP

Connect your AI client once, authorize in the browser, and the client can use the GuGuData API tools available to your account. You do not need to paste an appkey into the MCP client.

Endpoint https://mcp.gugudata.io/mcp
Open MCP Guide
Generic MCP configuration
{
  "mcpServers": {
    "gugudata": {
      "url": "https://mcp.gugudata.io/mcp",
      "transportType": "streamable-http"
    }
  }
}

Code Snippets

Run in Apifox Run in Postman Open LLM Page

Related APIs

Useful APIs to extend this workflow.

View all APIs