# @cloudconvert/n8n-nodes-cloudconvert 中文文档

规范地址：https://npmcn.com/package/%40cloudconvert/n8n-nodes-cloudconvert/

版本：1\.1\.4
npm 元数据更新时间：2026-10-24T12:13:45.458Z
中文译文更新时间：2026-11-10T02:49:25.661Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cloudconvert/n8n-nodes-cloudconvert
原文对照：https://npmcn.com/package/%40cloudconvert/n8n-nodes-cloudconvert/?lang=original
项目主页：https://cloudconvert.com/
源码仓库：https://github.com/cloudconvert/n8n-nodes-cloudconvert

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：234 kB，74 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- peer 依赖：n8n-workflow \*
- 首次发布：2023-05-15T16:55:21.740Z
- 最新版本发布：2026-10-24T12:13:45.110Z
- 近 30 天下载量：11225（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 5 个）

## 中文简介

cloudConvert的n8n节点 - 一个在线文件转换和处理API,它允许转换文件,创建缩略图,合并文件,添加水印等!

## 安装

```sh
npm install @cloudconvert/n8n-nodes-cloudconvert
```

也可以使用：`pnpm add @cloudconvert/n8n-nodes-cloudconvert`、`yarn add @cloudconvert/n8n-nodes-cloudconvert`、`bun add @cloudconvert/n8n-nodes-cloudconvert`

## README

# n8n-节点-云形转换

这是一个n8n社区节点. 它让你使用 [云旋转](https://cloudconvert.com/) 您的 n8n 工作流程.

CloudConvert是一个在线文件转换和处理API,它允许转换文件,创建缩略图,合并文件,添加水印等!

[无 8n](https://n8n.io/) 是一个 [获得公平代码许可](https://docs.n8n.io/reference/license/) 工作流程自动化平台.

[安装](https://npmcn.com/package/%40cloudconvert/n8n-nodes-cloudconvert/#readme-installation)  
[业务](https://npmcn.com/package/%40cloudconvert/n8n-nodes-cloudconvert/#readme-operations)  
[全权证书](https://npmcn.com/package/%40cloudconvert/n8n-nodes-cloudconvert/#readme-credentials)  
[兼容性](https://npmcn.com/package/%40cloudconvert/n8n-nodes-cloudconvert/#readme-compatibility)  
[使用量](https://npmcn.com/package/%40cloudconvert/n8n-nodes-cloudconvert/#readme-usage)  
[资源](https://npmcn.com/package/%40cloudconvert/n8n-nodes-cloudconvert/#readme-resources)  
[版本历史](https://npmcn.com/package/%40cloudconvert/n8n-nodes-cloudconvert/#readme-version-history)

## 安装

跟着 [安装指南](https://docs.n8n.io/integrations/community-nodes/installation/) 在n8n社区节点文档中.

1.  转到 **设置 > 社区节点**。 。 。 .
2.  选择 **安装**。 。 。 .
3.  输入 `@cloudconvert/n8n-nodes-cloudconvert` 内 **输入 npm 包名**。 。 。 .
4.  同意 [风险](https://docs.n8n.io/integrations/community-nodes/risks/) 使用社区节点:选择 **我了解从公共来源安装未经验证的密码的风险**。 。 。 .
5.  选择 **安装**。 。 。 .

在安装了节点后,可以像其他节点一样使用. n8n 在搜索结果中显示节点 **节点** 显示面板.

## 业务

它支持这些行动:

-   从一种格式转换文件到另一种格式
-   创建文件缩略图
-   在图像、 PDF 和视频中添加水印
-   抓取网站截图并保存网站为 PDF
-   将多个输入文件合并为一个 PDF
-   为多个输入文件创建档案( ZIP, RAR. )
-   获取文件元数据( EXIF等)
-   用简单的语言描述您的文件会发生什么, AI代理处理它(β)

## 全权证书

创建一个免费的 CloudConvert 账户 [这里](https://cloudconvert.com/register) 每天可以免费获得25个信贷.

-   在此生成 OAuth 2 证书( 默认认证方法) : [https://cloudconvert.com/dashboard/api/v2/ 客户端](https://cloudconvert.com/dashboard/api/v2/clients)
-   在此生成一个 API 密钥( 备选认证方法) : [https://cloudconvert.com/dashboard/api/v2/键](https://cloudconvert.com/dashboard/api/v2/keys)

## 兼容性

对n8n版本0.225+进行了测试.

## 使用量

使用这个节点的典型工作流程会像这样: ![image](https://github.com/n8n-io/n8n/assets/1945577/3cd6f332-74ee-4997-8e67-7d873a124592)

这是一个将多个输入文件合并在一个 PDF 中的工作流程 : ![image](https://github.com/n8n-io/n8n/assets/1945577/9324c941-eb86-48ac-8d83-aaeecf16fd09)

## 资源

-   [n8n 社区节点文档](https://docs.n8n.io/integrations/community-nodes/)
-   [Cloud 转换 API v2 文档](https://cloudconvert.com/api/v2)

## 常见问题

### @cloudconvert/n8n-nodes-cloudconvert 是什么？

cloudConvert的n8n节点 - 一个在线文件转换和处理API,它允许转换文件,创建缩略图,合并文件,添加水印等\!

### 如何安装 @cloudconvert/n8n-nodes-cloudconvert？

在项目目录运行 npm install @cloudconvert/n8n-nodes-cloudconvert，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：n8n-workflow（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @cloudconvert/n8n-nodes-cloudconvert 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cloudconvert\_\_n8n-nodes-cloudconvert 是否存在。

### @cloudconvert/n8n-nodes-cloudconvert 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @cloudconvert/n8n-nodes-cloudconvert 可以商用吗？

@cloudconvert/n8n-nodes-cloudconvert 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @cloudconvert/n8n-nodes-cloudconvert 的下载量有多少？

根据 npm 官方下载统计，@cloudconvert/n8n-nodes-cloudconvert 在 2026/10/10 – 2026/11/08 这 30 天内被下载 11,225 次，日均约 374 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cloudconvert/n8n-nodes-cloudconvert 还在维护吗？

最新版本 1\.1\.4 发布于 2026/10/24（16 天前）；至今共发布 8 个版本，其中过去 12 个月发布了 5 个；首次发布于 2023/05/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

