BuildShip

Intégrez CometAPI aux workflows BuildShip à l’aide du nœud CometAPI Text Generator, des déclencheurs d’API REST et d’une intégration basée sur clé pour la génération de texte.

BuildShip est un outil visuel low-code de création de backends. Utilisez le nœud communautaire CometAPI Text Generator pour ajouter une 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
• Un compte BuildShip — connectez-vous ici

1. Obtenez votre clé API CometAPI

   Connectez-vous à la console CometAPI. Cliquez sur Add API Key et copiez votre clé sk-xxxxx.

   

   
2. Créez 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 canvas, cliquez sur Add Trigger et sélectionnez REST API. Cela génère un endpoint appelable pour le workflow.
3. Ajoutez le nœud CometAPI Text Generator

   1. Sous le déclencheur REST API, cliquez sur + Add a new step.
   2. Dans la zone de recherche de la bibliothèque de nœuds, tapez cometapi.
   3. Dans la liste Community, sélectionnez CometAPI Text Generator.

   

   
4. Liez 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.

   
5. Ajoutez 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 ex. cometapi-key-1) et collez votre clé sk-xxxxx dans Value.
   5. Cliquez sur Save.

   

   
6. Configurez les paramètres d’entrée

   Dans l’onglet Inputs du nœud :

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

   
7. Ajoutez un nœud Return Response et testez

   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 :

   {
     "prompt": "hi"
   }
   

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

   

   Si l’appel échoue, vérifiez votre clé API et que Key-based Integration est défini sur CometAPI, ou contactez le support CometAPI.

L’étape Key-based Integration (lier le nœud à CometAPI) est essentielle — l’ignorer provoquera des erreurs d’authentification même si votre clé API est correcte.