开发者 API

通过简单的 HTTP API,以编程方式压缩和转换图片。

身份验证

在控制台创建 API Key,每次请求时通过 Authorization 请求头携带。

Authorization: Bearer tc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
创建 API Key

接口地址

向压缩接口发送 multipart/form-data 请求:

curl -X POST https://www.mippolab.com/api/compress \
  -H "Authorization: Bearer tc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -F "file=@image.png" \
  -F "format=png" \
  -o compressed.png

需要格式转换时,将 format 设为目标格式即可 —— 一次请求同时完成转换和压缩(例如 PNG 输入配 format=jpeg,返回压缩后的 JPEG)。

curl -X POST https://www.mippolab.com/api/compress \
  -H "Authorization: Bearer tc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -F "file=@photo.png" \
  -F "format=jpeg" \
  -o photo.jpg
ParameterTypeDescription
filefile要处理的图片文件(PNG、JPEG、WebP 或 AVIF)。
formatstring输出格式:png、jpeg、webp 或 avif。省略则保持原格式仅压缩;传入不同格式即一步完成格式转换 + 压缩。

响应

成功时直接返回压缩后的图片二进制数据(带对应 Content-Type);失败时返回 JSON 错误信息。

HTTP/1.1 200 OK
Content-Type: image/png

<binary image data>

使用限制

免费套餐每天 50 次请求。API Key 在控制台中管理。