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

# Connecter BuildShip à CometAPI

> Utilisez ce guide pour connecter BuildShip à CometAPI en définissant l’URL de base, la clé API et les options de modèle ou de fournisseur.

BuildShip est un constructeur visuel de backend low-code. Utilisez le nœud communautaire **CometAPI Text Generator** pour ajouter la génération de texte alimentée par l’IA à n’importe quel workflow.

## Prérequis

* Un compte CometAPI avec une clé API active — [obtenez la vôtre ici](https://www.cometapi.com/console/token)
* Un compte BuildShip — [connectez-vous ici](https://app.buildship.com)

<Steps>
  <Step title="Obtenir votre clé API CometAPI">
    Connectez-vous à la [console CometAPI](https://www.cometapi.com/console/token). Cliquez sur **Add API Key** et copiez votre clé 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="Tableau de bord CometAPI affichant le bouton 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="Détails de la clé API CometAPI avec l’URL de base" width="2434" height="1232" data-path="images/overview/810968_364193.png" />
    </Frame>
  </Step>

  <Step title="Créer un workflow avec un déclencheur REST API">
    1. Dans le tableau de bord BuildShip, cliquez sur **Create a new workflow → From Scratch**.
    2. Sur le canevas, cliquez sur **Add Trigger** et sélectionnez **REST API**. Cela génère un endpoint appelable pour le workflow.
  </Step>

  <Step title="Ajouter le nœud CometAPI Text Generator">
    1. Sous le déclencheur REST API, cliquez sur **+ Add a new step**.
    2. Dans la barre de recherche de la bibliothèque de nœuds, saisissez `cometapi`.
    3. Dans la liste **Community**, sélectionnez **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="Bibliothèque de nœuds BuildShip affichant CometAPI Text Generator dans les résultats de recherche" 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="Nœud CometAPI Text Generator ajouté au canevas" width="1786" height="930" data-path="images/integrations/810968_360712.png" />
    </Frame>
  </Step>

  <Step title="Lier l’intégration CometAPI">
    Cette étape indique au nœud quel système de gestion des clés utiliser.

    1. Cliquez sur le nœud pour ouvrir le **Node Editor** à droite.
    2. Passez à l’onglet **Settings**.
    3. Dans **Key-based Integration**, ouvrez le menu déroulant et sélectionnez **CometAPI**.
    4. Cliquez sur le bouton bleu **Save** dans le coin supérieur droit.

    <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="Onglet Settings du Node Editor avec Key-based Integration défini sur CometAPI" width="1895" height="923" data-path="images/integrations/810968_360713.png" />
    </Frame>
  </Step>

  <Step title="Ajouter votre clé API au nœud">
    1. Dans le Node Editor, passez à l’onglet **Inputs** (ou cliquez directement sur le nœud).
    2. Cliquez sur l’icône de clé 🔑 dans le coin supérieur droit du nœud pour ouvrir le menu déroulant des clés.
    3. Sélectionnez **+ Bring your own Key**.
    4. Saisissez un **Key ID** (par exemple `cometapi-key-1`) et collez votre clé API CometAPI dans **Value**.
    5. Cliquez sur **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="Boîte de dialogue de gestion des clés avec les champs Key ID et Value remplis" 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="Nœud montrant que la clé a été liée avec succès" width="611" height="318" data-path="images/integrations/810968_360714.png" />
    </Frame>
  </Step>

  <Step title="Configurer les paramètres d’entrée">
    Dans l’onglet **Inputs** du nœud :

    * **Instructions** (facultatif) : définissez un rôle système, par exemple `You are a productivity assistant.`
    * **Prompt** : cliquez sur l’icône **`</>`**, puis sélectionnez **Trigger → Body → prompt** pour mapper le corps de la requête entrante.
    * **Advanced → Model** : saisissez le model ID actuel que vous souhaitez utiliser.

    <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="Nœud CometAPI avec Instructions, Prompt et Model configurés" width="1895" height="940" data-path="images/integrations/810968_360716.png" />
    </Frame>
  </Step>

  <Step title="Ajouter un nœud Return Response et tester">
    1. Sous le nœud CometAPI, cliquez sur **+ Add a new step** et sélectionnez **Return Response**.
    2. Dans le champ **Body**, cliquez sur **`</>`** et sélectionnez la variable `response` du nœud CometAPI Text Generator.
    3. Cliquez sur **Test** dans le coin supérieur droit, sélectionnez le format d’entrée **JSON**, puis envoyez :

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

    4. Une réponse réussie dans le panneau **Result** confirme que le workflow fonctionne.

    <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="Panneau de test BuildShip affichant une réponse CometAPI réussie" width="1885" height="934" data-path="images/integrations/810968_360717.png" />
    </Frame>

    Si l’appel échoue, vérifiez votre clé API et que **Key-based Integration** est bien défini sur **CometAPI**, ou contactez le [support CometAPI](https://www.cometapi.com).
  </Step>
</Steps>

<Tip>
  L’étape **Key-based Integration** (liaison du nœud à CometAPI) est essentielle — l’ignorer provoquera des erreurs d’authentification même si votre clé API est correcte.
</Tip>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/buildship#howto",
        "name": "Connecter BuildShip à CometAPI",
        "description": "Utilisez ce guide pour connecter BuildShip à CometAPI en configurant l’URL de base, la clé API et les options de modèle ou de fournisseur.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-1",
            "position": 1,
            "name": "Obtenir votre clé API CometAPI",
            "text": "Créez ou ouvrez votre compte CometAPI, puis copiez une clé API active depuis le tableau de bord."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-2",
            "position": 2,
            "name": "Créer un workflow avec un déclencheur REST API",
            "text": "Effectuez l’étape Créer un workflow avec un déclencheur REST API dans le guide Connecter BuildShip à CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-3",
            "position": 3,
            "name": "Ajouter le nœud CometAPI Text Generator",
            "text": "Effectuez l’étape Ajouter le nœud CometAPI Text Generator dans le guide Connecter BuildShip à CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-4",
            "position": 4,
            "name": "Lier l’intégration CometAPI",
            "text": "Effectuez l’étape Lier l’intégration CometAPI dans le guide Connecter BuildShip à CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-5",
            "position": 5,
            "name": "Ajouter votre clé API au nœud",
            "text": "Effectuez l’étape Ajouter votre clé API au nœud dans le guide Connecter BuildShip à CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-6",
            "position": 6,
            "name": "Configurer les paramètres d’entrée",
            "text": "Effectuez l’étape Configurer les paramètres d’entrée dans le guide Connecter BuildShip à CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/buildship#step-7",
            "position": 7,
            "name": "Ajouter un nœud Return Response et tester",
            "text": "Effectuez l’étape Ajouter un nœud Return Response et tester dans le guide Connecter BuildShip à CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentation CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Intégrations",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Connecter BuildShip à CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/buildship"
          }
        ]
      }
    ]
    }
    `}
</script>
