开发者

图片压缩 API

MiniPic 的图片压缩 API 兼容主流压缩 API 的认证与响应结构，换地址、换 Key 即可迁移；注册即送每月 500 次，只对成功压缩计费。

获取 API Key阅读 API 文档

注册每月 500 次免费 · 只对成功压缩计费 · 资源包永不过期

兼容层 /shrink
# 压缩一张 PNG：HTTP Basic 认证，用户名固定为 api，密码填 API Key
curl -i https://api.minipic.cn/shrink \
  --user api:你的_API_KEY \
  --data-binary @input.png
# 成功返回 201 Created，按响应里的结果链接下载压缩后的图片

两层接口

两层接口：/shrink 兼容层与 /v1 原生层。

兼容层

POST /shrink

兼容主流压缩 API 的认证与响应结构，换地址、换 Key 即可迁移。

  • 上传二进制，或者给一个公网 URL
  • GET /output/{id} 下载结果
  • POST /output/{id} 衍生操作：resize（scale / fit / cover）、convert（PNG / JPEG / WebP 互转）、preserve（保留元数据）

原生层

POST /v1/compress

同步接口，直接返回压缩结果。

  • quality：smart / high / extreme / 1-100
  • format：keep / webp
  • GET /v1/usage 查询用量

快速开始

三步接入。

API 接入教程

  1. 创建 API Key

    登录控制台创建 API Key：mp_live_ 开头用于生产，mp_test_ 开头用于沙箱。完整 Key 只在创建时显示一次。

  2. 发起请求

    用 HTTP Basic（用户名 api，密码填 Key）或 Bearer 认证，调用 /shrink 或 /v1/compress。

  3. 取回结果

    /shrink 按返回的结果链接下载；/v1/compress 直接返回压缩后的图片。重复下载同一结果不计费。

免费额度与计费

免费额度与计费：只对成功压缩计费。

北京时间每月 1 日 00:00 重置；团队每月 3,000 次，团队共享。

重复下载同一结果不计费；每次衍生操作计 1 张；失败、超限、审核拦截都不计。

500次 / 月

注册即送

1,000次 / 月

Pro

资源包

资源包永不过期，阶梯单价。

免费额度用完后使用预付资源包，没有按量月结。

查看定价

1 万张

¥450¥315

永不过期。

10 万张

¥1,200¥840

永不过期。

100 万张

¥7,000¥4,900

永不过期。

认证与限制

认证、限流与单文件上限。

认证

Basic 或 Bearer

每个账户至多 5 个 Key；服务端只保存 Key 的哈希值。

限流

10 次 / 秒

每个 Key 突发 20；同一个 Key 同时进行的任务不超过 20 个。

单文件

5MB / 80MB

免费 5MB，付费 80MB；单图不超过 1 亿像素。

格式

支持的格式。

默认保持原格式；HEIC 转为 JPEG，BMP 转为 PNG，也可以转 WebP。GIF 默认无损优化，SVG 只做源码优化。

暂不支持：AVIF 作为转换目标、智能缩略图、直传对象存储。

常见问题

图片压缩 API 免费吗？

注册即送每月 500 次（北京时间每月 1 日 00:00 重置）；Pro 每月 1,000 次，团队每月 3,000 次；超出后使用预付资源包。

怎么从 TinyPNG 迁移？

/shrink 接口兼容主流压缩 API 的认证与响应结构，多数情况下替换 API 地址与 Key 即可接入。

压缩失败会扣次数吗？

不会。只对成功压缩计费，失败、超限、审核拦截都不计。

资源包会过期吗？

不会，资源包永不过期。

API 支持哪些格式？

支持 PNG、JPEG、WebP、GIF、TIFF、AVIF、SVG 压缩，HEIC 与 BMP 可作为输入。