1.Preparation#
• Log in buildship, address: https://app.buildship.com/
• Log in to cometapi. Click "ADD API key" in the API keys to get your token key: sk-xxxxxOnce the API key is ready, we can create a workflow in BuildShip to call the CometAPI. We will use the dedicated CometAPI
node provided by the BuildShip community, which is simpler than the generic method.2.1 Add Your API Key in BuildShip#
For security and better management, we will use the integration feature designed for this node to add your CometAPI key. This will be done in steps during the node configuration.2.2 Create the Workflow and Add a Trigger#
1.
Return to the BuildShip main dashboard, click "Create a new workflow" and select "From Scratch".
2.
On the workflow canvas, click "+ Add Trigger", then select "REST API". This will generate a callable API endpoint for us.
1.
Below the REST API
trigger, click "+ Add a new step".
2.
In the pop-up node library search box, type cometapi
.
3.
From the Community node list, select the CometAPI Text Generator
node.

After adding the node, the core configuration requires two main parts: first, link the integration type, and then add your key.Step A: Link the CometAPI IntegrationThis is a crucial step to ensure the node knows which type of key to use.1.
Click the CometAPI Text Generator
node on the canvas to open the Node Editor on the right.
2.
Switch to the Settings tab.
3.
Find the Key-based Integration section and click the dropdown menu.
4.
Search for or select CometAPI
from the list.
5.
Click the blue Save button in the top-right corner of the editor. This step is crucial as it correctly links the node with CometAPI's key management system.
Now that the node is configured, you can add your personal key.1.
In the Node Editor, switch back to the Inputs tab (or you can operate directly on the node on the canvas).
2.
Click the key icon 🔑 area in the top-right of the node to open the key management dropdown.
3.
In the menu, select "+ Bring your own Key".
4.
A dialog box designed specifically for the CometAPI integration will pop up.
5.
In the Key ID field, enter an easily recognizable name, for example, cometapi-key-1
.
6.
In the Value field, paste the sk-xxxxx
key you obtained from CometAPI.
Step C: Configure Input Parameters1.
Instructions: (Optional) Enter instructions or a role for the AI, for example, You are a productivity assistant.
2.
Prompt: This is the core content of the question for the AI. Click the </>
icon on the right side of the input box, then select Trigger
-> Body
-> prompt
.
3.
Click to expand Advanced Settings.
In the Model field, enter the name of the model you want to use, for example, gpt-4o
.
2.4 Add the Output Node#
1.
Below the CometAPI Text Generator
node, click "+ Add a new step".
2.
Select the "Return Response" node.
3.
In the Body
field, click the </>
icon and select the response
variable from the CometAPI Text Generator
node.
3. Testing#
1.
Click the Test
button in the upper right corner of the workflow page to open the test panel on the right.
2.
Ensure the input format is JSON
and fill in the input box with test data, for example: 3.
Click the blue Test Flow
button.
4.
If the configuration is correct, you will see a successful response from CometAPI in the Result
area below.
4. Conclusion#
Congratulations! You have successfully integrated CometAPI into BuildShip. By using the dedicated CometAPI Text Generator
node from the community and leveraging its built-in key integration feature to manage sensitive information, the entire process becomes both direct, efficient, and secure.Modified at 2025-08-29 07:22:13