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

NCA Toolkit Google Cloud Run 部署教程,面向新手演示如何在 GCP 安装 No-Code Architects Toolkit,并完成 API Key、Cloud Storage 存储桶、服务账号和 n8n 连通性测试。

NCA Toolkit Google Cloud Run 部署教程封面

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

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

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

如果没有信用卡,先看本文付款方式部分的注意事项。虚拟卡服务稳定性变化很快,本文不再放单一服务商链接,避免读者打开失效页面或误用过期渠道。


目录

  • 为什么使用 No-Code Architects Toolkit
  • 视频教程参考
  • 创建并配置 Google Cloud Platform 账户
  • 准备工作
  • 创建一个谷歌云项目
  • 启用所需的 API
  • 创建一个服务账户
  • 创建一个云存储桶
  • 在 Google Cloud Run 上部署
  • 测试部署
  • 常见问题

为什么使用 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 请求为自动化平台提供服务,可以轻松将其集成到自动化工作流中。

“免费”如何理解? 此工具包的“免费”主要指软件本身开源免费;云平台的计算、存储和流量仍按平台规则计费。新用户赠金或低频使用可以把成本压得很低,但不等于永久零成本。

利用云平台免费额度: GCP 经常为新用户提供体验赠金。中低频测试场景下,API 服务可能在较长一段时间内不产生实际扣费。

与付费工具对比: 市面上的专业媒体自动化 SaaS 工具,如 CreatomateJSON2Video,通常提供托管好的能力,但需要按套餐或用量付费。通过自部署 No-Code Architects Toolkit API,你可以用更低成本覆盖一部分常见媒体处理需求。

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

作者介绍

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

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

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

视频教程参考

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

视频相关资源

  • Postman 模板
    • 基本概念解释:
      • Postman: 一个流行的 API 开发和测试工具。模板通常包含了一系列预设的 API 请求,方便用户快速开始测试。
  • NCA Toolkit API GPT (一个基于 GPT 的工具,用于了解更多关于 NCA Toolkit API 的信息)
  • No-Code Architects Toolkit GitHub 仓库
  • 视频中会使用下面的 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 账户本身。

  1. 访问 GCP 控制台并开始免费试用:
Google Cloud Platform 控制台入口
  • 点击页面右上角的“免费开始使用”或类似按钮。您需要使用您的 Google 账户(例如 Gmail 账户)登录。
  1. 国家/地区选择:
    • 根据提示选择您的国家/地区。
    • 阅读并同意服务条款,然后点击“同意并继续”。
Google Cloud 服务条款确认界面
  1. 验证身份 – 客户信息:
    • 您会进入验证身份页面,首先需要填写付款资料。
Google Cloud 付款资料验证页面
  • 地址填写: 点击“添加加号地址”。

地址填写说明: 优先使用真实、可验证的账单信息。如果您只是想理解海外地址字段格式,可以参考地址格式示例工具:https://www.meiguodizhi.com/

地址字段格式参考页面

将地址信息对应填写到街道地址、城市、州/省、邮政编码等字段;能否通过验证以 Google Cloud 实际风控结果为准。

Google Cloud 地址字段填写示例
  1. 验证身份 – 付款方式:
    • 填写完地址后,点击“添加付款方式”。
Google Cloud 添加付款方式入口
  • 选择“添加信用卡或借记卡”。
Google Cloud 添加信用卡或借记卡页面
  • 注意事项:
    • 如果没有信用卡,不建议直接照搬过期虚拟卡教程。虚拟卡服务、风控规则和可用卡段变化很快,先优先尝试真实可验证的双币信用卡或 Google Cloud 当前支持的付款方式。
    • 对于中国大陆用户,可以尝试使用支持美元扣款的双币信用卡(例如招商银行、中国银行等银行发行的 Visa 或 Mastercard 双币信用卡)。
    • GCP 会进行小额预授权(通常是 0 或 1)以验证卡的有效性,这笔款项后续会退还。
Google Cloud 付款方式验证提示
  1. 注册成功与否的提示:
    • 能否成功注册 GCP 免费试用,有时会受到网络环境、IP 地址纯净度等多种因素影响。
    • 建议尝试:
      1. 确保您的网络环境稳定,并且与您选择的账户区域相符(例如,如果您选择美国,则使用美国网络环境)。
      2. 避免使用公开的、被滥用的免费 VPN 或代理服务器,因为这类 IP 地址可能已被标记。
      3. 尝试在浏览器的无痕模式 (Incognito/Private Window) 下进行注册,以避免浏览器插件或缓存的干扰。
    • 如果多次尝试仍不成功,建议搜索最新的网络教程的帮助。
  2. 完成注册:
    • 付款信息验证通过后,您可能需要回答一些关于您计划如何使用 GCP 的调查问卷。
Google Cloud 注册问卷页面
  • 完成问卷后,点击“完成”或类似按钮,即可进入 Google Cloud 控制台。
  • 新用户通常会获得一定额度的免费赠金(例如 $300),可在一定期限内用于抵扣 GCP 服务费用。

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

准备工作

在您按照后续步骤操作之前,请确保:

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

创建一个谷歌云项目

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

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

启用所需的 API

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

您需要启用以下 API:

  • Cloud Storage API
  • Cloud Storage JSON API
  • Cloud Run API(控制台里也可能显示为 Cloud Run Admin API)

如何启用 API:

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

创建一个服务账户

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

  1. 在 GCP 控制台中,点击左上角三横线按钮导航到 IAM 和管理 > 服务帐号
GCP IAM 与服务账号入口
  1. 点击页面顶部的 + 创建服务帐号
GCP 创建服务账号按钮
  1. 填写服务账户详情:
    • 服务帐号名称: 输入一个名称,例如 NCA Toolkit Service Account
    • 服务帐号 ID: 系统会自动根据名称生成一个 ID,您可以保留默认值。
    • 服务帐号描述: 可选,可以添加描述信息,例如“用于 NCA Toolkit 访问 GCP 资源”。
GCP 服务账号名称和描述
  1. 点击 创建并继续
  2. 授予此服务帐号对项目的访问权限:
    • 点击“选择角色”下拉菜单。
    • 分配以下角色:
    • 搜索并选择 Storage Admin (存储管理员) (在“Cloud Storage”类别下)。此角色授予对 Cloud Storage 资源的完全控制权限。
GCP 为服务账号添加 Storage Admin 角色
GCP 选择 Storage Admin 角色

搜索并选择 Viewer (查看者) (在“基本”或“项目”类别下)。此角色授予对项目资源的只读访问权限。

GCP 为服务账号添加 Viewer 角色
  • 基本概念解释:
    • 角色: 一组权限的集合。将角色分配给服务账户,就授予了该账户这些权限。
  • 生产环境提示: Storage Admin 是为了让新手部署路径尽量少踩权限问题。正式环境建议按最小权限原则收窄到具体 bucket 和必要操作,不要长期保留过大的项目级权限。
  1. 点击 继续
GCP 服务账号继续按钮
  1. 授予用户对此服务帐号的访问权限: 点击 完成 来创建服务账户。
GCP 服务账号完成创建
  1. 创建并下载服务账户密钥:
    • 创建完成后,您会回到服务账户列表。找到您刚刚创建的服务账户(例如 NCA Toolkit Service Account)。
    • 点击该服务账户名称右侧的三个点(操作菜单),选择 管理密钥
GCP 服务账号管理密钥入口
  • 在密钥页面,点击 添加密钥 > 创建新密钥
GCP 创建服务账号 JSON 密钥
  • 选择密钥类型为 JSON
  • 点击 创建。一个 JSON 文件(密钥文件)会自动下载到您的计算机。
GCP 下载服务账号 JSON 密钥
  • 重要提示: 这个 JSON 文件包含了服务账户的私钥,非常敏感。请务必将其 安全地存储 在您本地的计算机上,不要将其上传到公共代码库或泄露给他人。后续部署 Cloud Run 服务时会用到这个文件的内容。

经验补充: 如果在创建服务账户 JSON 密钥时遇到权限或组织策略相关报错,可以先按下面的步骤处理;如果没有报错,直接跳过这一段。

  1. 在 Google Cloud 控制台左上角的项目选择器里,切换到 组织 层级,不要停留在单个项目层级。
  2. 进入 IAM,找到当前登录的账号,点击账号右侧的铅笔图标编辑权限。
  3. 点击 添加其他角色,搜索并添加 Organization Policy Administrator,然后保存。
  4. 等待 3-5 分钟后,回到服务账户密钥页面,重新创建 JSON 密钥。

创建一个云存储桶

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

  1. 在 GCP 控制台中,导航到 存储 > 存储浏览器。
GCP Cloud Storage 存储浏览器
  1. 点击 + 创建 (或“创建存储桶”)。
GCP 创建存储桶按钮
  1. 配置存储桶:
    • 为您的存储桶命名: 选择一个 全局唯一 的名称(例如 nca-toolkit-bucket-xiangyu(自己取一个自己的标识),因为存储桶名称在所有 GCP 用户中必须是唯一的)。可以使用小写字母、数字、短划线 (-)、下划线 (_) 和点 (.)。
GCP 存储桶命名示例
  • 选择数据的存储位置: 选择一个位置类型(例如 Region 区域级)和具体区域(例如 us-central1)。
GCP 存储桶区域选择示例
  • 为数据选择默认存储类别: 通常选择 Standard 标准存储类别即可。
  • 选择如何控制对对象的访问权限: 选择 统一 访问控制。这意味着您在存储桶级别管理所有对象的权限,而不是为每个对象单独设置权限,这通常更易于管理。
  • 保护工具: 可以保留默认设置(例如对象版本控制关闭,保留策略无)。
  1. 取消选中 强制执行公开访问权限阻止 复选框下的“为此存储桶强制执行公开访问权限阻止”。

解释: 默认情况下,GCP 为了安全会阻止存储桶被公开访问。这里取消该选项,是为了让后续生成的公开文件可以被外部访问。不要把私密素材、客户文件或服务账号密钥放进这个公开桶。

  1. 点击 创建 完成存储桶的创建。
  1. 配置公开访问权限: 存储桶创建后,进入该存储桶的详情页面,找到 权限 标签页,点击 授予访问权限 或类似按钮。

在“新的主账号”字段中,输入 allUsers

解释: allUsers 是一个特殊标识符,代表互联网上的任何人,包括未经身份验证的用户。

allUsers 分配角色:存储对象查看者

解释: 这个角色允许任何人查看(读取)存储桶中的对象(文件),但不能修改或删除它们。

注意:allUsers 设置为 Storage Object Viewer 意味着您存储桶中的所有对象都将公开可读。Google Cloud 官方文档也提醒,这个角色包含列出对象所需权限;如果你只想给最终文件做公开下载,不要把临时文件、私密素材、客户数据或密钥文件放到这个 bucket。

  1. 点击 保存 更改。

在 Google Cloud Run 上部署

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

官方 GCP 安装文档目前仍以 Cloud Run 服务为主路径。对于超长视频或大文件任务,官方文档也补充了 Cloud Run Jobs 的可选方案;新手可以先按本文跑通 Cloud Run 服务,后续再根据任务时长决定是否扩展到 Jobs。

1. 导航到 Cloud Run

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

2. 创建一个新服务

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

3. 配置身份验证和调用

  • 调用: 在“身份验证”部分,选择 允许未经身份验证的调用
    • 解释: 这意味着任何人都可以访问您部署的 API 端点,而无需进行 Google 账户登录验证。学习测试可以这样做;生产环境建议选择“需要身份验证”,或至少在上层增加鉴权、限流和日志监控。

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

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

  • 容器:
    • 容器端口: 默认为 8080。如果 Docker 镜像中的应用监听的是其他端口,请修改为此端口。通常 8080 是很多 Web 应用的默认端口。
    • 内存: 设置为 16 GiB
    • CPU: 设置为 4 vCPUs
    • CPU 分配和价格: 选择 CPU 始终分配
    • 解释: 内存和 CPU 是应用运行时可以使用的计算资源。16 GiB 内存和 4 vCPUs 是比较高的配置,适合媒体处理任务;如果只是低频测试,要留意资源配置带来的成本。
    • 自动扩缩:
      • 最小实例数: 设置为 0
        • 解释: 当没有流量时,实例数可以缩减到 0,这有助于在空闲时最大限度地降低成本。但下次请求时会有冷启动。
      • 最大实例数: 学习环境可以先设置为 1,官方安装示例也会给出 5 这类更适合并发的上限。你可以根据预期请求量调整。
        • 解释: 这是 Cloud Run 可以自动扩展到的最大实例数量。上限越高,越能应对并发,但也更容易产生并行成本。
    • 请求超时: 设置为 300 秒
      • 解释: 这是 Cloud Run 等待您的应用响应请求的最长时间。NCA 官方文档也提示,Cloud Run 对超过 5 分钟的大文件处理并不理想;如果经常处理长视频或大文件,建议使用 webhook 异步回调,或改用更可控的 Docker/VPS 部署。
    • 启动 CPU 加速: 勾选启用此选项。
      • 解释: 这有助于在冷启动(即从 0 个实例扩展到至少 1 个实例时)后,为第一个请求提供更快的响应速度,因为它会临时提供更多 CPU 资源。
    • 执行环境: 选择 第二代
      • 解释: 第二代执行环境通常提供更好的性能和对高级功能的支持。
  • 变量和密钥标签页: 点击 添加变量 来添加以下环境变量。

API_KEY:您的 API 密钥。示例可以写成 Test123,真实部署不要使用弱口令,建议使用随机长字符串。

GCP_BUCKET_NAME:您在上面创建的 Cloud Storage 存储桶的名称,例如 nca-toolkit-bucket-您的唯一标识

GCP_SA_CREDENTIALS:您的服务账户 JSON 密钥的 全部内容

操作方法: 打开您在上面步骤中下载的服务账户 JSON 密钥文件,将其中的所有文本复制,然后粘贴到这个“值”字段中。

确保:

  • 粘贴的内容是 完整的 JSON 格式
  • 内容前后 没有多余的空格或换行符

生产环境提示: 控制台环境变量能跑通学习流程,但服务账号 JSON 属于敏感凭据。正式环境更建议使用 Secret Manager 或更严格的凭据注入方式。

5. 部署服务

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

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

测试部署

部署完成后,您需要测试 API 是否正常工作。您可以直接在 n8n 中使用 HTTP Request 节点测试,这也方便后续把 API 集成到自动化流程中。

测试前准备:

  1. 确保您的 NCA Toolkit API 已成功部署到 Google Cloud Run,并且您拥有其服务 URL。
  2. 确保您拥有在 Cloud Run 环境变量中配置的 API 密钥 (API_KEY)。

在 n8n 中配置 HTTP 请求节点进行测试的步骤:

  1. 创建新工作流或打开现有工作流:
    • 登录到您的 n8n 实例。
    • 点击“+ New workflow”创建一个新工作流,或者在现有工作流中添加节点。
  2. 添加 HTTP 请求节点:
    • 在工作流画布中,点击 “+” 按钮添加一个新节点。
    • 搜索 “HTTP Request” 并选择它。
  3. 配置 HTTP 请求节点:
    • 请求方法: 连通性测试直接使用 GET 方法访问 /v1/toolkit/test。Cloud Run 服务根 URL 不一定有可用页面,不适合作为安装成功的判断标准。
    • URL (网址): 输入完整 API 端点 URL。它通常由两部分组成:
      1. 基础 URL: 这是您在步骤 5 中部署 Cloud Run 服务后获得的 URL,例如 https://your-nca-toolkit-api-xxxxxx-uc.a.run.app
      2. API 路径: 连通性测试建议使用 /v1/toolkit/test,更多可用路径请查阅 NCA Toolkit API 文档或 Postman 模板。
    • 示例 URL: https://your-nca-toolkit-api-xxxxxx-uc.a.run.app/v1/toolkit/test
    • 身份验证: 从下拉菜单中选择 “None” (无),因为我们将通过请求头传递 API 密钥。
    • 发送请求头:
      • 名称: 输入 x-api-key
      • 值: 输入您在 Cloud Run 环境变量中为 API_KEY 配置的值。示例可以用 Test123,真实部署请使用随机长字符串。
    • 发送请求体(主要用于 POST、PUT、PATCH 等方法): 如果您要测试需要提交数据的功能,请选择 JSON 请求体,并按对应端点文档填写请求数据。
    • 选项 – 可选配置: 您可以根据需要配置其他选项,例如 “Timeout” (超时时间)。
  4. 执行节点并检查结果:
    • 点击节点右上角的 “Execute Node” (执行节点)“Test step” (测试步骤) 按钮。
    • 等待节点执行完成。n8n 会在下方显示节点的输出数据。
    • 检查响应:
      • 状态码: 查看输出结果中的 statusCode 字段。通常 200 (OK) 或 201 (Created) 表示请求成功。其他 2xx 范围的状态码也可能表示成功,具体取决于 API 设计。4xx5xx 范围的状态码则表示错误。
      • 响应体: 查看输出结果中的 body (或 data,取决于 n8n 版本和节点设置) 字段。这里会显示 API 返回的数据。验证这些数据是否符合您的预期。
      • 响应头: 您也可以检查 headers 字段,了解 API 返回的响应头信息。

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

常见问题

NCA Toolkit 可以部署到 Google Cloud Run 吗?

可以。NCA Toolkit 官方 GCP 安装文档仍使用 stephengpope/no-code-architects-toolkit:latest 镜像部署到 Google Cloud Run,并配合 Cloud Storage 存储处理后的文件。

部署 NCA Toolkit 需要哪些核心环境变量?

学习部署时至少需要 API_KEYGCP_BUCKET_NAMEGCP_SA_CREDENTIALSAPI_KEY 用于请求鉴权,GCP_BUCKET_NAME 指向 Cloud Storage 存储桶,GCP_SA_CREDENTIALS 填入服务账号 JSON 内容。

如何确认 NCA Toolkit 部署成功?

推荐访问 /v1/toolkit/test,并在请求头里加入 x-api-key。该测试接口会验证 API 鉴权、临时文件创建和云存储上传链路,比只打开 Cloud Run 根 URL 更可靠。

公开 Cloud Storage 存储桶安全吗?

公开存储桶适合存放最终要公开访问的输出文件,不适合存放服务账号密钥、客户素材、未发布视频或私密文件。正式环境建议按最小权限原则收窄服务账号权限,并把敏感凭据交给 Secret Manager 或更严格的注入方式管理。

订阅成功!请到邮箱查收确认链接。

订阅成功!请到邮箱查收确认链接。

订阅成功!请到邮箱查收确认链接。

订阅成功!请到邮箱查收确认链接。

操作成功。

操作已取消。