> ## 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 BuildShip a CometAPI

> Usa esta guía para conectar BuildShip a CometAPI configurando la URL base, la clave API y las opciones de model o provider.

BuildShip es un creador visual de backend de low-code. Usa el nodo comunitario **CometAPI Text Generator** para añadir generación de texto impulsada por IA a cualquier flujo de trabajo.

## Requisitos previos

* Una cuenta de CometAPI con una clave API activa — [obtén la tuya aquí](https://www.cometapi.com/console/token)
* Una cuenta de BuildShip — [inicia sesión aquí](https://app.buildship.com)

<Steps>
  <Step title="Obtén tu clave API de CometAPI">
    Inicia sesión en la [consola de CometAPI](https://www.cometapi.com/console/token). Haz clic en **Add API Key** y copia tu clave API de 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="Panel de CometAPI mostrando el botón 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="Detalles de la clave API de CometAPI con la URL base" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Crea un flujo de trabajo con un disparador REST API">
    1. En el panel de BuildShip, haz clic en **Create a new workflow → From Scratch**.
    2. En el lienzo, haz clic en **Add Trigger** y selecciona **REST API**. Esto genera un endpoint invocable para el flujo de trabajo.
  </Step>

  <Step title="Añade el nodo CometAPI Text Generator">
    1. Debajo del disparador REST API, haz clic en **+ Add a new step**.
    2. En el cuadro de búsqueda de la biblioteca de nodos, escribe `cometapi`.
    3. En la lista de **Community**, selecciona **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="Biblioteca de nodos de BuildShip mostrando CometAPI Text Generator en los resultados de búsqueda" 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 añadido al lienzo" width="1786" height="930" data-path="images/integrations/810968_360712.png" />
    </Frame>
  </Step>

  <Step title="Vincula la integración de CometAPI">
    Este paso le indica al nodo qué sistema de gestión de claves debe usar.

    1. Haz clic en el nodo para abrir el **Node Editor** a la derecha.
    2. Cambia a la pestaña **Settings**.
    3. En **Key-based Integration**, abre el menú desplegable y selecciona **CometAPI**.
    4. Haz clic en el botón azul **Save** en la esquina superior derecha.

    <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="Pestaña Settings del Node Editor con Key-based Integration configurado en CometAPI" width="1895" height="923" data-path="images/integrations/810968_360713.png" />
    </Frame>
  </Step>

  <Step title="Añade tu clave API al nodo">
    1. En el Node Editor, cambia a la pestaña **Inputs** (o haz clic directamente en el nodo).
    2. Haz clic en el icono de llave 🔑 en la esquina superior derecha del nodo para abrir el menú desplegable de claves.
    3. Selecciona **+ Bring your own Key**.
    4. Introduce un **Key ID** (por ejemplo, `cometapi-key-1`) y pega tu clave API de CometAPI en **Value**.
    5. Haz clic en **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="Diálogo de gestión de claves con los campos Key ID y Value completados" 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 mostrando que la clave se vinculó correctamente" width="611" height="318" data-path="images/integrations/810968_360714.png" />
    </Frame>
  </Step>

  <Step title="Configura los parámetros de entrada">
    En la pestaña **Inputs** del nodo:

    * **Instructions** (opcional): establece un rol de sistema, por ejemplo, `You are a productivity assistant.`
    * **Prompt**: haz clic en el icono **`</>`** y luego selecciona **Trigger → Body → prompt** para mapear el cuerpo de la solicitud entrante.
    * **Advanced → Model**: introduce el model ID actual que quieres usar.

    <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 de CometAPI con Instructions, Prompt y Model configurados" width="1895" height="940" data-path="images/integrations/810968_360716.png" />
    </Frame>
  </Step>

  <Step title="Añade un nodo Return Response y prueba">
    1. Debajo del nodo de CometAPI, haz clic en **+ Add a new step** y selecciona **Return Response**.
    2. En el campo **Body**, haz clic en **`</>`** y selecciona la variable `response` del nodo CometAPI Text Generator.
    3. Haz clic en **Test** en la esquina superior derecha, selecciona el formato de entrada **JSON** y envía:

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

    4. Una respuesta correcta en el panel **Result** confirma que el flujo de trabajo está funcionando.

    <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="Panel de prueba de BuildShip mostrando una respuesta correcta de CometAPI" width="1885" height="934" data-path="images/integrations/810968_360717.png" />
    </Frame>

    Si la llamada falla, verifica tu clave API y que Key-based Integration esté configurado en **CometAPI**, o contacta con [el soporte de CometAPI](https://www.cometapi.com).
  </Step>
</Steps>

<Tip>
  El paso **Key-based Integration** (vincular el nodo a CometAPI) es esencial: omitirlo causará errores de autenticación aunque tu clave API sea correcta.
</Tip>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/buildship#howto",
        "name": "Conectar BuildShip a CometAPI",
        "description": "Usa esta guía para conectar BuildShip a CometAPI configurando la URL base, la clave API y las opciones de model o provider.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-1",
            "position": 1,
            "name": "Obtén tu clave API de CometAPI",
            "text": "Crea o abre tu cuenta de CometAPI y luego copia una clave API activa desde el panel."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-2",
            "position": 2,
            "name": "Crea un flujo de trabajo con un disparador REST API",
            "text": "Completa el paso Crea un flujo de trabajo con un disparador REST API en la guía Conectar BuildShip a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-3",
            "position": 3,
            "name": "Añade el nodo CometAPI Text Generator",
            "text": "Completa el paso Añade el nodo CometAPI Text Generator en la guía Conectar BuildShip a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-4",
            "position": 4,
            "name": "Vincula la integración de CometAPI",
            "text": "Completa el paso Vincula la integración de CometAPI en la guía Conectar BuildShip a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-5",
            "position": 5,
            "name": "Añade tu clave API al nodo",
            "text": "Completa el paso Añade tu clave API al nodo en la guía Conectar BuildShip a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-6",
            "position": 6,
            "name": "Configura los parámetros de entrada",
            "text": "Completa el paso Configura los parámetros de entrada en la guía Conectar BuildShip a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-7",
            "position": 7,
            "name": "Añade un nodo Return Response y prueba",
            "text": "Completa el paso Añade un nodo Return Response y prueba en la guía Conectar BuildShip a CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentación de CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integraciones",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Conectar BuildShip a CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/buildship"
          }
        ]
      }
    ]
    }
    `}
</script>
