# MiniPic 完整说明（llms-full）

MiniPic（minipic.cn）：智能图片压缩 SaaS，面向中国大陆市场。自研压缩引擎逐张寻优；
质量主张用公开基准数据说话（对照行业标杆技术栈，报告与样张可下载）。
隐私承诺：图片仅用于本次压缩，全程加密传输、私有链接访问、拒绝泄漏，绝不用于训练或任何其他用途。

## Web 端（https://minipic.cn/）

- 免注册：单张 ≤ 5MB、每批 20 张、每日 100 张（注册后不限每日，每月 1,000 张、每批 50 张）
- 输入支持 PNG / JPEG / WebP / HEIC（iPhone 照片）/ GIF / BMP / TIFF / AVIF / SVG；输出可保持原格式或全部转 WebP。「保持原格式」时 PNG / JPEG / WebP / GIF / TIFF / AVIF 均按原格式压缩（AVIF→AVIF、TIFF→TIFF，扩展名不变、引用不断）；HEIC 自动转为 JPEG（结果区明示「HEIC 已转 JPEG」，下载文件名为 .jpg），BMP 因格式本身不支持压缩自动转为 PNG（明示「BMP 图片不支持压缩，已为您转 PNG」，下载 .png）。GIF 在「保持原格式」时做无损优化（仍是 GIF），转 WebP 通常更省体积。SVG 仅支持保持原格式（矢量源码优化：剥离编辑器元数据与脚本、渲染结果不变，输出仍是 SVG，绝不栅格化转位图）
- 质量档位：智能（默认）/ 高保真 / 极限 / 自定义（Pro）
- 压缩前后滑块对比；批量 ZIP 下载；失败与审核拦截不计用量

## 桌面客户端（https://minipic.cn/download）

- MiniPic 提供 macOS 与 Windows 原生桌面版，免费下载使用，已签名并通过公证
- 桌面版全程在本地处理图片，不经网络、不上传服务器，适合处理敏感素材
- macOS 版按芯片提供两个安装包（.dmg）：Apple 芯片（M 系列）版与 Intel 芯片版，按自己 Mac 的芯片选择（苹果菜单 >「关于本机」可查看）；最低系统 macOS 13（Ventura）及以上
- Windows 版提供 64 位（x64）安装包（.exe），并为 ARM 设备提供 ARM64 版本；支持 Windows 10 / 11（64 位）
- 桌面端独有能力：批量拖拽整文件夹、右键菜单「用 MiniPic 压缩」、监听文件夹
- 每个平台均提供国内镜像下载，与官方源同一签名、体积一致

## 订阅定价（人民币含税，https://minipic.cn/pricing）

- 免费：¥0，单张 5MB、每批 50 张、不限每日（每月 1,000 张）
- 个人 Pro：¥99/年（或 ¥15/月），单张 80MB、每批 300 张、无每日上限（公平使用 5,000 张/月）、赠 API 1,000 次/月
- 团队：¥399/年含 5 席，加席 ¥69/席/年，赠 API 3,000 次/月
- 企业：¥30,000/年起，SLA 99.95%、专属限流、合同与 DPA
- Pro 自动续费：开通后每周期微信支付自动扣款、扣费前提醒、随时可取消；年付 7 天内未使用可全额退款

## API（https://minipic.cn/docs）

- 认证：HTTP Basic（user 固定 api，密码为 Key，兼容主流压缩 API）或 Bearer
- 端点：POST /shrink（兼容层压缩）、GET /output/{id}（下载，加密私有链接）、
  POST /output/{id}（resize/convert/preserve 衍生操作）、
  POST /v1/compress（同步压缩）、GET /v1/usage（用量查询）
- 限流：10 req/s/Key（突发 20）；并发 ≤ 20/Key
- 计费：只按成功压缩计 1 张；免费 500 次/月；阶梯单价
  501–10,000 张 ¥0.05/张；10,001–100,000 张 ¥0.012/张；100,000 以上 ¥0.008/张（边际计价）
- 资源包（永不过期）：10,000 张 ¥450；100,000 张 ¥1,200；1,000,000 张 ¥7,000
- 接入：兼容主流压缩 API 的认证与响应结构，换 base URL 与 Key 即可；能力边界：resize thumb、store 直传、AVIF 输出暂不支持

## 错误码表

| HTTP | error | 触发 | 用户提示 |
|---|---|---|---|
| 400 | BadRequest | 请求体为空、JSON 非法、参数越界 | 请求参数有误，这张图没有压缩成功。请重试，持续出现请联系 support@minipic.cn |
| 400 | InputMissing | 请求体缺少图片内容 | 文件内容为空，无法压缩。请检查文件后重新上传 |
| 401 | Unauthorized | Key 缺失 / 无效 / 停用 | API Key 无效或已停用。请检查 Key 是否正确，或到控制台重新创建 |
| 403 | AccountSuspended | 账户封禁 / 欠费 | 该账户已被限制使用。如有疑问，请联系 support@minipic.cn |
| 404 | NotFound | 路径错误 | 请求的资源不存在。请检查链接是否正确 |
| 404 | OutputExpired | 结果私有链接已过期 | 这个加密私有链接已过期，结果无法再访问。重新上传即可再次压缩 |
| 413 | PayloadTooLarge | 超过套餐单文件上限 | 这张图超过免费版单张 5 MB 上限。升级 Pro 可压缩最大 80 MB 的大图 |
| 415 | UnsupportedMediaType | 非 PNG / JPEG / WebP 输入 | 暂不支持这个格式，目前支持 PNG、JPEG、WebP、HEIC、GIF、BMP、TIFF、AVIF、SVG |
| 422 | DecodeError | 文件损坏、伪装扩展名 | 这张图片无法解码：文件可能已损坏，或不是有效的图片。请检查后重新上传 |
| 422 | ImageTooComplex | 超过 1 亿像素上限 | 图片超过 1 亿像素处理上限。请先缩小尺寸再压缩 |
| 422 | ContentBlocked | 内容安全拦截（不计费） | 未通过内容安全检测，已拦截并彻底删除，未计入用量。如认为是误判，请联系 appeal@minipic.cn |
| 429 | TooManyRequests | 限流 / 并发超限（带 Retry-After） | 请求太频繁，这张图暂时排不进队列。请稍等片刻再重试 |
| 429 | AccountLimitReached | 免费额度用尽且未绑支付（带 upgrade_url） | 今天的 100 张免费额度已用完。登录后不限每日次数（每月 1,000 张），Pro 单图最大 80MB |
| 429 | WebMonthlyLimitReached | 登录态网页当月压缩额度用尽（带 download_url，引导下载客户端） | 本月网页免费压缩额度已用完。下载客户端可不限次压缩，本地处理更快、更私密 |
| 500 | InternalServerError | 服务异常（带 request_id） | 服务出现异常，这张图没有压缩成功，请稍后重试 |
| 501 | NotImplemented | resize thumb 等未开放能力 | 这个功能暂未开放。请关注开发者文档的更新公告 |
| 503 | ServiceUnavailable | 过载 / 维护（带 Retry-After） | 服务正忙，这张图暂时没有压缩成功，请稍后重试 |

## 定价 FAQ

### 怎么计费？什么算「一张」？

只按「成功压缩」计数：产出可下载结果才算 1 张。失败、超限、审核拦截都不计。一张图同时输出原格式和 WebP 记 2 张；对结果追加 resize/convert 每个衍生输出计 1 张。

### 免费额度怎么重置？

均按北京时间重置：未登录 Web 端每日 100 张于每天 00:00 重置；登录后不限每日（每月 1,000 张）、API 每月 500 次，于每月 1 日 00:00 重置。

### 资源包会过期吗？

永不过期。扣费顺序：套餐月额度 → 资源包（先购先扣）。预付制，无按量月结——额度用尽即暂停，购买资源包即恢复。

### 「无限张数」有限制吗？

Pro 与团队版无每日上限，设有公平使用软上限 5,000 张/月（团队按席位计）：超出后仅降低排队优先级，不拦断、不额外收费。

### 支持哪些付款方式？能开发票吗？

微信支付（Pro 订阅为微信自动续费扣款）。所有付费订单可申请电子普通发票（T+7 个工作日内开出）；企业认证后可开增值税专用发票、支持对公转账。

### 会自动扣款吗？到期会怎样？

Pro 为自动续费订阅：开通后每个计费周期通过微信支付自动扣款续费，每次扣款前提前提醒。你可随时在控制台取消，取消后不再扣款、当前权益保留至到期日；若自动扣款失败，将进入宽限期重试，宽限期内仍未成功才降为免费版，数据与 API Key 保留、仅限额变化。

### 可以退款吗？

年付订阅自支付起 7 天内未使用可全额退款，联系客服办理；具体以《自动续费服务协议》与用户协议为准。