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

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

版本：0\.2\.4
npm 元数据更新时间：2026-11-06T05:53:57.347Z
中文译文更新时间：2026-11-09T21:29:49.255Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：235 kB，134 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=24
- 运行依赖：0 个
- peer 依赖：n8n-workflow \*
- 首次发布：2026-07-17T02:16:16.533Z
- 最新版本发布：2026-11-06T05:53:56.979Z
- 近 30 天下载量：1718（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 14 个）

## 中文简介

N8n的 Canva API 集成. 创建、编辑和导出设计、文件夹及其他内容.

## 安装

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

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

## README

# n8n- 节点- 扫描

![Banner](https://npmcn.com/package/%40canva/n8n-nodes-canva/.github/assets/github-banner.jpg)

在您的 n8n 工作流程中使用 Canva 。 创建,自动填充和导出设计,管理您的资产和文件夹,并使用Canva的AI生成设计和图像,去除背景,或将平面图像变成可编辑设计.

此节点使用 [Canva REST APIs (英语)](https://www.canva.dev/docs/apps/rest-apis/) (前作"连接API".

-   [安装](https://npmcn.com/package/%40canva/n8n-nodes-canva/#readme-installation)
-   [全权证书](https://npmcn.com/package/%40canva/n8n-nodes-canva/#readme-credentials)
-   [业务](https://npmcn.com/package/%40canva/n8n-nodes-canva/#readme-operations)
-   [很高兴知道](https://npmcn.com/package/%40canva/n8n-nodes-canva/#readme-good-to-know)
-   [本地运行](https://npmcn.com/package/%40canva/n8n-nodes-canva/#readme-run-it-locally)
-   [资源](https://npmcn.com/package/%40canva/n8n-nodes-canva/#readme-resources)

## 安装

遵循 n8n 的向导 [安装社区节点](https://docs.n8n.io/integrations/community-nodes/installation-and-management),使用软件包名称 `@canva/n8n-nodes-canva`。 。 。 .

## 全权证书

要连接 n8n 到 Canva, 您会在 Canva 开发者门户网站中创建一个应用程序, 然后将其细节粘贴到 n8n 中 。 大约需要5分钟.

### 1\. 在 Canva 开发者门户网站创建应用程序

1.  转到 [**你的应用程序**](https://www.canva.com/developers/apps) 在 Canva 开发者门户网站中创建新应用程序。 选择 **私营** 如果你的团队在Canva Entertainment(应用程序留在你的团队内),或 **公开** 否则。 你以后不能改变这一点.
    
2.  打开 **在坎瓦岛外** 并单击 **开始整合**。 。 。 .
    
3.  打开 **罐头外- 配置**数字 :
    
    -   打开 **Canva REST APIs (英语)**。 。 。 .
        
    -   下 **全权证书**,复制 **客户身份**,然后单击 **生成秘密** 并抄取秘诀也. Canva只展示过一次秘密 所以要小心.
        
    -   下 **范围**,打开所有这些:
        
        -   `asset`: 读写
        -   `brandtemplate:content`: 读写
        -   `brandtemplate:meta`: 读取
        -   `comment`: 读写
        -   `design:content`: 读写
        -   `design:meta`: 读取
        -   `folder`: 读写
        -   `profile`: 读取
        
        节点在连接时会要求全部连接,如果缺少任何连接,坎瓦会拒绝连接.
        
4.  打开 **Canva 外部 – 重新定向 URL**,粘贴 n8n 的 URL 重定向到 **網址 1**. 您可以在 n8n 证书显示屏中找到它( 下面的第2步) 。 通常看起来是这样的:
    
    -   **n8n 云:" n"作"克"** `https://oauth.n8n.cloud/oauth2/callback`
    -   **自办n8n:** `https://your-n8n-instance.com/rest/oauth2-credential/callback`
    -   **电脑上的n8n:** `http://127.0.0.1:5678/rest/oauth2-credential/callback` (加拿大不会接受) `localhost`,因此使用 `127.0.0.1`(中文(简体) )

### 2\. 用n8n连接

1.  在n8n,去吗 **全权证书 新** 选择 **Canva OAuth2 API (英语)**。 。 。 .
2.  粘贴 **客户身份** 财务报告和审定财务报表 **客户端秘密** 从第1步.
3.  点击 **连接我的账户** 并批准进入坎瓦.

## 业务

下面是几个标签:

-   _(审查)_:使用Canva的一个预览API. 见 [预览 API](https://npmcn.com/package/%40canva/n8n-nodes-canva/#readme-preview-apis)。 。 。 .
-   需要付费的Canva计划,比如Canva Pro.
-   QQ:使用Canva用户的AI信用. 见 [AI 学分](https://npmcn.com/package/%40canva/n8n-nodes-canva/#readme-ai-credits)。 。 。 .

### 资产

| 运行 | 它会做什么 |
| --- | --- |
| 删除 | 删除资产 |
| 获取 | 获取资产的细节 |
| 更新 | 重命名资产或更改其标签 |
| 从 URL 上传 | 从公共 URL 上传图像或视频 |

### 自动填充

> 需要一个Canva Pro计划或以上.

| 运行 | 它会做什么 |
| --- | --- |
| 创建 | 用您的数据填入一个品牌模板, 以进行新的设计 |

### 品牌模板

> Canva计划需要具有溢价特征,例如Canva Pro.

| 运行 | 它会做什么 |
| --- | --- |
| 获取 | 获得品牌模板的细节 |
| 获取数据集 | 获取可以自动填入品牌模板的字段 |
| 获得多个 | 列出您可以使用的品牌模板 |
| 发布 _(审查)_ | 将设计发布为品牌模板 |

### 注释 _(预览API)_

| 运行 | 它会做什么 |
| --- | --- |
| 创建回复 | 对评论线索的答复 |
| 创建线索 | 启动对设计的评论线程 |
| 获取回复 | 从线索中获取一个回复 |
| 获取线索 | 获取注释线索 |
| 清单答复 | 在线索中列出答复 |

### 设计

| 运行 | 它会做什么 |
| --- | --- |
| 创建 | 创建空白设计, 并附带图像 |
| 获取 | 获取设计的细节 |
| 获取数据集 | 获取设计中可以自动填充的字段 |
| 获取导出格式 | 查看可以导出设计的文件格式 |
| 获得多个 | 列出您的设计 |
| 获取页面 _(审查)_ | 在设计中获取每个页面的细节 |

### 设计导入

| 运行 | 它会做什么 |
| --- | --- |
| 从图像导入 _(审查)_ | QQ 将平面图像转换为带有"魔法层"的可编辑设计 |
| 从 URL 导入 | 从 PPTX 或 PDF 等公共 URL 导入文件作为设计 |

### 导出

| 运行 | 它会做什么 |
| --- | --- |
| 导出设计 | 导出一个设计为 PDF, PNG, JPG, GIF, MP4, PPTX 等, 并获得下载链接 |

### 文件夹

| 运行 | 它会做什么 |
| --- | --- |
| 创建 | 创建文件夹 |
| 删除 | 删除文件夹 |
| 获取 | 获取文件夹的细节 |
| 清单项目 | 列出文件夹中的内容 |
| 移动项目 | 将一个设计、图像或文件夹移动到另一个文件夹 |
| 更新 | 重命名文件夹 |

### 生成 _(预览API)_

| 运行 | 它会做什么 |
| --- | --- |
| 生成设计 | 从书面简报创建演示文稿或 Canva Doc |
| 生成图像 | QQ 从文本提示创建图像 |

### 图像转换 _(预览API)_

> Canva计划需要具有溢价特征,例如Canva Pro.

| 运行 | 它会做什么 |
| --- | --- |
| 删除背景 | QQ 从图像中删除背景并保存为新图像 |

### 合并 _(预览API)_

| 运行 | 它会做什么 |
| --- | --- |
| 创建合并任务 | 将其他设计的页面合并到一个新的网页,或者重新安排现有设计 |

### 调整大小

> QQ需要具有溢价功能的Canva计划,如Canva Pro. Canva Free用户获得有限的试玩.

| 运行 | 它会做什么 |
| --- | --- |
| 创建任务大小 | 用新尺寸复制设计 |

### 用户

| 运行 | 它会做什么 |
| --- | --- |
| 获取能力 | 查看连接用户可以使用的 Canva 特性 |
| 给我接 | 获取连接的用户身份和团队身份 |
| 获取配置 | 获取连接用户的显示名 |

## 很高兴知道

### 等待 Canva 结束

一些操作在Canva开始一个任务并等待它完成: 从 URL 上传, Autofill, 既导入, 输出, 合并, 调整大小, 以及所有 AI 特性. 在等待期间,节点每隔几秒钟检查一次(**扑克间**),并在一段时间后放弃(**马克思 等等**,60至300秒默认,取决于操作). 大型工作,如长篇演讲,需要几分钟时间.

如果工作失败,错误告诉你坎瓦的原因,比如一个没有通过坎瓦安全检查的提示.

### 当Canva很忙,或者配额用光了

如果Canva说收到太多请求,节点会等待并再次尝试,最多三次. 如果用户已经用完AI信用,Canva应用已经用完了自己的信用配额,或者用户已经用完了他们的免费自动填充或调整大小的试运行,等待也无济于事,因此节点会立刻停止并说.

### 预览 API

操作标记 _(审查)_ 使用仍在预览中的 Canva API 。 他们可以不经通知而更改,使用他们的应用程序不能提交Canva公开审查. 它们对于内部的工作流程和实验很有用.

### AI 学分

**从图像导入**, (中文(简体) ), **生成设计**, (中文(简体) ), **生成图像**,以及 **删除背景** 每次运行时都会使用Canva用户的AI信用. 检查运行中的工作是免费的.

并不是每个账户都可以使用每个AI特性. **用户 − 获得能力** 列出连接的用户可以做什么, 例如 `image_to_design_imports` (磁层), `background_removal`,以及 `design_generation`。 。 。 .

### 提示

-   **自动填充 :** 运行 **Brand Template — 获取数据集** 先说 您的数据的字段名称需要匹配模板的字段 .
-   **从图像( 磁层) 导入 :** 在平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平平 先上传图像 **资产 — 从 URL 上传**,然后使用其ID: `{{ $json.job.asset.id }}`在您的团队的 Canva 设置中必须允许魔法层 .
-   **删除背景 :** 保存结果为新图像,并留下原作。 新图像的ID在 `job.result.asset.id`。 。 。 .
-   **生成设计 :** 你讲的越多 有关话题,观众,措辞,语气, 看,结果越好。 对于演示文稿,您也可以用 **大纲**,使用 Canva 格式: `{"sections": [{"title": "…", "description": "…", "points": ["…"]}]}` (最多100个幻灯片). 离开 `sections` 空地让Canva决定。 如果较早的节点只给出幻灯片列表,请使用 `{{ { "sections": $json.slides } }}`打开新设计 `job.result.design.urls.edit_url` (链接工作30天).
-   **生成图像 :** 离开 **型号** 打开 **自动** 除非你需要一个特定的。 图像默认保存到用户的上传, 这样您就可以使用 `job.result.image.asset.id` 内 **设计 — 创建** 或者说 **自动填充**。下载链接于 `job.result.image.url` 工作24小时。 要将文件传递到另一个节点, 请用一个 **HTTP 请求** 节点.
-   **移动项目 :** 使用情况 `root` 作为 **转到文件夹ID** 移动到您的项目的顶层.

## 本地运行

对于想要在这个节点上工作的开发者.

你需要节点,js24.15 或以后和npm。 然后运行 :

```bash
npm install
npm run dev
```

此构建节点并启动 n8n 于 [http://127.0.0.1:5678 (中文(简体) )](http://127.0.0.1:5678/) 装入了Canva节点并打开了热重装。 当你设置你的 Canva 应用程序,使用 `http://127.0.0.1:5678/rest/oauth2-credential/callback` 作为重定向 URL.

**若为 `npm run dev` 失败 `EACCES: permission denied, rename ...` 内 `~/.npm/_cacache`数字 :** 您的 npm 缓存有其它用户拥有的文件, 通常通过运行 npm 留下 `sudo`。获取缓存的所有权,然后再次尝试:

```bash
sudo chown -R $(id -u):$(id -g) ~/.npm
```

## 资源

-   [示例工作流程](https://npmcn.com/package/%40canva/n8n-nodes-canva/examples/),准备导入
-   [Canva REST APIs (英语)](https://www.canva.dev/docs/apps/rest-apis/) 编辑 [REST API 参考文献](https://www.canva.dev/docs/apps/reference/)
-   [Canva 开发者门户网站](https://www.canva.com/developers/apps)
-   [n8n 社区节点文档](https://docs.n8n.io/integrations/community-nodes)

## 常见问题

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

N8n的 Canva API 集成\. 创建、编辑和导出设计、文件夹及其他内容\.

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

在项目目录运行 npm install @canva/n8n-nodes-canva，或使用 pnpm add / yarn add / bun add。

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

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

### @canva/n8n-nodes-canva 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

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

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

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

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

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

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