图片压缩（公开 URL / Bearer 鉴权）

上传本地图片或提交公开图片地址，按目标宽高或最大宽高等比缩放，并直接返回压缩后的图片文件。支持 JPEG、PNG、WebP、GIF 和 BMP；动态 GIF 与 WebP 保持原格式时保留动画内容。
详情页：https://www.gugudata.com/api/details/image-compress

当前接口契约

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

功能说明

支持上传本地图片或提交公开图片地址，直接获取压缩结果；

支持 JPEG、PNG、WebP、GIF 与 BMP 常见图片格式；

可按目标宽高或最大宽高等比缩放，避免图片拉伸变形；

支持多种输出格式，便于适配网站、移动端和内容平台；

可调节 JPEG 与 WebP 输出质量，平衡清晰度与文件体积；

保留 PNG、WebP 与 GIF 的透明效果，适合图标、海报和网页素材；

动态 GIF 与 WebP 在保持原格式时保留动画内容与播放节奏；

返回可直接保存、展示或继续传入业务系统的图片文件；

适合网站提速、移动端素材、内容管理和营销物料处理；

适合图片归档、上传前优化、素材适配与自动化处理流程；

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	APPKEY，可通过 Query、multipart form、Header 或 Bearer 传递。 AppKey 整体必填；在本操作已声明支持的鉴权位置任选一个提供，本位置无需重复填写。多处填写时须一致。
image_file	string/binary	否	无	本地图片文件，最大 10 MiB；与 image_url 二选一。
image_url	string	否	无	公开可访问的 HTTP 或 HTTPS 图片地址；与 image_file 二选一。
targetWidth	integer	否	无	目标宽度上限，范围为 1 至 8192 像素。
targetHeight	integer	否	无	目标高度上限，范围为 1 至 8192 像素。
maxWidth	integer	否	无	最大宽度，范围为 1 至 8192 像素。
maxHeight	integer	否	无	最大高度，范围为 1 至 8192 像素。
quality	integer	否	85	JPEG 或 WebP 输出质量，范围为 1 至 95，默认 85。
format	string	否	无	输出格式：jpeg、png、webp、gif 或 bmp；未传时保持原格式。

正常响应字段

字段	类型	说明
HTTP Header.Content-Type	string	实际输出图片的 MIME 类型。
HTTP Header.Content-Disposition	string	包含建议下载文件名的响应头。
Body(Binary)	string/binary	压缩后的图片二进制文件。

业务状态说明

业务状态码	业务状态码解释	备注
100	请求成功	HTTP 200，返回图片文件。
501	参数或图片错误	HTTP 400。
502	请求频率受限	HTTP 429。
503	订单已到期	HTTP 403。
504	APPKEY 错误	HTTP 401。
505	调用额度耗尽	HTTP 403。
900	内部错误	HTTP 500。
901	图片服务暂时不可用	HTTP 503。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

压缩成功，返回图片二进制文件。

Bodyapplication/json

示例

{}

🟠400参数、图片地址、格式或大小不符合要求，业务码 501。

🟠401缺少或无效 APPKEY，业务码 504。

🟠403订单过期或调用额度不可用，业务码 503 或 505。

🟠429请求频率受限，业务码 502。

🔴500服务内部错误，业务码 900。

🔴503远程图片或图片处理服务暂时不可用，业务码 901。

图片压缩（公开 URL / Bearer 鉴权）

当前接口契约#

功能说明#

请求参数#

正常响应字段#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

功能说明

请求参数

正常响应字段

业务状态说明