BuildShip

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.

​

先決條件

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

1

取得你的 CometAPI API key

登入 CometAPI 主控台。點擊 Add API Key，並複製你的 $COMETAPI_KEY 金鑰。

2

使用 REST API 觸發器建立工作流程

1. 在 BuildShip 控制台中，點擊 Create a new workflow → From Scratch。
2. 在畫布上，點擊 Add Trigger 並選擇 REST API。這會為工作流程產生一個可呼叫的端點。

3

新增 CometAPI Text Generator 節點

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

4

連結 CometAPI 整合

此步驟會告訴節點應使用哪一種金鑰管理系統。

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

5

將你的 API key 加入節點

1. 在 Node Editor 中，切換到 Inputs 分頁（或直接點擊節點）。
2. 點擊節點右上角的 🔑 金鑰圖示以開啟金鑰下拉選單。
3. 選擇 + Bring your own Key。
4. 輸入 Key ID（例如 cometapi-key-1），並將你的 $COMETAPI_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 支援團隊。