feat(compress): improve quality guardrails and format conversion
This commit is contained in:
@@ -274,9 +274,10 @@ Idempotency-Key: <key> # 建议
|
||||
| `file` | File | 是 | 图片文件 |
|
||||
| `compression_rate` | Integer | 否 | 压缩率 1-100(压缩后体积占原图比例,数值越小压缩越强,100 表示不压缩),优先级高于 `level` |
|
||||
| `level` | String | 否 | `high` / `medium` / `low`(兼容参数,默认 `medium`) |
|
||||
| `output_format` | String | 否 | 已停用,仅支持保持原格式 |
|
||||
| `output_format` | String | 否 | 输出格式:`png/jpeg/webp/avif/gif/bmp/tiff/ico`(默认保持原格式) |
|
||||
| `max_width` | Integer | 否 | 最大宽度(等比缩放) |
|
||||
| `max_height` | Integer | 否 | 最大高度(等比缩放) |
|
||||
| `target_size_bytes` | Integer | 否 | 目标体积(字节),仅 `jpeg/webp/avif` 输出支持;会优先保清晰度并在必要时小幅缩放 |
|
||||
| `preserve_metadata` | Boolean | 否 | 是否保留元数据(默认 `false`) |
|
||||
|
||||
响应:
|
||||
@@ -309,6 +310,8 @@ X-API-Key: <your-api-key> # 或 Bearer token(不建议匿名)
|
||||
Idempotency-Key: <key> # 建议
|
||||
```
|
||||
|
||||
表单字段与 `/compress` 一致(包括 `output_format`、`target_size_bytes`)。
|
||||
|
||||
成功响应:
|
||||
- HTTP `200`
|
||||
- Body:压缩后的图片二进制
|
||||
@@ -339,7 +342,7 @@ Idempotency-Key: <key> # 建议
|
||||
| `files[]` | File[] | 是 | 图片文件数组(上限由套餐决定) |
|
||||
| `compression_rate` | Integer | 否 | 压缩率 1-100(压缩后体积占原图比例,数值越小压缩越强,100 表示不压缩),优先级高于 `level` |
|
||||
| `level` | String | 否 | `high` / `medium` / `low`(兼容参数) |
|
||||
| `output_format` | String | 否 | 已停用,仅支持保持原格式 |
|
||||
| `output_format` | String | 否 | 输出格式:`png/jpeg/webp/avif/gif/bmp/tiff/ico`(默认保持原格式) |
|
||||
| `preserve_metadata` | Boolean | 否 | 是否保留元数据(默认 `false`) |
|
||||
|
||||
响应:
|
||||
|
||||
@@ -44,7 +44,7 @@
|
||||
核心组件:
|
||||
- 顶栏:Logo + `/pricing` `/docs` + 登录/注册(登录后显示头像菜单)
|
||||
- 上传区:拖拽 + 点击选择 + 限制提示(格式/大小/数量)
|
||||
- 参数区:压缩率(压缩后体积占比)、尺寸限制、元数据开关(输出格式保持原图)
|
||||
- 参数区:压缩率(压缩后体积占比)/目标体积、输出格式、尺寸限制、元数据开关
|
||||
- 结果区:文件列表(缩略图、大小、节省%、状态、下载/重试)
|
||||
- 汇总区:总节省、下载 ZIP、清空
|
||||
- 信任区:隐私说明(默认去 EXIF)、保留期说明、状态页/联系入口
|
||||
|
||||
Reference in New Issue
Block a user