> ## 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.
# Połącz BuildShip z CometAPI
> Skorzystaj z tego przewodnika, aby połączyć BuildShip z CometAPI, ustawiając podstawowy URL, klucz API oraz opcje model lub provider.
BuildShip to niskokodowy wizualny kreator backendu. Użyj społecznościowego węzła **CometAPI Text Generator**, aby dodać generowanie tekstu wspierane przez AI do dowolnego workflow.
## Wymagania wstępne
* Konto CometAPI z aktywnym kluczem API — [uzyskaj je tutaj](https://www.cometapi.com/console/token)
* Konto BuildShip — [zaloguj się tutaj](https://app.buildship.com)
Zaloguj się do [konsoli CometAPI](https://www.cometapi.com/console/token). Kliknij **Add API Key** i skopiuj swój klucz API CometAPI.
1. W panelu BuildShip kliknij **Create a new workflow → From Scratch**.
2. Na obszarze roboczym kliknij **Add Trigger** i wybierz **REST API**. Spowoduje to wygenerowanie wywoływalnego endpointu dla workflow.
1. Pod wyzwalaczem REST API kliknij **+ Add a new step**.
2. W polu wyszukiwania biblioteki node'ów wpisz `cometapi`.
3. Z listy **Community** wybierz **CometAPI Text Generator**.
Ten krok wskazuje node'owi, którego systemu zarządzania kluczami ma używać.
1. Kliknij node, aby otworzyć **Node Editor** po prawej stronie.
2. Przełącz się na kartę **Settings**.
3. W **Key-based Integration** otwórz listę rozwijaną i wybierz **CometAPI**.
4. Kliknij niebieski przycisk **Save** w prawym górnym rogu.
1. W Node Editor przejdź do karty **Inputs** (lub kliknij bezpośrednio node).
2. Kliknij ikonę klucza 🔑 w prawym górnym rogu node'a, aby otworzyć rozwijaną listę kluczy.
3. Wybierz **+ Bring your own Key**.
4. Wprowadź **Key ID** (np. `cometapi-key-1`) i wklej swój klucz API CometAPI w polu **Value**.
5. Kliknij **Save**.
W karcie **Inputs** node'a:
* **Instructions** (opcjonalnie): ustaw rolę systemową, np. `You are a productivity assistant.`
* **Prompt**: kliknij ikonę **``**, a następnie wybierz **Trigger → Body → prompt**, aby zmapować przychodzące body żądania.
* **Advanced → Model**: wprowadź bieżący model ID, którego chcesz użyć.
1. Pod node'em CometAPI kliknij **+ Add a new step** i wybierz **Return Response**.
2. W polu **Body** kliknij **``** i wybierz zmienną `response` z node'a CometAPI Text Generator.
3. Kliknij **Test** w prawym górnym rogu, wybierz format wejściowy **JSON** i wyślij:
```json theme={null}
{
"prompt": "hi"
}
```
4. Pomyślna odpowiedź w panelu **Result** potwierdza, że workflow działa.
Jeśli wywołanie się nie powiedzie, sprawdź swój klucz API oraz to, czy **Key-based Integration** jest ustawione na **CometAPI**, albo skontaktuj się z [pomocą CometAPI](https://www.cometapi.com).
Krok **Key-based Integration** (połączenie node'a z CometAPI) jest niezbędny — pominięcie go spowoduje błędy uwierzytelniania, nawet jeśli Twój klucz API jest poprawny.