图片压缩与尺寸优化 - 咕咕数据 API 文档

图片压缩与尺寸优化
图片压缩优化，保持长宽比，保证清晰度

请求方法: POST
接口路径: /ai/image-compress
调试地址: https://api.gugudata.com/ai/image-compress/demo

请求参数:

appkey (string, 必填): 付费后获取的 APPKEY，可通过 Query 参数或 Form 字段 appkey 传递

image_file (file, 可选): 上传的图片文件，支持 JPG / JPEG / PNG / GIF / WEBP / BMP，与 image_url 二选一必填

image_url (string, 可选): 网络图片 URL，与 image_file 二选一必填，需为可直接访问的 HTTP/HTTPS 链接

targetWidth (int, 可选): 目标宽度（像素），与 targetHeight 组合使用时按照最长边等比缩放；不传则不以此为约束

targetHeight (int, 可选): 目标高度（像素），与 targetWidth 组合使用时按照最长边等比缩放；不传则不以此为约束

maxWidth (int, 可选): 最大宽度（像素），只限制不超过该宽度并保持长宽比；当未显式传递任何尺寸参数且图片特别大时，服务会自动使用 1920 作为默认上限

maxHeight (int, 可选): 最大高度（像素），只限制不超过该高度并保持长宽比；当未显式传递任何尺寸参数且图片特别大时，服务会自动使用 1920 作为默认上限

quality (int, 可选): JPEG 压缩质量，取值范围 1-95，数值越低压缩越厉害，推荐在 60-90 之间；PNG 等无损格式将使用内部优化策略忽略该参数

format (string, 可选): 输出图片格式，可选值：jpeg、png 等；不传则保持原图格式（对于部分不常见格式会自动转换为 JPEG）

返回字段数量: 3
返回字段示例:

HTTP Header.Content-Type: 返回图片的 MIME 类型，例如 image/jpeg、image/png 等

HTTP Header.Content-Disposition: 文件下载头，包含建议的下载文件名，默认会根据原始文件名和格式自动生成

Body(Binary): 压缩后图片的二进制流内容，可直接保存为图片文件或在浏览器中显示

接口特性:

支持本地上传图片或网络图片 URL，一键完成压缩

自动保持图片长宽比，可按目标尺寸或最大尺寸进行等比缩放

针对 JPEG 采用优化压缩（渐进式、优化 Huffman 表等），在保证清晰度的前提下显著减小体积

支持 PNG 等无损格式的体积优化压缩

自动限制过大图片的尺寸（默认 1920 像素上限），避免带宽浪费

接口详情:
https://www.gugudata.com/api/details/image-compress

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
  "Body(Binary)": null,
  "HTTP Header": {
    "Content-Type": "string",
    "Content-Disposition": "string"
  },
  "DataStatus": {
    "StatusCode": 100,
    "StatusDescription": "OK",
    "ResponseDateTime": "2026-01-01 00:00:00",
    "DataTotalCount": 1
  }
}