> ## 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.
# Conectar o BuildShip ao CometAPI
> Use este guia para conectar o BuildShip ao CometAPI definindo a URL base, a chave de API e as opções de model ou provider.
BuildShip é um construtor visual de backend low-code. Use o nó da comunidade **CometAPI Text Generator** para adicionar geração de texto com IA a qualquer fluxo de trabalho.
## Pré-requisitos
* Uma conta CometAPI com uma chave de API ativa — [obtenha a sua aqui](https://www.cometapi.com/console/token)
* Uma conta BuildShip — [faça login aqui](https://app.buildship.com)
Faça login no [console da CometAPI](https://www.cometapi.com/console/token). Clique em **Add API Key** e copie sua chave de API da CometAPI.
1. No painel do BuildShip, clique em **Create a new workflow → From Scratch**.
2. Na tela, clique em **Add Trigger** e selecione **REST API**. Isso gera um endpoint chamável para o workflow.
1. Abaixo do gatilho REST API, clique em **+ Add a new step**.
2. Na caixa de busca da biblioteca de nós, digite `cometapi`.
3. Na lista **Community**, selecione **CometAPI Text Generator**.
Esta etapa informa ao nó qual sistema de gerenciamento de chaves usar.
1. Clique no nó para abrir o **Node Editor** à direita.
2. Vá para a aba **Settings**.
3. Em **Key-based Integration**, abra o menu suspenso e selecione **CometAPI**.
4. Clique no botão azul **Save** no canto superior direito.
1. No Node Editor, vá para a aba **Inputs** (ou clique diretamente no nó).
2. Clique no ícone de chave 🔑 no canto superior direito do nó para abrir o menu suspenso de chaves.
3. Selecione **+ Bring your own Key**.
4. Digite um **Key ID** (por exemplo, `cometapi-key-1`) e cole sua chave de API da CometAPI em **Value**.
5. Clique em **Save**.
Na aba **Inputs** do nó:
* **Instructions** (opcional): defina um papel de sistema, por exemplo, `You are a productivity assistant.`
* **Prompt**: clique no ícone **``** e depois selecione **Trigger → Body → prompt** para mapear o corpo da requisição recebida.
* **Advanced → Model**: insira o model ID atual que você deseja usar.
1. Abaixo do nó CometAPI, clique em **+ Add a new step** e selecione **Return Response**.
2. No campo **Body**, clique em **``** e selecione a variável `response` do nó CometAPI Text Generator.
3. Clique em **Test** no canto superior direito, selecione o formato de entrada **JSON** e envie:
```json theme={null}
{
"prompt": "hi"
}
```
4. Uma resposta bem-sucedida no painel **Result** confirma que o workflow está funcionando.
Se a chamada falhar, verifique sua chave de API e se Key-based Integration está definida como **CometAPI**, ou entre em contato com o [suporte da CometAPI](https://www.cometapi.com).
A etapa **Key-based Integration** (vincular o nó à CometAPI) é essencial — ignorá-la causará erros de autenticação mesmo que sua chave de API esteja correta.