> ## 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**。這會為工作流程產生一個可呼叫的端點。
1. 在 REST API trigger 下方，點擊 **+ 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** 來映射傳入的 request body。
* **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 正確，跳過這一步仍會導致驗證錯誤。