> ## 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.

# Collega BuildShip a CometAPI

> Usa questa guida per collegare BuildShip a CometAPI impostando l'URL di base, la chiave API e le opzioni del modello o del provider.

BuildShip è un builder visuale low-code per backend. Usa il nodo della community **CometAPI Text Generator** per aggiungere la generazione di testo basata su AI a qualsiasi workflow.

## Prerequisiti

* Un account CometAPI con una chiave API attiva — [ottieni la tua qui](https://www.cometapi.com/console/token)
* Un account BuildShip — [accedi qui](https://app.buildship.com)

<Steps>
  <Step title="Ottieni la tua chiave API CometAPI">
    Accedi alla [console CometAPI](https://www.cometapi.com/console/token). Fai clic su **Add API Key** e copia la tua chiave API CometAPI.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/overview/810968_364191.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=aef81a83f29f8eb16655ed4060425f50" alt="Dashboard CometAPI che mostra il pulsante Add API Key" width="3824" height="1892" data-path="images/overview/810968_364191.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/HhtmQffktazbxUvS/images/overview/810968_364193.png?fit=max&auto=format&n=HhtmQffktazbxUvS&q=85&s=d893f659267150d0faf45f99eb5dffc1" alt="Dettagli della chiave API CometAPI con URL di base" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Crea un workflow con un trigger REST API">
    1. Nella dashboard di BuildShip, fai clic su **Create a new workflow → From Scratch**.
    2. Nel canvas, fai clic su **Add Trigger** e seleziona **REST API**. Questo genera un endpoint richiamabile per il workflow.
  </Step>

  <Step title="Aggiungi il nodo CometAPI Text Generator">
    1. Sotto il trigger REST API, fai clic su **+ Add a new step**.
    2. Nella casella di ricerca della libreria dei nodi, digita `cometapi`.
    3. Dall'elenco **Community**, seleziona **CometAPI Text Generator**.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360694.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=4ac17cb84e36a7f026f618e2b5229bf2" alt="Libreria dei nodi di BuildShip che mostra CometAPI Text Generator nei risultati di ricerca" width="1915" height="960" data-path="images/integrations/810968_360694.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360712.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=5da7aa2a5bef0d8a9ce45eceace876d1" alt="Nodo CometAPI Text Generator aggiunto al canvas" width="1786" height="930" data-path="images/integrations/810968_360712.png" />
    </Frame>
  </Step>

  <Step title="Collega l'integrazione CometAPI">
    Questo passaggio indica al nodo quale sistema di gestione delle chiavi utilizzare.

    1. Fai clic sul nodo per aprire il **Node Editor** sulla destra.
    2. Passa alla scheda **Settings**.
    3. In **Key-based Integration**, apri il menu a discesa e seleziona **CometAPI**.
    4. Fai clic sul pulsante blu **Save** nell'angolo in alto a destra.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360713.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=ceea3b9fec0cf8a1ab81f70547b0a499" alt="Scheda Settings del Node Editor con Key-based Integration impostato su CometAPI" width="1895" height="923" data-path="images/integrations/810968_360713.png" />
    </Frame>
  </Step>

  <Step title="Aggiungi la tua chiave API al nodo">
    1. Nel Node Editor, passa alla scheda **Inputs** (oppure fai clic direttamente sul nodo).
    2. Fai clic sull'icona della chiave 🔑 nell'angolo in alto a destra del nodo per aprire il menu a discesa delle chiavi.
    3. Seleziona **+ Bring your own Key**.
    4. Inserisci un **Key ID** (ad es. `cometapi-key-1`) e incolla la tua chiave API CometAPI in **Value**.
    5. Fai clic su **Save**.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360715.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=25c09a874e2a0ceadf2a83e1192323ca" alt="Finestra di gestione delle chiavi con i campi Key ID e Value compilati" width="1710" height="920" data-path="images/integrations/810968_360715.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360714.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=7a946cdb3d110605b3a9f1d7d91e022b" alt="Nodo che mostra la chiave associata correttamente" width="611" height="318" data-path="images/integrations/810968_360714.png" />
    </Frame>
  </Step>

  <Step title="Configura i parametri di input">
    Nella scheda **Inputs** del nodo:

    * **Instructions** (opzionale): imposta un ruolo di sistema, ad es. `You are a productivity assistant.`
    * **Prompt**: fai clic sull'icona **`</>`**, quindi seleziona **Trigger → Body → prompt** per mappare il corpo della richiesta in ingresso.
    * **Advanced → Model**: inserisci il model ID corrente che desideri utilizzare.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360716.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=71431b9496c396bbe5fa8d529ca57b27" alt="Nodo CometAPI con Instructions, Prompt e Model configurati" width="1895" height="940" data-path="images/integrations/810968_360716.png" />
    </Frame>
  </Step>

  <Step title="Aggiungi un nodo Return Response ed esegui il test">
    1. Sotto il nodo CometAPI, fai clic su **+ Add a new step** e seleziona **Return Response**.
    2. Nel campo **Body**, fai clic su **`</>`** e seleziona la variabile `response` dal nodo CometAPI Text Generator.
    3. Fai clic su **Test** nell'angolo in alto a destra, seleziona il formato di input **JSON** e invia:

    ```json theme={null}
    {
      "prompt": "hi"
    }
    ```

    4. Una risposta riuscita nel pannello **Result** conferma che il workflow funziona.

    <Frame>
      <img src="https://mintcdn.com/cometapi/SZhlxZhCnMLn__BW/images/integrations/810968_360717.png?fit=max&auto=format&n=SZhlxZhCnMLn__BW&q=85&s=561ea8bcdfd96a014dab4476840ee377" alt="Pannello di test di BuildShip che mostra una risposta CometAPI riuscita" width="1885" height="934" data-path="images/integrations/810968_360717.png" />
    </Frame>

    Se la chiamata non riesce, verifica la tua chiave API e che Key-based Integration sia impostato su **CometAPI**, oppure contatta il [supporto CometAPI](https://www.cometapi.com).
  </Step>
</Steps>

<Tip>
  Il passaggio **Key-based Integration** (collegare il nodo a CometAPI) è essenziale — saltarlo causerà errori di autenticazione anche se la tua chiave API è corretta.
</Tip>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/buildship#howto",
        "name": "Collega BuildShip a CometAPI",
        "description": "Usa questa guida per collegare BuildShip a CometAPI impostando l'URL di base, la chiave API e le opzioni del model o del provider.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-1",
            "position": 1,
            "name": "Ottieni la tua chiave API CometAPI",
            "text": "Crea o apri il tuo account CometAPI, quindi copia una chiave API attiva dalla dashboard."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-2",
            "position": 2,
            "name": "Crea un workflow con un trigger REST API",
            "text": "Completa il passaggio Crea un workflow con un trigger REST API nella guida Collega BuildShip a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-3",
            "position": 3,
            "name": "Aggiungi il nodo CometAPI Text Generator",
            "text": "Completa il passaggio Aggiungi il nodo CometAPI Text Generator nella guida Collega BuildShip a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-4",
            "position": 4,
            "name": "Collega l'integrazione CometAPI",
            "text": "Completa il passaggio Collega l'integrazione CometAPI nella guida Collega BuildShip a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-5",
            "position": 5,
            "name": "Aggiungi la tua chiave API al nodo",
            "text": "Completa il passaggio Aggiungi la tua chiave API al nodo nella guida Collega BuildShip a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-6",
            "position": 6,
            "name": "Configura i parametri di input",
            "text": "Completa il passaggio Configura i parametri di input nella guida Collega BuildShip a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-7",
            "position": 7,
            "name": "Aggiungi un nodo Return Response ed esegui il test",
            "text": "Completa il passaggio Aggiungi un nodo Return Response ed esegui il test nella guida Collega BuildShip a CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentazione CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrazioni",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Collega BuildShip a CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/buildship"
          }
        ]
      }
    ]
    }
    `}
</script>
