n8n图片处理：ConvertIMG节点完全指南

n8n 的 ConvertIMG 节点可以在你的自动化工作流中处理图片格式转换。它连接 ConvertIMG API，让你不用写任何代码就能在不同格式之间转换图片。

这篇指南详细介绍节点的每一个设置。包括输入选项、输出格式、质量控制，以及如何把它接入更复杂的工作流。如果你是第一次使用 n8n 自动化，建议先看看我们的分步工作流教程。

ConvertIMG 节点能做什么？

ConvertIMG 节点的核心功能很简单：把一种格式的图片转换成另一种格式。

它支持的输入格式包括：

• JPG/JPEG — 最常见的照片格式
• PNG — 无损格式，支持透明背景
• WebP — 谷歌的现代图片格式
• HEIC/HEIF — 苹果 iPhone 默认的照片格式
• AVIF — 最新的高压缩率格式
• TIFF — 摄影和印刷中常用

可以输出为：

• JPG — 兼容性最强
• PNG — 无损压缩，支持透明背景
• WebP — 体积和画质的最佳平衡
• AVIF — 文件最小，现代浏览器支持
• TIFF — 无损压缩，适合存档和印刷

除了格式转换，节点还能处理：

• 质量调整。 控制压缩级别，范围从 1 到 100。
• 元数据剥离。 移除 EXIF 数据，包括 GPS 定位、相机信息和时间戳。
• HEIC 自动转换。 iPhone 的 HEIC 格式照片可以自动处理。

这个节点专注做好一件事：可靠、快速地转换图片。想了解更多自动化方案，可以看看我们的图片转换自动化完全指南。

怎么安装和配置这个节点？

安装过程大约 5 分钟。

安装步骤：

1. 打开你的 n8n 实例。
2. 进入 Settings > Community Nodes。
3. 在 npm 注册表搜索栏中搜索 ConvertIMG。
4. 点击 Install。节点会出现在节点面板的"Image"分类下。

凭证设置：

1. 进入 Settings > Credentials。
2. 点击 Add Credential。
3. 从列表中选择 ConvertIMG API。
4. 输入你的 API 密钥。可以在你的 ConvertIMG 控制台获取。
5. 给凭证取个名字（比如"ConvertIMG Production"）。
6. 点击 Test Connection 验证是否正常。
7. 保存。

在工作流中添加节点：

1. 打开任意一个工作流。
2. 点击 + 按钮添加节点。
3. 搜索"ConvertIMG"。
4. 把它拖到画布上。
5. 在节点设置中选择你的凭证。

节点现在已经可以使用了。连接一个数据源，配置设置，然后运行就行。

节点接受哪些参数？

节点有四个可以控制的设置。

输出格式（必填）

选择转换的目标格式。选项包括：jpg、png、webp、avif、tiff。

根据你的使用场景来选。WebP 是网页图片的最佳默认选择。它能让文件比 JPG 小 25-35%，而视觉质量基本一样。AVIF 更进一步，可以节省高达 50%。

如果是印刷或存档用途，选择 PNG 或 TIFF 保留完整质量。

质量（可选，默认值：90）

控制压缩级别。接受 1 到 100 的值。数值越高，质量越好，文件越大。

不同场景的推荐设置：

使用场景	质量	备注
主图、产品照片	85-95	保持细节清晰
博客配图、常规内容	75-85	很好的平衡点
缩略图、预览图	60-75	小体积更重要
背景纹理	50-70	细节不太关键

注意：PNG 输出时这个设置会被忽略。PNG 使用无损压缩，质量参数不适用。

移除元数据（可选，默认：是）

启用后，会剥离输出文件中的所有 EXIF 数据。包括：

• 相机品牌和型号
• GPS 坐标
• 拍摄日期和时间
• 编辑图片使用的软件
• 版权信息

为什么要剥离元数据？ 保护隐私。如果你在处理用户上传的图片，你肯定不想存储或展示他们的 GPS 位置。元数据还会增加文件大小，通常每张图 10-50 KB。

什么时候保留元数据？ 存档场景。如果你在建立照片库，元数据很有价值。摄影师需要相机设置和时间戳。当保留元数据很重要时，把这个选项设为"否"。

二进制属性（必填）

告诉节点要处理哪个二进制数据。n8n 以二进制属性的形式把文件附加到数据项上。默认名称是 data，大多数情况下都适用。

如果你的工作流有多个二进制附件（比如一张图片和一个 PDF），你需要指定要转换哪一个。使用输入数据项的二进制数据部分显示的确切属性名。

怎么把节点和其他步骤串联起来？

ConvertIMG 节点作为更大工作流的一部分时效果最好。以下是常见的使用模式。

下载 → 转换 → 上传

最基础的流水线。文件从云存储节点（Google Drive、S3、Dropbox）传入。ConvertIMG 节点转换格式。上传节点保存结果。

[Google Drive: 下载] → [ConvertIMG: 转换为 WebP] → [S3: 上传]

多格式输出

有时候你需要同一张图片输出多种格式。可以用两次 ConvertIMG 节点配置不同的设置，或者用 Split 节点创建并行路径。

[下载] → [拆分为 2 项]
  → 路径 A: [ConvertIMG: WebP 质量 85] → [上传到 /webp/]
  → 路径 B: [ConvertIMG: AVIF 质量 80] → [上传到 /avif/]

这在需要同时提供 WebP 和 AVIF 的网站项目中很常见。

条件转换

用 IF 节点在转换前检查文件属性。不同文件类型导向不同的设置。

[下载] → [IF: 文件扩展名 = .png?]
  → 是: [ConvertIMG: PNG → WebP 质量 90]
  → 否: [ConvertIMG: JPG → WebP 质量 85]

PNG 文件通常需要更高的质量设置，因为它们可能包含边缘锐利的图形。JPG 照片在较低质量下看起来也没问题。

Webhook 驱动的转换

你的网站应用在用户上传图片时发送一个 webhook 到 n8n。工作流从 webhook 请求中的链接下载文件，转换格式，上传，然后通过 webhook 响应返回新的链接。

[Webhook] → [HTTP 请求: 下载图片] → [ConvertIMG] → [S3: 上传] → [Webhook 响应]

这相当于把 n8n 变成了你应用的图片转换微服务。

节点能和其他 n8n 集成一起用吗？

n8n 的精髓就在于万物互联。ConvertIMG 节点可以和整个 n8n 生态无缝配合。

存储节点： Google Drive、Dropbox、S3、FTP、本地文件系统。从任何来源拉取图片，把结果推送到任何目的地。

通信节点： Slack、邮件、Telegram、Discord。转换完成时收到通知，或者出错时收到提醒。

数据库节点： MySQL、PostgreSQL、MongoDB、Airtable。记录转换结果。追踪已处理的文件。存储转换后图片的 CDN 链接。

定时任务： 用 Cron 节点按计划运行转换。比如每天午夜处理所有新图片。

HTTP 节点： 调用任何 API。从 URL 下载图片。把结果发送到 webhook。这样就能把 ConvertIMG 节点和那些没有专用 n8n 节点的服务连接起来。

Code 节点： 对于特殊情况，用 Code 节点写自定义的 JavaScript。你可以用它来转换文件名、计算体积节省或根据自定义逻辑筛选文件。

使用这个节点有哪些最佳实践？

跟着这些建议来，你的工作流会更稳定、更高效。

先建一个测试工作流。 搭一个简单的下载 → 转换 → 上传流水线，用几张图片测试一下，确认输出质量符合你的期望后再扩大规模。

用表达式生成文件名。 不要硬编码输出文件名。用 n8n 表达式根据输入文件自动生成名称。例如：{{$json.fileName.replace('.jpg', '.webp')}}。处理大量文件时，这能保持整齐有序。

启用错误处理。 在工作流中添加 Error Trigger 节点。连接到 Slack 通知或邮件。转换失败时，你需要立刻知道。

设置重试逻辑。 网络问题难免发生。在 ConvertIMG 节点上启用"Retry on Fail"，设置 2-3 次重试，间隔 10 秒。这能优雅地处理临时超时。

不要反复在有损格式之间转换。 如果一张图已经被 JPG 压缩过，再转成 WebP，然后又转回 AVIF，画质会连续下降两次。永远从你手头最高质量的源文件开始转换。

根据用途匹配质量。 不要给缩略图设 95% 的质量。也不要给主图设 60% 的质量。为不同的图片尺寸和用途设置单独的工作流路径。

监控 API 用量。 ConvertIMG API 根据你的套餐有使用配额。添加一个 Set 节点记录每次转换。每周检查一次用量，确保没有超标。

结合其他图片工具。 ConvertIMG 节点负责格式转换，但你可以在 n8n 中搭建一条完整的图片处理流水线。添加 CompressIMG 在转换后进一步压缩文件体积 — 从社区节点安装CompressIMG n8n节点。用 UpscaleIMG 在转换前提升低质量源图的分辨率 — UpscaleIMG n8n节点的工作方式相同。三个工具串在一个工作流里，就是一条完整的图片处理流水线。

想看分步工作流示例，请查看我们的 n8n 自动化指南。关于节点背后的 API 详情，请参考 API 集成指南。