图片压缩 API 接入教程

MiniPic 提供境内可用的图片压缩 API：兼容主流压缩 API 的 HTTP Basic / Bearer 认证与响应结构，多数情况下只需替换 API 地址与 Key 即可从 TinyPNG 等服务平滑迁移。自研压缩引擎对 PNG / JPEG / WebP 平均体积缩减 60% 以上、画质肉眼无损，每月 500 次免费额度，只按成功压缩计费。完整端点参考见开发者文档（minipic.cn/docs）。

为什么选 MiniPic 图片压缩 API

兼容主流压缩 API：认证与响应结构对齐，多数情况换地址换 Key 即接入。
境内节点：上传与回包毫秒级，国内服务调用不卡顿。
500 次/月免费：按北京时间每月 1 日 00:00 重置，足够日常项目起步。
只按成功压缩计费：失败、超限、审核拦截都不计费。

3 步接入

第 1 步：在控制台创建 API Key

第 2 步：发起第一个压缩请求

用 HTTP Basic 认证（用户名固定为 api，密码为你的 Key）压缩一张图片：

# 压缩一张 PNG（Basic 认证，user 固定为 api） curl -s --user api:你的_API_KEY \ --data-binary @input.png \ -o output.png \ https://api.minipic.cn/v1/compress

第 3 步：获取并下载压缩结果

兼容层 /shrink 成功返回 201 Created，结果以加密私有链接返回，仅持有 Key 的你可访问；原生层 /v1/compress 直接返回压缩结果二进制。重复下载同一结果不计费。

Node.js 示例

// Node.js（>=18，内置 fetch）：读取本地图片并压缩 import { readFile, writeFile } from "node:fs/promises"; const key = process.env.MINIPIC_API_KEY; const auth = "Basic " + Buffer.from("api:" + key).toString("base64"); const res = await fetch("https://api.minipic.cn/v1/compress?quality=smart&format=keep", { method: "POST", headers: { Authorization: auth }, body: await readFile("input.png"), }); await writeFile("output.png", Buffer.from(await res.arrayBuffer())); console.log("已压缩，省下", res.headers.get("X-Ratio"));

Python 示例

# Python（requests）：读取本地图片并压缩 import os, requests key = os.environ["MINIPIC_API_KEY"] with open("input.jpg", "rb") as f: res = requests.post( "https://api.minipic.cn/v1/compress", params={"quality": "smart", "format": "keep"}, auth=("api", key), data=f.read(), ) with open("output.jpg", "wb") as out: out.write(res.content) print("已压缩，省下", res.headers.get("X-Ratio"))

从 TinyPNG API 迁移

MiniPic 兼容主流压缩 API 的认证与响应结构，通常只需替换 API 地址与 Key，无需改动业务代码即可从 TinyPNG 等服务迁移。把基址指向 MiniPic（minipic.cn）、把密钥换成 MiniPic 的 API Key 即可开始压缩。

配额、限流与计费

免费额度：每月 500 次，按北京时间每月 1 日 00:00 重置。
阶梯单价：¥0.05/张 → ¥0.012/张 → ¥0.008/张，随当月累计张数递减。
计费口径：只按成功压缩计费；失败、超限、审核拦截都不计费。
限流：10 req/s/Key，突发 20；超出返回 429 + Retry-After。

完整端点参考与错误码表见开发者文档，价格阶梯见定价页，计费细则见计费口径。

常见问题

MiniPic 图片压缩 API 怎么接入？

在 MiniPic 控制台创建 API Key，使用 HTTP Basic（user 固定为 api、密码为 Key）或 Bearer 认证向压缩端点发起请求即可。接口兼容主流压缩 API 的认证与响应结构，多数情况只需替换 API 地址与 Key。

MiniPic 图片压缩 API 免费吗？

每月有 500 次免费额度，按北京时间每月 1 日 00:00 重置；超出按阶梯单价计费（¥0.05 → ¥0.012 → ¥0.008/张），只按成功压缩计费，失败、超限、审核拦截都不计费。

能从 TinyPNG API 迁移到 MiniPic 吗？

可以。MiniPic 的 /shrink 接口兼容主流压缩 API 的认证与响应结构，通常只需替换 API 地址与 Key，无需改动业务代码即可迁移。

3 步接入，500 次/月免费

创建 API Key，换地址换 Key 即可开始压缩。

创建 API Key，免费开始 →查看完整 API 文档查看 API 价格