跳到主要内容
PDF4me API集成知识库扩展API 测试员博客

图像压缩 API：使用 Postman 逐步测试以减小 JPG 图片尺寸

· 阅读需 11 分钟
Sankalp Mishra
SEO and Content Writer

大尺寸图片会降低页面加载速度，增加带宽费用，并产生其他不利影响。 核心网络指标： 尤其 最大内容颜料（LCP） 当一张大幅照片是主要元素时。 图像压缩 API 允许您在管道（上传处理程序、CMS 导入、DAM 工作流程）中缩小 JPG/PNG 有效负载，而无需手动修复文件。

本教程使用 PDF4me POST /api/v2/CompressImage 和 邮差一旦请求结构清晰，同样的模式也适用于代码。 无代码首次测试使用交互式 压缩图像 API 测试器它使用表单字段而不是原始 JSON 来访问同一个端点。

如何阅读本指南
  • 按照步骤操作 1 → 5; 屏幕截图与实际运行相符（您的运行时间和字节计数会因图像内容和网络而异）。
  • 替换 Postman 占位符 {{BASE64_OF_INPUT_IMAGE}} 使用 Base64 编码 你的 文件，无 data:image/jpeg;base64, JSON字符串中的前缀。
  • 成功调用后，解码响应 .jpg 并进行比较 资源管理器中的文件大小 （或 macOS Finder）到原始位置。
简短版

1. 对图像进行 Base64 编码 → 2. 邮政 https://api.pdf4me.com/api/v2/CompressImage 和 Content-Type: application/json 和 授权 （您的 PDF4me API 密钥）→ 3. JSON 正文： 文档内容， 文档名称， 图像类型， 压缩级别， 异步 → 4. 预计 200 OK 以及一个 JPEG 有效载荷（原始字节或 Base64 编码，取决于客户端的显示方式）→ 5. 保存并比较磁盘文件大小与源文件大小。

团队为何使用图像压缩 API（市场背景）​

优先事项API 会带来哪些变化？
网站性能较小的图像解码速度更快，传输速度也更快，这在 LCP 依赖于单个大型资产时非常重要。
用户体验图片体积小、交互延迟低，页面在移动设备上加载更稳定。
运营一个 HTTP 协议即可满足微服务、无服务器上传处理程序和 ETL 作业的需求，无需任何桌面工具。
成本与到处提供数MB原始文件相比，减少文件输出和存储。

PDF4me 暴露 压缩水平 （最大限度， 中等的， 低的这样您就可以将缩略图与主图对齐。请参阅参数概述。 压缩图像（完整 API 参考） 以及下面的简表。

在你发送第一个请求之前​

检查清单
  1. API密钥： 从 PDF4me 控制面板 （用于 授权 每页标题 官方文件）。
  2. 输入格式： JPG 或 PNG（见 API 测试 参数说明）。
  3. 文件过大/超时： 放 "异步": true 建议时，或进行预处理 调整图像大小 如果像素远远超过显示尺寸。
  4. 配额： 身份验证失败或套餐限制，请使用 PDF4me故障排除 如果您看到 401/402 类型的错误。

参考：JSON 正文字段​

场地角色
文档内容源图像的 Base64 编码（必需）。
文档名称输出文件名，例如： output.jpg （必需的）。
图像类型输出格式，例如： JPG 或者 PNG。
压缩级别最大限度， 中等的， 或者 低的。
异步真的 / 错误的当处理时间可能超过客户端超时时间时，请使用异步方式。

步骤 1：从一个真实的“之前”的文件开始​

练习时请使用任意大尺寸 JPG 图片。以下参考运行使用了一张大尺寸 JPG 图片。 约 4.5 MB 名为 input.jpg 在 Windows 资源管理器中，文件夹大小足够大，以至于压缩在文件夹属性中能明显体现出来。

在调用压缩 API 之前，Windows 资源管理器会显示一个较大的 JPG 输入文件（约 4.48 MB）。

步骤 2：配置 Postman 请求（方法 + URL）​

打开 标题 标签页。至少你需要 Content-Type: application/json 以及您的 PDF4me 密钥 Authorization （请将截图中的占位符替换为您的真实密钥）。

Postman 压缩图像的标头选项卡：POST URL 和授权

步骤 3：设置原始 JSON 主体​

选择 正文 → 原始数据 → JSON然后粘贴如下格式的有效载荷（替换为您的 Base64 字符串）。

Postman 正文选项卡包含 docContent、docName、imageType、compressionLevel 和 async 属性。

{
 "docContent": "PASTE_BASE64_HERE_NO_DATA_URL_PREFIX",
 "docName": "output.jpg",
 "imageType": "JPG",
 "compressionLevel": "Max",
 "async": false
}
选修的： 点击“发送”前进行最基本的健全性检查。
  • JPEG Base64 通常以……开头 /9j/ 当该工具显示字符串形式时，该字符串对应于 JPEG 文件签名。
  • 如果 Postman 运行缓慢，请求仍有可能成功，请注意观察。 200 OK 并保存输出；考虑 异步：是 用于生产批量作业。
  • 要使用引导式表单而不是 JSON，请打开 在 API 测试器中压缩图像 并排比较相同的字段。

第四步：发送并阅读回复​

当客户端显示 Base64 时​

如果 身体 查看器已设置为 Base64 你看到一条长长的队伍，以……开头 /9j/有效载荷是经过编码的JPEG数据，用于显示。将其解码成文件，并在图像查看器中打开以确认质量。

Postman 返回 200 OK，响应体被解析为 Base64 JPEG 编码。

当客户端显示原始二进制文件时​

某些视图渲染 生的 字节（元数据，例如 XMP，可能以可读文本的形式出现在数据流中）。 200 OK 仍然意味着已返回压缩图像，请将主体保存为 output.jpg 使用客户的“保存回复”选项。

Postman 返回 200 OK，包含原始响应体（二进制/元数据可见）

步骤 5：比较磁盘上“修改后”的文件大小​

将响应写入磁盘后，请检查 特性 再次。在参考运行中，压缩文件落在了附近 约 2.6 MB：在保持工作流程简单的同时，有效减少几兆字节照片的大小。具体比例取决于内容、尺寸和…… 压缩级别; 尝试 中等的 或者 低的 如果 最大限度 对于产品拍摄来说，这种风格过于激进。

API 调用后，Windows 资源管理器显示压缩后的 output.jpg 文件大小

故障排除（快速）​

401 / 身份验证错误

确认密钥 授权 并且密钥已激活。请看 API文档 和 故障排除。

超时或调用速度非常慢

尝试 "异步": true 如果支持，或者先减小像素尺寸 调整图像大小。

“损坏的”或空的输出

条 data:image/...;base64, 来自前缀 文档内容删除 Base64 字符串中的换行符，并验证源文件是否可以在本地打开。

无需 Postman 即可实现自动化​

相关阅读​

尝试压缩图像（API 测试器）

完整 API 参考

获取 API 密钥

概括： 一个 图像压缩 API 它与响应式图片和 CDN 缓存属于同一工具箱：它从源头减少字节数，从而使下游的每个步骤都更便宜、更快速。从……开始 API 测试员按照上述步骤在 Postman 中重现请求，然后在准备发布时将 JSON 提升到您的服务或自动化模块中。