图片压缩与格式转换

接口标识: imagecompress 价格: 0.08 元/次同步响应

接口介绍
接口文档
在线测试

接口简介

图片压缩与格式转换接口按质量压缩图片体积、按最大宽高等比缩放尺寸，并可在 JPG、PNG、WebP 之间转换格式，同时返回原始大小、压缩后大小与压缩比等数值。单图最大 50MB、像素上限 1 亿；自动纠正 EXIF 方向，照片不会压缩后变歪，透明图转 JPG 自动补白底。适合电商商品图瘦身、社区上传限制、官网 WebP 改造与图库存量治理等场景。

详细介绍

![图片压缩与格式转换接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261111/apiops_imagecompress__1794363351_e2749004304d.png)

大图直接拖慢页面打开速度、推高存储成本，各类平台对上传图片的体积限制也越来越严。图片压缩与格式转换接口一次完成压体积、缩尺寸与转格式，并把压缩效果量化返回。

## 接口概述
面向电商、内容社区、官网建设与图库存量治理等场景，上传一张图片并选择仅压体积、仅缩尺寸或两者兼做，接口自动完成质量压缩、等比缩放与格式转换，返回处理后图片的下载地址，以及原始大小、压缩后大小、压缩比、产物宽高与格式等数值。输出支持 JPG、PNG、WebP；带 EXIF 旋转信息的照片自动摆正，透明图转 JPG 自动补白底。处理结果可直接回填 CDN、商品详情页与上传系统。

## 核心能力
1. **三种处理模式**：compress 仅压体积、resize 仅缩尺寸、both 两者兼做，默认 compress。
2. **质量控制**：输出质量 1~100 可调，默认 80，对 JPG 与 WebP 生效。
3. **等比缩放**：给定最大宽度或最大高度，按比例缩小，画面不变形、不裁切。
4. **格式互转**：JPG、PNG、WebP 互转；不指定时沿用原格式，GIF、TIFF、BMP 等归一为 PNG。
5. **细节与量化**：自动纠正 EXIF 方向、透明图转 JPG 自动补白底；返回原始大小、压缩后大小与压缩比，省了多少一目了然。

## 产品优势
1. **接入简单**：一次 POST 传图片与参数即得产物地址与体积数据，无需安装图像库。
2. **响应迅速**：压缩与转换在平台服务器本地完成，无需等待第三方服务。
3. **稳定可靠**：无外部依赖即无上游抖动风险；单图 50MB 与 1 亿像素双重上限保护。
4. **降本增效**：图片体积直接决定存储与流量成本，发布前统一压缩收益立竿见影。
5. **准确规范**：压缩比与产物尺寸随结果实测返回，便于业务系统设置验收阈值。
6. **生态开放**：与平台其余接口共用同一套签名与响应结构，接入一次处处复用。

## 效果展示
一句话理解：它就像图片的「瘦身师」，你提要求——压体积、缩尺寸还是换格式，它处理完还把减掉多少、变成多大如实报给你。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| file | https://example.com/demo/photo.jpg | 要处理的图片，支持公网URL、Base64（data:开头）与平台文件ID（fileid_开头），单图不超过 50MB |
| quality | 75 | 输出质量 1~100，默认 80，对 jpg 与 webp 生效 |
| format | webp | 输出格式 jpg/png/webp，不传时沿用原图格式 |
| max_width | 1600 | 等比缩放的最大宽度（像素），配合 mode=resize 或 both 生效 |
| mode | both | compress 仅压体积 / resize 仅缩尺寸 / both 两者兼做，默认 compress |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 产物图片下载地址 | https://fujian.phpwc.com/pyapi/uploads/api/20261110/img_20261110_160000.webp | `image_url` |
| 原始大小 | 2457600 | `original_size`，单位字节 |
| 压缩后大小 | 384512 | `compressed_size`，单位字节 |
| 压缩比 | 0.1565 | `ratio`，压缩后除以原始，数值越小省得越多 |
| 产物宽度 | 1600 | `width`，等比缩放后的实际像素宽 |
| 产物高度 | 1200 | `height`，等比缩放后的实际像素高 |
| 产物格式 | `"webp"` | `format`，实际输出格式 |

API请求示例：

```text
POST /api/imagecompress
file=https://example.com/demo/photo.jpg&quality=75&format=webp&max_width=1600&mode=both
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "image_url": "https://fujian.phpwc.com/pyapi/uploads/api/20261110/img_20261110_160000.webp",
    "original_size": 2457600,
    "compressed_size": 384512,
    "ratio": 0.1565,
    "width": 1600,
    "height": 1200,
    "format": "webp"
  },
  "request_id": "req-imagecompress-demo-001"
}
```

本例一张约 2.4MB 的 JPG 原图被限制到 1600 像素宽并按质量 75 转成 WebP，体积降到约 376KB；ratio、width、height 都是产物实际数值，可直接用于业务侧验收。

## 应用场景
1. **电商商品图**：发布前压缩体积并转换格式，满足平台大小限制、加快详情页打开。
2. **社区 UGC**：用户上传图片自动瘦身后再入库，节省存储与流量开销。
3. **官网建设**：Banner 与配图批量转 WebP，兼顾画质与体积。
4. **图库治理**：存量高分辨率图片按最大宽度策略批量处理，统一发布规格。
5. **文档报告**：插图缩放到合适尺寸再嵌入，避免文件臃肿。

## 应用案例
一家二手交易平台过去用户原图直接进详情页，移动端高峰期加载缓慢；接入接口后在上传流程里按最大宽 1600、质量 75 做 both 处理，页面图片体积明显下降，加载体验改善，存储增速也随之放缓。

一家旅游攻略官网希望全站图片改用 WebP，但改造自研图片处理模块周期太长；现在发布后台统一调用接口把配图转成 webp 并回填地址，几乎零开发量完成了格式升级。

一家企业内部系统要求员工头像上传必须控制体积，前端压缩质量参差不齐；改为服务端统一调用接口压缩，并用返回的 ratio 字段做达标校验后，头像规格完全统一。

常见问题

Q：压缩效果怎么衡量？

A：返回的 original_size、compressed_size 与 ratio 均为产物实测值；ratio 为压缩后大小除以原始大小，数值越小说明体积省得越多。

Q：不指定 format 时输出什么格式？

A：沿用原图格式；原图是 GIF、TIFF、BMP 等没有对应输出格式的，统一归一为 png 输出，avif 暂不支持。

Q：为什么传了 max_width 却没有缩放？

A：等比缩放仅在 mode 为 resize 或 both 时生效，默认 compress 模式只做质量压缩不改变尺寸。

Q：透明背景图压缩后会丢透明吗？

A：仅输出 jpg 时会丢失透明并自动补白底；输出保持 png 或 webp 可保留透明通道。

图片压缩格式转换 WebP 图片瘦身 EXIF纠正

接口地址： https://www.phpwc.cn/api/imagecompress

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`file`	file	必填	-	图片/文件，支持三形态：公网URL / data:image;base64编码 / file_id(fileid_开头)
`quality`	int	选填	-	输出质量 1~100，默认 80（jpg/webp 生效）
`format`	string	选填	-	输出格式：jpg/png/webp，默认沿用原格式（avif 暂不支持）
`max_width`	int	选填	-	等比缩放最大宽度（像素）
`max_height`	int	选填	-	等比缩放最大高度（像素）
`mode`	string	选填	-	compress(压体积)/resize(缩尺寸)/both，默认 compress

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`image_url`	string	产物图片下载地址
`original_size`	int	原始字节数
`compressed_size`	int	压缩后字节数
`ratio`	number	压缩后/原始体积比
`width`	int	产物宽度（像素）
`height`	int	产物高度（像素）
`format`	string	产物格式
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试