BuildShip

使用 CometAPI Text Generator 節點、REST API 觸發器工作流程，以及基於金鑰的整合方式，將 CometAPI 整合到 BuildShip 工作流程中進行文字生成。

BuildShip 是一個低程式碼的視覺化後端建構工具。使用社群提供的 CometAPI Text Generator 節點，將 AI 驅動的文字生成功能加入任何工作流程。

​

先決條件

• 擁有一個啟用中 API key 的 CometAPI 帳戶 — 在此取得
• 一個 BuildShip 帳戶 — 在此登入

1. 取得你的 CometAPI API key

   登入 CometAPI 主控台。點擊 Add API Key，然後複製你的 sk-xxxxx key。

   

   
2. 使用 REST API trigger 建立工作流程

   1. 在 BuildShip 儀表板中，點擊 Create a new workflow → From Scratch。
   2. 在畫布上，點擊 Add Trigger 並選擇 REST API。這會為工作流程產生一個可呼叫的端點。
3. 加入 CometAPI Text Generator 節點

   1. 在 REST API trigger 下方，點擊 + Add a new step。
   2. 在節點庫搜尋框中，輸入 cometapi。
   3. 在 Community 清單中，選擇 CometAPI Text Generator。

   

   
4. 連結 CometAPI 整合

   此步驟會告訴節點要使用哪一種 key 管理系統。

   1. 點擊該節點，在右側開啟 Node Editor。
   2. 切換到 Settings 分頁。
   3. 在 Key-based Integration 中，打開下拉選單並選擇 CometAPI。
   4. 點擊右上角藍色的 Save 按鈕。

   
5. 將你的 API key 加入節點

   1. 在 Node Editor 中，切換到 Inputs 分頁（或直接點擊節點）。
   2. 點擊節點右上角的 🔑 key 圖示以開啟 key 下拉選單。
   3. 選擇 + Bring your own Key。
   4. 輸入 Key ID（例如 cometapi-key-1），並將你的 sk-xxxxx key 貼到 Value。
   5. 點擊 Save。

   

   
6. 設定輸入參數

   在節點的 Inputs 分頁中：

   • Instructions（可選）：設定 system role，例如 You are a productivity assistant.
   • Prompt：點擊 </> 圖示，然後選擇 Trigger → Body → prompt 來對應傳入的 request body。
   • Advanced → Model：輸入你想使用的目前 model ID。

   
7. 加入 Return Response 節點並測試

   1. 在 CometAPI 節點下方，點擊 + Add a new step 並選擇 Return Response。
   2. 在 Body 欄位中，點擊 </>，然後從 CometAPI Text Generator 節點選擇 response 變數。
   3. 點擊右上角的 Test，選擇 JSON 輸入格式，並送出：

   {
     "prompt": "hi"
   }
   

   4. 若 Result 面板中出現成功回應，即表示此工作流程運作正常。

   

   如果呼叫失敗，請確認你的 API key，以及 Key-based Integration 是否設為 CometAPI，或聯絡 CometAPI 支援。

Key-based Integration 這一步（將節點連結到 CometAPI）非常重要——即使你的 API key 正確，若跳過這一步仍會導致驗證錯誤。