n8n-nodes-jianying

这是一个 n8n 社区节点，让你能够在 n8n 工作流中使用剪映（JianYing）API 进行视频编辑操作。

剪映 是一款功能强大的视频编辑工具，通过此节点可以实现自动化的视频创作工作流。

n8n 是一个开源许可的工作流自动化平台。

目录

• 安装
• 操作
• 凭据配置
• 兼容性
• 使用示例
• 资源

安装

按照 n8n 社区节点文档中的安装指南进行安装。

通过 n8n UI 安装

1. 进入 n8n 的 Settings > Community Nodes
2. 点击 Install
3. 输入 n8n-nodes-jianying
4. 点击 Install

通过命令行安装

npm install n8n-nodes-jianying

操作

此节点支持以下剪映 API 操作：

Draft Resource

• Create: 创建新的剪映草稿
  • 参数：视频宽度、视频高度
• Save: 保存草稿并生成下载链接
  • 参数：草稿ID、草稿文件夹路径、是否为CapCut
• Add Video: 添加视频到草稿
  • 必需参数：视频URL、草稿ID
  • 可选参数：画布尺寸、截取时间、音量、速度、位置偏移、缩放、转场效果、蒙版等
• Add Audio: 添加音频到草稿
  • 必需参数：音频URL、草稿ID
  • 可选参数：画布尺寸、截取时间、音量、速度、轨道名称、音效类型等
• Add Effect: 添加特效到草稿
  • 必需参数：特效类型、特效分类、草稿ID
  • 可选参数：时间范围、轨道名称、特效参数等

凭据配置

要使用此节点，你需要配置剪映 API 凭据：

1. 在 n8n 中，进入 Credentials > New
2. 搜索并选择 剪映 API
3. 输入你的 API Token
4. 点击 Create

获取 API Token

访问剪映开放平台获取你的 API Token：

• API 文档：https://open.capcutapi.top/cut_jianying

兼容性

• 最低 n8n 版本: 0.198.0
• 测试版本: 1.0.0+

此节点使用 n8n API 版本 1。

使用示例

示例 1: 创建视频草稿

1. 添加 剪映 节点到工作流
2. 选择操作 Create
3. 设置视频尺寸（默认 1080x1920）
4. 执行节点获取草稿ID

示例 2: 自动化视频编辑流程

[触发器] → [生成视频URL] → [剪映: 创建草稿] → [剪映: 添加视频] → [剪映: 添加音频] → [剪映: 添加特效] → [剪映: 保存草稿]

这个工作流可以：

1. 通过 AI 生成视频
2. 创建剪映草稿
3. 添加视频素材
4. 添加背景音乐
5. 添加入场/出场特效
6. 保存并获取下载链接

示例 3: 批量处理视频

使用 n8n 的循环功能，可以批量处理多个视频文件，自动添加相同的音乐和特效。

常见问题

API Token 无效

请确保：

• Token 格式正确
• Token 没有过期
• API 服务可访问

视频添加失败

请检查：

• 视频 URL 是否可访问
• 视频格式是否支持
• 草稿 ID 是否正确

资源

• n8n 社区节点文档
• 剪映开放平台
• n8n 工作流示例

开发

本地开发

# 克隆仓库
git clone https://github.com/yourusername/n8n-nodes-jianying.git
cd n8n-nodes-jianying

# 安装依赖
npm install

# 构建
npm run build

# 监听文件变化
npm run dev

发布

# 构建
npm run build

# 发布到 npm
npm publish

许可证

MIT

支持

如有问题或建议，请在 GitHub Issues 中提出。

更新日志

1.0.0

• 初始版本发布
• 支持基础操作：创建草稿、保存草稿、添加视频、添加音频、添加特效