> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 将 BuildShip 连接到 CometAPI
> 使用本指南，通过设置 base URL、API key 以及 model 或 provider 选项，将 BuildShip 连接到 CometAPI。
BuildShip 是一个低代码可视化后端构建工具。使用社区提供的 **CometAPI Text Generator** 节点，为任意工作流添加由 AI 驱动的文本生成功能。
## 前提条件
* 一个拥有有效 API key 的 CometAPI 账户——[在这里获取](https://www.cometapi.com/console/token)
* 一个 BuildShip 账户——[在这里登录](https://app.buildship.com)
登录 [CometAPI 控制台](https://www.cometapi.com/console/token)。点击 **Add API Key** 并复制你的 CometAPI API key。
1. 在 BuildShip 控制台中，点击 **Create a new workflow → From Scratch**。
2. 在画布上，点击 **Add Trigger** 并选择 **REST API**。这会为该工作流生成一个可调用的 endpoint。
1. 在 REST API 触发器下方，点击 **+ Add a new step**。
2. 在节点库搜索框中，输入 `cometapi`。
3. 在 **Community** 列表中，选择 **CometAPI Text Generator**。
此步骤用于告诉节点应使用哪个 key 管理系统。
1. 点击节点，在右侧打开 **Node Editor**。
2. 切换到 **Settings** 选项卡。
3. 在 **Key-based Integration** 中，打开下拉菜单并选择 **CometAPI**。
4. 点击右上角蓝色的 **Save** 按钮。
1. 在 Node Editor 中，切换到 **Inputs** 选项卡（或直接点击节点）。
2. 点击节点右上角的 🔑 key 图标以打开 key 下拉菜单。
3. 选择 **+ Bring your own Key**。
4. 输入一个 **Key ID**（例如 `cometapi-key-1`），并将你的 CometAPI API key 粘贴到 **Value** 中。
5. 点击 **Save**。
在节点的 **Inputs** 选项卡中：
* **Instructions**（可选）：设置 system role，例如 `You are a productivity assistant.`
* **Prompt**：点击 **``** 图标，然后选择 **Trigger → Body → prompt** 以映射传入的请求体。
* **Advanced → Model**：输入你想使用的当前 model ID。
1. 在 CometAPI 节点下方，点击 **+ Add a new step** 并选择 **Return Response**。
2. 在 **Body** 字段中，点击 **``** 并从 CometAPI Text Generator 节点中选择 `response` 变量。
3. 点击右上角的 **Test**，选择 **JSON** 输入格式，并发送：
```json theme={null}
{
"prompt": "hi"
}
```
4. **Result** 面板中返回成功响应，即表示工作流运行正常。
如果调用失败，请检查你的 API key，并确认 Key-based Integration 已设置为 **CometAPI**，或者联系 [CometAPI 支持](https://www.cometapi.com)。
**Key-based Integration** 步骤（将节点关联到 CometAPI）至关重要——即使你的 API key 正确，跳过它也会导致身份验证错误。