谷歌云平台 (GCP) 安装 No-Code Architects Toolkit 手把手中文教程

为了能让大家更好地部署和使用 No-Code Architects Toolkit API，翔宇花费了大约3个小时，为大家撰写了这篇详尽的中文手把手教程，希望能帮助各位小伙伴更简单地上手和应用这款强大的工具。

本教程将完整指导您如何在 Google Cloud Platform (GCP) 上成功安装和部署 No-Code Architects Toolkit。我们将从最开始的创建 GCP 账户入手，然后一步步带您完成后续的项目配置、应用部署等所有关键环节，并且会尽可能通俗易懂地解释其中涉及的基础概念，确保即使是初次接触云平台的朋友们也能轻松跟学并成功操作。

https://github.com/stephengpope/no-code-architects-toolkit

如果没有信用卡可以参考如下教程：

https://xiangyugongzuoliu.com/bingo-card-google-cloud-vps-guide-for-beginners/

目录隐藏

1 为什么使用No-Code Architects Toolkit ？

2 视频教程参考

3 创建并配置 Google Cloud Platform (GCP) 账户

4 准备工作

9 在 Google Cloud Run 上部署

10 测试部署

为什么使用No-Code Architects Toolkit ？

No-Code Architects Toolkit 简介

No-Code Architects Toolkit API 是一款多功能、可自部署的 API 服务，专为简化和自动化媒体处理任务而设计。您可以将其视为一个部署在您自己云服务器上的媒体处理“瑞士军刀”，尤其适合希望低成本实现强大功能的创作者。

核心功能： 该工具包通过 API 提供了丰富的媒体处理能力，主要包括视频编辑与创作（如裁剪、拼接、从图片生成视频）、音频处理（如提取、转换、语音转文本）、图像处理以及执行自定义 Python 脚本，赋予您极大的灵活性。

为何在 n8n/Make.com 中使用？ 在 n8n 或 Make.com 这样的无代码自动化平台中，此 Toolkit API 可以通过 HTTP 请求为自动化平台提供服务，可以轻松将其集成到自动化工作流中。

“免费”如何实现？ 此工具包的“免费”主要指软件本身免费，并推荐用户在 Google Cloud Platform (GCP) 等云平台上自行部署。成本效益来源于：

利用云平台免费额度： GCP 为新用户提供数百美元的体验赠金。中低频使用下，您的 API 服务可能完全免费。

与付费工具对比： 市面上的专业媒体自动化SaaS工具，如 Creatomate 或 JSON2Video，通常提供强大的功能，但其月度订阅费用一般从数十美元到数百美元不等（例如，40-200+/月，具体视套餐而定）。通过自部署 No-Code Architects Toolkit API，你可以免费实现以上大部分功能。

总而言之，No-Code Architects Toolkit API 为您提供了一个高性价比的选择，通过自部署模式，在享受强大媒体处理能力的同时，有效控制成本。

作者介绍

No-Code Architects Toolkit API 由开发者 Stephen G. Pope (stephengpope) 创建并无私开源。他的工作为自动化爱好者和开发者提供了极大的便利。

深入学习与交流： 除了项目本身，Stephen G. Pope 还在其他平台分享更多关于无代码、自动化以及此工具包应用的知识：

YouTube 频道： 您可以通过此链接访问相关的视频内容：www.youtube.com/@StephenGPope
Skool 社区： 加入 No-Code Architects 社区，与其他用户交流心得、提问并获取支持：https://www.skool.com/no-code-architects/about

支持开源： 若此工具对您有帮助，请考虑前往其 GitHub 仓库点亮一颗星 (⭐ Star)。这不仅是对作者辛勤付出的认可，也能帮助更多人发现这个实用项目。订阅作者的频道和加入社区也是很好的支持方式，同时能让您获取最新资讯。您的每一个积极反馈都是对开源贡献者的莫大鼓励！

视频教程参考

如果您更喜欢观看视频，可以参考以下教程设置 No-Code Architects Toolkit API。

视频相关资源

Postman 模板
- 基本概念解释：
  - Postman: 一个流行的 API 开发和测试工具。模板通常包含了一系列预设的 API 请求，方便用户快速开始测试。
NCA Toolkit API GPT (一个基于 GPT 的工具，用于了解更多关于 NCA Toolkit API 的信息)
No-Code Architects ToolkitGithu 仓库
视频中会使用下面的 Docker 镜像： stephengpope/no-code-architects-toolkit:latest基本概念解释：
- Docker 镜像: 可以把它想象成一个轻量级的、包含应用程序运行所需所有东西（代码、运行时、库、环境变量、配置文件）的包裹。使用 Docker 镜像可以确保应用在任何地方都能以相同的方式运行。
- stephengpope/no-code-architects-toolkit:latest: 这是一个 Docker 镜像的名称。stephengpope 通常是发布者的用户名或组织名，no-code-architects-toolkit 是镜像的名称，latest 表示这是该镜像的最新版本。

创建并配置 Google Cloud Platform (GCP) 账户

在部署任何应用或使用 GCP 服务之前，您首先需要一个 GCP 账户。如果您计划将 Google 服务（如 Gmail）与外部应用（如 n8n、Make.com）集成，通常也需要一个 GCP 项目来管理 API 凭证（例如客户端 ID 和客户端密钥）。以下步骤专注于创建 GCP 账户本身。

访问 GCP 控制台并开始免费试用:
- 打开浏览器，访问 Google Cloud Platform 控制台。
- 点击页面右上角的“免费开始使用”或类似按钮。您需要使用您的 Google 账户（例如 Gmail 账户）登录。
国家/地区选择:
- 根据提示选择您的国家/地区。
- 阅读并同意服务条款，然后点击“同意并继续”。
验证身份 – 客户信息:
- 您会进入验证身份页面，首先需要填写付款资料。
- 地址填写: 点击“添加加号地址”。
  - 如果您在特定区域注册遇到困难，有些用户会尝试使用地址生成工具。
  - 具体网址：https://www.meiguodizhi.com/
  - 将生成的地址（或您的真实地址）对应填写到街道地址、城市、州/省、邮政编码等字段。
验证身份 – 付款方式:
- 填写完地址后，点击“添加付款方式”。
- 选择“添加信用卡或借记卡”。
- 注意事项:
  - 如果没有信用卡可以参考如下教程：
    https://xiangyugongzuoliu.com/bingo-card-google-cloud-vps-guide-for-beginners/
  - 对于中国大陆用户，可以尝试使用支持美元扣款的双币信用卡（例如招商银行、中国银行等银行发行的 Visa 或 Mastercard 双币信用卡）。
  - GCP 会进行小额预授权（通常是 0 或 1）以验证卡的有效性，这笔款项后续会退还。
注册成功与否的提示:
- 能否成功注册 GCP 免费试用，有时会受到网络环境、IP 地址纯净度等多种因素影响。
- 建议尝试：
  1. 确保您的网络环境稳定，并且与您选择的账户区域相符（例如，如果您选择美国，则使用美国网络环境）。
  2. 避免使用公开的、被滥用的免费 VPN 或代理服务器，因为这类 IP 地址可能已被标记。
  3. 尝试在浏览器的无痕模式 (Incognito/Private Window) 下进行注册，以避免浏览器插件或缓存的干扰。
- 如果多次尝试仍不成功，建议搜索最新的网络教程的帮助。
完成注册:
- 付款信息验证通过后，您可能需要回答一些关于您计划如何使用 GCP 的调查问卷。
- 完成问卷后，点击“完成”或类似按钮，即可进入 Google Cloud 控制台。
- 新用户通常会获得一定额度的免费赠金（例如 $300），可在一定期限内用于抵扣 GCP 服务费用。

现在您已经成功创建了 GCP 账户并进入了控制台。接下来，我们将为 NCA Toolkit 创建一个专门的项目。

准备工作

在您按照后续步骤操作之前，请确保：

您已成功创建并登录到您的 Google Cloud 账户 (如步骤 0 所述)。
您对 GCP 服务有一定的基础了解，例如什么是 Cloud Run 和 Cloud Storage。
- 基本概念解释：
  - GCP (Google Cloud Platform): 谷歌提供的云计算服务平台，包含计算、存储、数据库、机器学习等多种服务。
  - Cloud Run: GCP 上的一个服务，可以让您轻松部署和扩展容器化的应用程序（比如我们后面要用的 Docker 镜像）。您只需提供代码（或镜像），Cloud Run 会处理服务器的运维。
  - Cloud Storage: GCP 提供的对象存储服务，可以用来存储各种文件，比如图片、视频、备份数据等。
您有一个终端或代码编辑器，虽然本教程主要通过 GCP 控制台操作，但这些工具对后续管理有益。

创建一个谷歌云项目

项目是 GCP 中组织和管理所有云资源的基本单位。您可以将相关的服务和资源都放在同一个项目中。

导航到项目创建页面:
- 登录到 GCP 控制台 (GCP Console)。
- 点击控制台左上角的项目选择器。
- 在弹出的对话框中，点击新建项目。
填写项目信息:
- 输入一个项目名称，例如 NCA Toolkit Project。这个名称主要用于您自己识别。
- GCP 会根据项目名称自动生成一个唯一的项目 ID。您可以编辑这个 ID，但它在所有 GCP 项目中必须是唯一的，并且创建后不能更改，默认不修改即可。
- 选择一个组织 (如果您有的话) 和位置。对于个人用户，可能没有“组织”选项，可以直接选择“无组织”。
创建项目:
- 点击创建。
- 等待项目创建完成，这可能需要几十秒到一分钟。创建完成后，GCP 控制台通常会自动切换到新创建的项目。如果没有自动切换，您可以再次点击顶部的项目选择器，然后选择您刚刚创建的项目。

启用所需的 API

API (Application Programming Interface – 应用程序编程接口) 允许不同的软件服务之间进行通信和数据交换。为了让我们的应用能够使用 Cloud Storage 和 Cloud Run 服务，需要先启用它们的 API。

您需要启用以下 API：

Cloud Storage API
Cloud Storage JSON API
Cloud Run Admin API

如何启用 API：

确保您当前在 GCP 控制台操作的是您在步骤 1 中创建的项目。
在 GCP 控制台的左侧导航菜单中，找到并点击 API 和服务> 库 (有时也可能直接是“启用 API 和服务”)。
在 API 库的搜索框中分别搜索以上列出的每一个 API 名称。
点击搜索到的 API（例如，先搜索 “Cloud Storage API”）。
在 API 的详情页面，点击启用按钮。
对 Cloud Storage JSON API 和 Cloud Run Admin API 重复此启用过程，务必这三个 API 都已启用。

创建一个服务账户

服务账户是一种特殊的 Google 账户，它属于您的项目，而不是某个具体的用户。应用程序或虚拟机可以使用服务账户来调用 Google API，进行身份验证和授权。NCA Toolkit 将使用这个服务账户来访问 GCP 资源（例如 Cloud Storage）。

在 GCP 控制台中，点击左上角三横线按钮导航到 IAM 和管理 > 服务帐号。
点击页面顶部的 + 创建服务帐号。
填写服务账户详情:
- 服务帐号名称: 输入一个名称，例如 NCA Toolkit Service Account。
- 服务帐号 ID: 系统会自动根据名称生成一个 ID，您可以保留默认值。
- 服务帐号描述: 可选，可以添加描述信息，例如“用于 NCA Toolkit 访问 GCP 资源”。
点击创建并继续。
授予此服务帐号对项目的访问权限:
- 点击“选择角色”下拉菜单。
- 分配以下角色：
  - 搜索并选择 Storage Admin (存储管理员) (在“Cloud Storage”类别下)。此角色授予对 Cloud Storage 资源的完全控制权限。
  - 搜索并选择 Viewer (查看者) (在“基本”或“项目”类别下)。此角色授予对项目资源的只读访问权限。
- 基本概念解释：
  - 角色: 一组权限的集合。将角色分配给服务账户，就授予了该账户这些权限。
点击继续。
授予用户对此服务帐号的访问权限: 点击完成来创建服务账户。
创建并下载服务账户密钥:
- 创建完成后，您会回到服务账户列表。找到您刚刚创建的服务账户（例如 NCA Toolkit Service Account）。
- 点击该服务账户名称右侧的三个点（操作菜单），选择管理密钥。
- 在密钥页面，点击添加密钥> 创建新密钥。
- 选择密钥类型为 JSON。
- 点击创建。一个 JSON 文件（密钥文件）会自动下载到您的计算机。
- 重要提示: 这个 JSON 文件包含了服务账户的私钥，非常敏感。请务必将其安全地存储在您本地的计算机上，不要将其上传到公共代码库或泄露给他人。后续部署 Cloud Run 服务时会用到这个文件的内容。

如果出现如下错误，可以参考会员老酒给出解决方案，如没没有报错则忽略该部分教程，特此感谢老酒分享经验：

第一步：在左上角选择组织，而不要选择项目。

第二步：点选IAM，选择目前已登录的账号最后面的铅笔图标进行编辑。

第三步：点选“添加其它角色”并输入“Organization Policy Administrator”后，点击确定。等待3-5分钟后即可为服务账号创建Json密钥。

创建一个云存储桶

存储桶是 Cloud Storage 中存储数据的基本容器，类似于您电脑上的文件夹，但功能更强大。我们将用它来存储 NCA Toolkit 可能需要的文件。

在 GCP 控制台中，导航到存储 > 存储浏览器。
点击 + 创建 (或“创建存储桶”)。
配置存储桶:
- 为您的存储桶命名: 选择一个全局唯一的名称（例如 nca-toolkit-bucket-xiangyu（自己取一个自己的标识），因为存储桶名称在所有 GCP 用户中必须是唯一的）。可以使用小写字母、数字、短划线 (-)、下划线 (_) 和点 (.)。
- 选择数据的存储位置: 选择一个位置类型（例如 Region 区域级）和具体区域（例如 us-central1）。
- 为数据选择默认存储类别: 通常选择 Standard 标准存储类别即可。
- 选择如何控制对对象的访问权限: 选择统一访问控制。这意味着您在存储桶级别管理所有对象的权限，而不是为每个对象单独设置权限，这通常更易于管理。
- 保护工具: 可以保留默认设置（例如对象版本控制关闭，保留策略无）。 [图片：GCP 创建存储桶配置表单]
取消选中 强制执行公开访问权限阻止复选框下的“为此存储桶强制执行公开访问权限阻止”。
- 解释: 默认情况下，GCP 为了安全会阻止存储桶被公开访问。这里要求取消此选项，为了允许公开访问文件。
点击创建完成存储桶的创建。
配置公开访问权限:
- 存储桶创建后，进入该存储桶的详情页面，找到权限标签页。
- 点击授予访问权限或类似的按钮。
- 在“新的主账号”字段中，输入 allUsers。
  - 解释: allUsers 是一个特殊标识符，代表互联网上的任何人，包括未经身份验证的用户。
- 为 allUsers 分配角色：存储对象查看者。
  - 解释: 这个角色允许任何人查看（读取）存储桶中的对象（文件），但不能修改或删除它们。
- 注意: 将 allUsers 设置为 Storage Object Viewer 意味着您存储桶中的所有对象都将公开可读。请确保您只在此存储桶中存放希望公开的数据。
点击保存更改。

在 Google Cloud Run 上部署

现在我们将把 NCA Toolkit API 的 Docker 镜像部署到 Cloud Run 服务上。

1. 导航到 Cloud Run

在 Google Cloud Console 中打开 Cloud Run 服务。您可以通过顶部搜索栏搜索 “Cloud Run” 来快速找到它，或者左侧导航栏跳转。

2. 创建一个新服务

点击 创建服务。
部署源: 选择从现有容器映像部署一个修订版本。
容器映像网址,输入或粘贴以下 Docker Hub 镜像地址： stephengpope/no-code-architects-toolkit:latest

3. 配置身份验证和调用

调用: 在“身份验证 ”部分，选择允许未经身份验证的调用 。
- 解释: 这意味着任何人都可以访问您部署的 API 端点，而无需进行 Google 账户登录验证。这对于公开的 API 是必要的。如果您的 API 需要保护，则应选择“需要身份验证”。

4. 配置容器、变量和密钥、连接、安全

展开此部分进行详细配置。

容器 :
- 容器端口: 默认为 8080。如果 Docker 镜像中的应用监听的是其他端口，请修改为此端口。通常 8080 是很多 Web 应用的默认端口。
  - 内存: 设置为 16 GiB。
  - CPU: 设置为 4 vCPUs。
- CPU 分配和价格 : 选择 CPU 始终分配。
  - 解释:
    - 内存和 CPU: 这些是您的应用运行时可以使用的计算资源。16 GiB 内存和 4 vCPUs 是比较高的配置，确保应用有足够的资源处理请求。
- 自动扩缩:
- - 最小实例数: 设置为 0。
    - 解释: 当没有流量时，实例数可以缩减到 0，这有助于在空闲时最大限度地降低成本。但下次请求时会有冷启动。
  - 最大实例数: 设置为 1。
    - 解释: 这是 Cloud Run 可以自动扩展到的最大实例数量，以应对高流量。您可以根据预期的负载进行调整。
- 请求超时: 设置为 300 秒。
  - 解释: 这是 Cloud Run 等待您的应用响应请求的最长时间。对于可能需要较长时间处理的请求，增加超时时间可以防止请求过早失败。
- 启动 CPU 加速: 勾选启用此选项。
  - 解释: 这有助于在冷启动（即从 0 个实例扩展到至少 1 个实例时）后，为第一个请求提供更快的响应速度，因为它会临时提供更多 CPU 资源。
- 执行环境: 选择第二代。
  - 解释: 第二代执行环境通常提供更好的性能和对高级功能的支持。
变量和密钥标签页:
- 点击添加变量来添加以下环境变量：
  - 名称:API_KEY
    - 值: 您的 API 密钥（例如，Test123）。这是您自定义的一个密钥，用于保护您的 API 不被随意调用。
  - 名称:GCP_BUCKET_NAME
    - 值: 您在上面创建的 Cloud Storage 存储桶的名称 (例如 nca-toolkit-bucket-您的唯一标识)。
  - 名称:GCP_SA_CREDENTIALS
    - 值: 您的服务账户的 JSON 密钥的全部内容。
      - 操作方法: 打开您在上面步骤中下载的服务账户 JSON 密钥文件，将其中的所有文本复制，然后粘贴到这个“值”字段中。
      - 确保:
        
        粘贴的内容是完整的 JSON 格式。
        
        内容前后没有多余的空格或换行符。

5. 部署服务

仔细检查所有设置，然后点击页面底部的创建或部署。
部署过程可能需要几分钟。完成后，您应该会在 Cloud Run 服务列表或服务详情页面看到一个绿色的对勾标记，表示服务已成功部署。Cloud Run 会为您的服务提供一个 URL，这就是您的 API 端点。

通过执行这些步骤，NCA Toolkit API 将成功部署并通过 Google Cloud Run 访问，并利用第二代执行环境以获得最佳性能。

测试部署

部署完成后，您需要测试 API 是否正常工作。

部署完成后，您需要测试 API 是否正常工作。您可以直接在 n8n 中使用 HTTP 请求节点进行测试，这对于后续将 API 集成到自动化流程中非常方便。测试前准备：
1. 确保您的 NCA Toolkit API 已成功部署到 Google Cloud Run，并且您拥有其服务 URL。
2. 确保您拥有在步骤 5 中配置的 API 密钥 (API_KEY)。
在 n8n 中配置 HTTP 请求节点进行测试的步骤：
1. 创建新工作流或打开现有工作流：
  - 登录到您的 n8n 实例。
  - 点击“+ New workflow”创建一个新工作流，或者在现有工作流中添加节点。
2. 添加 HTTP 请求节点：
  - 在工作流画布中，点击 “+” 按钮添加一个新节点。
  - 搜索 “HTTP Request” 并选择它。
3. 配置 HTTP 请求节点：
  - 请求方法:
    - 选择适合您要测试的 API 端点的方法。对于简单的连通性测试或获取数据的端点，通常选择 GET。如果您要测试一个需要提交数据的功能（例如创建资源），则可能需要选择 POST。
    - 建议： 如果您不确定，可以先尝试用 GET 方法访问 API 的根 URL (即 Cloud Run 服务 URL 本身) 或 API 文档中提供的简单GET端点（例如健康检查端点 /health，如果存在的话）。
  - URL (网址):
    - 输入您要请求的完整 API 端点 URL。它通常由两部分组成：
      1. 基础 URL: 这是您在步骤 5 中部署 Cloud Run 服务后获得的 URL (例如 https://your-nca-toolkit-api-xxxxxx-uc.a.run.app)。
      2. API 路径: 这是您要访问的具体 API 功能路径 (例如 /users, /generate-video 等)。您需要查阅 NCA Toolkit API 的文档或示例来获取可用的路径。
    - 示例 URL 格式： [您的 Cloud Run 服务 URL]/[API 功能路径]
      - 例如：https://your-nca-toolkit-api-xxxxxx-uc.a.run.app/v1/toolkit/test
  - 身份验证:
    - 从下拉菜单中选择 “None” (无)，因为我们将通过请求头传递 API 密钥。
  - 发送请求头:
    - 点击 “Headers” 旁边的 “Add Header” (添加请求头) 按钮。
    - 名称: 输入 x-api-key
    - 值: 输入您在步骤 5 中为 API_KEY 环境变量配置的 API 密钥值 (例如 Test123)。
  - 发送请求体(主要用于 POST, PUT, PATCH 等方法):
    - 如果您的请求方法是 POST 或其他需要发送数据的方法：
      - 请求体内容类型: 通常选择 “JSON”。
      - JSON 请求体: 在下方的文本框中输入您的 JSON 请求数据。这些数据需要根据 NCA Toolkit API 相应端点的要求来构造。请参考 API 文档或 Postman 模板中的示例请求。
  - 选项 – 可选配置：
    - 您可以根据需要配置其他选项，例如 “Timeout” (超时时间)。
4. 执行节点并检查结果：
  - 点击节点右上角的 “Execute Node” (执行节点) 或 “Test step” (测试步骤) 按钮。
  - 等待节点执行完成。n8n 会在下方显示节点的输出数据。
  - 检查响应：
    - 状态码: 查看输出结果中的 statusCode 字段。通常 200 (OK) 或 201 (Created) 表示请求成功。其他 2xx 范围的状态码也可能表示成功，具体取决于 API 设计。4xx 或 5xx 范围的状态码则表示错误。
    - 响应体: 查看输出结果中的 body (或 data，取决于n8n版本和节点设置) 字段。这里会显示 API 返回的数据。验证这些数据是否符合您的预期。
    - 响应头: 您也可以检查 headers 字段，了解 API 返回的响应头信息。

按照这些步骤操作，您的 NCA Toolkit API 应该已成功部署在 Google Cloud Platform 上并可以正常使用了。如果在任何步骤遇到问题，请仔细检查配置或查阅 GCP 的官方文档。

Make中文教程：自动化基础

小红书自动化：如何利用Make制作个人自媒体中心，批量生成爆款笔记

微信公众号图文混排文章自动化实战：利用Make 批量制作

翔宇工作流

海外AI服务支付解决方案探讨：国内虚拟卡使用教程

小白也能搞懂！从零开始玩转AI大模型全指南

新手必看：用虚拟信用卡 BinGoCard 注册并使用 Google 云服务器