学员实践:openbili AI 接入驾驶舱介绍
Calvin 是「翔宇工作流」的学员,方向是 AI 模型中转。他把这件事做成了独立站点「openbili」,覆盖 OpenAI SDK 兼容、模型路由、调用成本可见、失败可解释。本文将其介绍给关注同方向的读者。
NCA Toolkit Google Cloud Run 部署教程,面向新手演示如何在 GCP 安装 No-Code Architects Toolkit,并完成 API Key、Cloud Storage 存储桶、服务账号和 n8n 连通性测试。
为了能让大家更好地部署和使用 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 API 是一款多功能、可自部署的 API 服务,专为简化和自动化媒体处理任务而设计。您可以将其视为一个部署在您自己云服务器上的媒体处理“瑞士军刀”,尤其适合希望低成本实现强大功能的创作者。
核心功能: 该工具包通过 API 提供了丰富的媒体处理能力,主要包括视频编辑与创作(如裁剪、拼接、从图片生成视频)、音频处理(如提取、转换、语音转文本)、图像处理以及执行自定义 Python 脚本,赋予您极大的灵活性。
为何在 n8n/Make.com 中使用? 在 n8n 或 Make.com 这样的无代码自动化平台中,此 Toolkit API 可以通过 HTTP 请求为自动化平台提供服务,可以轻松将其集成到自动化工作流中。
“免费”如何理解? 此工具包的“免费”主要指软件本身开源免费;云平台的计算、存储和流量仍按平台规则计费。新用户赠金或低频使用可以把成本压得很低,但不等于永久零成本。
利用云平台免费额度: GCP 经常为新用户提供体验赠金。中低频测试场景下,API 服务可能在较长一段时间内不产生实际扣费。
与付费工具对比: 市面上的专业媒体自动化 SaaS 工具,如 Creatomate 或 JSON2Video,通常提供托管好的能力,但需要按套餐或用量付费。通过自部署 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。
stephengpope/no-code-architects-toolkit:latest
stephengpope/no-code-architects-toolkit:latest: 这是一个 Docker 镜像的名称。stephengpope 通常是发布者的用户名或组织名,no-code-architects-toolkit 是镜像的名称,latest 表示这是该镜像的最新版本。在部署任何应用或使用 GCP 服务之前,您首先需要一个 GCP 账户。如果您计划将 Google 服务(如 Gmail)与外部应用(如 n8n、Make.com)集成,通常也需要一个 GCP 项目来管理 API 凭证(例如客户端 ID 和客户端密钥)。以下步骤专注于创建 GCP 账户本身。



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

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





现在您已经成功创建了 GCP 账户并进入了控制台。接下来,我们将为 NCA Toolkit 创建一个专门的项目。
在您按照后续步骤操作之前,请确保:
项目是 GCP 中组织和管理所有云资源的基本单位。您可以将相关的服务和资源都放在同一个项目中。


NCA Toolkit Project。这个名称主要用于您自己识别。

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




Cloud Storage JSON API 和 Cloud Run API(或控制台里显示的 Cloud Run Admin API)重复此启用过程,务必这三个 API 都已启用。

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


NCA Toolkit Service Account。


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

Storage Admin 是为了让新手部署路径尽量少踩权限问题。正式环境建议按最小权限原则收窄到具体 bucket 和必要操作,不要长期保留过大的项目级权限。

NCA Toolkit Service Account)。


经验补充: 如果在创建服务账户 JSON 密钥时遇到权限或组织策略相关报错,可以先按下面的步骤处理;如果没有报错,直接跳过这一段。
存储桶是 Cloud Storage 中存储数据的基本容器,类似于您电脑上的文件夹,但功能更强大。我们将用它来存储 NCA Toolkit 可能需要的文件。


-)、下划线 (_) 和点 (.)。
Region 区域级)和具体区域(例如 us-central1)。
Standard 标准存储类别即可。解释: 默认情况下,GCP 为了安全会阻止存储桶被公开访问。这里取消该选项,是为了让后续生成的公开文件可以被外部访问。不要把私密素材、客户文件或服务账号密钥放进这个公开桶。
在“新的主账号”字段中,输入 allUsers。
解释: allUsers 是一个特殊标识符,代表互联网上的任何人,包括未经身份验证的用户。
为 allUsers 分配角色:存储对象查看者。
解释: 这个角色允许任何人查看(读取)存储桶中的对象(文件),但不能修改或删除它们。
注意: 将 allUsers 设置为 Storage Object Viewer 意味着您存储桶中的所有对象都将公开可读。Google Cloud 官方文档也提醒,这个角色包含列出对象所需权限;如果你只想给最终文件做公开下载,不要把临时文件、私密素材、客户数据或密钥文件放到这个 bucket。
现在我们将把 NCA Toolkit API 的 Docker 镜像部署到 Cloud Run 服务上。
官方 GCP 安装文档目前仍以 Cloud Run 服务为主路径。对于超长视频或大文件任务,官方文档也补充了 Cloud Run Jobs 的可选方案;新手可以先按本文跑通 Cloud Run 服务,后续再根据任务时长决定是否扩展到 Jobs。
stephengpope/no-code-architects-toolkit:latest展开此部分进行详细配置。
8080。如果 Docker 镜像中的应用监听的是其他端口,请修改为此端口。通常 8080 是很多 Web 应用的默认端口。16 GiB。4 vCPUs。16 GiB 内存和 4 vCPUs 是比较高的配置,适合媒体处理任务;如果只是低频测试,要留意资源配置带来的成本。0。
1,官方安装示例也会给出 5 这类更适合并发的上限。你可以根据预期请求量调整。
300 秒。
API_KEY:您的 API 密钥。示例可以写成 Test123,真实部署不要使用弱口令,建议使用随机长字符串。
GCP_BUCKET_NAME:您在上面创建的 Cloud Storage 存储桶的名称,例如 nca-toolkit-bucket-您的唯一标识。
GCP_SA_CREDENTIALS:您的服务账户 JSON 密钥的 全部内容。
操作方法: 打开您在上面步骤中下载的服务账户 JSON 密钥文件,将其中的所有文本复制,然后粘贴到这个“值”字段中。
确保:
生产环境提示: 控制台环境变量能跑通学习流程,但服务账号 JSON 属于敏感凭据。正式环境更建议使用 Secret Manager 或更严格的凭据注入方式。
通过执行这些步骤,NCA Toolkit API 将成功部署并通过 Google Cloud Run 访问,并利用第二代执行环境以获得最佳性能。
部署完成后,您需要测试 API 是否正常工作。您可以直接在 n8n 中使用 HTTP Request 节点测试,这也方便后续把 API 集成到自动化流程中。
测试前准备:
API_KEY)。在 n8n 中配置 HTTP 请求节点进行测试的步骤:
GET 方法访问 /v1/toolkit/test。Cloud Run 服务根 URL 不一定有可用页面,不适合作为安装成功的判断标准。https://your-nca-toolkit-api-xxxxxx-uc.a.run.app。/v1/toolkit/test,更多可用路径请查阅 NCA Toolkit API 文档或 Postman 模板。https://your-nca-toolkit-api-xxxxxx-uc.a.run.app/v1/toolkit/testx-api-keyAPI_KEY 配置的值。示例可以用 Test123,真实部署请使用随机长字符串。statusCode 字段。通常 200 (OK) 或 201 (Created) 表示请求成功。其他 2xx 范围的状态码也可能表示成功,具体取决于 API 设计。4xx 或 5xx 范围的状态码则表示错误。body (或 data,取决于 n8n 版本和节点设置) 字段。这里会显示 API 返回的数据。验证这些数据是否符合您的预期。headers 字段,了解 API 返回的响应头信息。按照这些步骤操作,您的 NCA Toolkit API 应该已成功部署在 Google Cloud Platform 上并可以正常使用了。如果在任何步骤遇到问题,请仔细检查配置或查阅 GCP 的官方文档。
可以。NCA Toolkit 官方 GCP 安装文档仍使用 stephengpope/no-code-architects-toolkit:latest 镜像部署到 Google Cloud Run,并配合 Cloud Storage 存储处理后的文件。
学习部署时至少需要 API_KEY、GCP_BUCKET_NAME 和 GCP_SA_CREDENTIALS。API_KEY 用于请求鉴权,GCP_BUCKET_NAME 指向 Cloud Storage 存储桶,GCP_SA_CREDENTIALS 填入服务账号 JSON 内容。
推荐访问 /v1/toolkit/test,并在请求头里加入 x-api-key。该测试接口会验证 API 鉴权、临时文件创建和云存储上传链路,比只打开 Cloud Run 根 URL 更可靠。
公开存储桶适合存放最终要公开访问的输出文件,不适合存放服务账号密钥、客户素材、未发布视频或私密文件。正式环境建议按最小权限原则收窄服务账号权限,并把敏感凭据交给 Secret Manager 或更严格的注入方式管理。
每周精选 AI 编程与自动化实战内容,直达你的邮箱