Donnez à vos flux Activepieces un fournisseur IA compatible OpenAI.

Réponse rapide : une entrée de fournisseur dans la configuration IA d'administration.

Dans la console d'administration d'Activepieces, ouvrez la page de configuration IA et ajoutez un fournisseur de type OpenAI Compatible. Le formulaire prend un Display Name, une API Key, une Base URL, un API Key Header, des en-têtes par défaut optionnels, et une liste de modèles où chaque entrée a un Model ID, un Model Name et un Model Type. Les valeurs pour APIsRouter : la Base URL est https://api.apisrouter.com/v1 (la même forme que le code utilise pour ses propres fournisseurs compatibles intégrés), l'API Key Header est Authorization, et le champ clé prend votre clé de passerelle. Un détail d'implémentation à connaître : Activepieces envoie la clé dans cet en-tête exactement telle que vous l'avez saisie, sans ajouter automatiquement de préfixe Bearer, donc saisissez-la sous la forme « Bearer sk-... » pour la forme canonique ; APIsRouter accepte aussi la clé nue dans l'en-tête Authorization, donc les deux orthographes fonctionnent ici. Ajoutez ensuite chaque modèle que vous voulez rendre visible aux flux, avec un Model ID correspondant exactement au catalogue.

Admin Console -> AI setup -> Add AI Provider
  -> OpenAI Compatible

Display Name:   APIsRouter
Base URL:       https://api.apisrouter.com/v1
API Key Header: Authorization
API Key:        Bearer sk-YOUR-APISROUTER-KEY

Models (Add Model):
  Model ID: claude-haiku-4-5-20251001  Type: TEXT
  Model ID: deepseek-v4-flash          Type: TEXT
  Model ID: claude-sonnet-4-6          Type: TEXT

Comment Activepieces utilise un fournisseur personnalisé.

Activepieces (environ 23 000 étoiles sur GitHub) est la principale plateforme d'automatisation no-code open source : des flux construits à partir de triggers et de pieces, sur le modèle de Zapier mais auto-hébergeable, avec un framework de pieces sous licence MIT et un large catalogue communautaire. Ses capacités IA (étapes de génération de texte, agents, pieces utilitaires IA) résolvent leur modèle via les fournisseurs IA configurés de la plateforme, ce qui fait de l'entrée de fournisseur une décision de routage pour tous les flux à la fois. Sous le capot, le fournisseur OpenAI Compatible construit un client standard contre votre Base URL et attache votre clé sous le nom d'en-tête que vous avez choisi, plus des en-têtes de métadonnées par exécution qui identifient le projet et le flux. Le Model ID que vous avez enregistré est transmis tel quel comme chaîne de modèle dans les requêtes chat-completions. Il n'y a pas de découverte automatique de modèles pour ce type de fournisseur : les flux ne peuvent sélectionner que les modèles que vous avez ajoutés à la liste, ce qui garde le sélecteur intentionnel plutôt que noyé. La configuration du fournisseur est au niveau de la plateforme. Un administrateur la définit une fois, et chaque projet et chaque flux de l'instance sélectionne parmi les modèles enregistrés. Cette centralisation est le gain de gouvernance : un seul endroit pour décider quels modèles existent, une seule clé pour mesurer toutes les étapes IA, et les métadonnées par flux dans chaque requête qui rendent l'usage attribuable à la lecture des journaux.

Configuration complète et la mise en garde au moment de l'enregistrement.

Le formulaire s'enregistre sans valider la connexion ; l'implémentation du fournisseur saute explicitement les vérifications de connexion pour le type OpenAI Compatible. C'est pratique (aucune sonde de votre endpoint au moment de l'enregistrement) mais cela signifie qu'une Base URL erronée ou une clé malformée échoue plus tard, à la première exécution de flux qui touche une étape IA. Vérifiez l'endpoint à la main une fois avant de le câbler dans des flux de production, et traitez la première exécution comme faisant partie de la configuration. Le Model Type détermine quelles pieces peuvent utiliser l'entrée : les étapes de texte veulent des modèles TEXT. Enregistrez l'id exactement comme le catalogue l'orthographie ; le Model Name est une étiquette d'affichage et peut être n'importe quoi de lisible. Si vous voulez le même modèle sous-jacent à deux niveaux de rapport qualité-prix pour des équipes différentes, enregistrez-le une fois par Model ID ; les noms d'affichage les gardent distinguables dans le sélecteur.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

Choisir des modèles pour les étapes d'automatisation.

Comme le fournisseur est à l'échelle de la plateforme, la gouvernance des modèles tient sur un seul écran : ajoutez les ids que vous validez, observez une semaine d'usage par clé, et élaguez ce que personne ne devrait utiliser. Les créateurs de flux gardent leur liberté à l'intérieur de la liste que vous avez triée.

• L'IA d'automatisation est un travail à haut volume et prompts courts : classifier un ticket, extraire des champs, rédiger un message, résumer un payload de webhook. claude-haiku-4-5-20251001, gpt-5.4-mini et deepseek-v4-flash couvrent la plupart des étapes à des tarifs de volume.
• Réservez un id plus puissant pour les étapes de jugement. Un flux qui rédige des réponses destinées aux clients ou prend des décisions de routage mérite claude-sonnet-4-6, sélectionné par étape dans le flow builder.
• MiniMax-M2.7 et la famille DeepSeek ont un tarif extrêmement compétitif pour les flux de transformation en masse (flux de données, nettoyage de scraping, enrichissement) où des milliers d'exécutions par jour sont la norme.
• Les flux tournent sans supervision, donc le coût est un planning multiplié par un nombre de tokens par exécution. Le journal d'usage vous donne le chiffre par exécution ; le planning vous appartient.
• Enregistrez peu de modèles, délibérément. Le sélecteur affiche exactement ce que vous avez ajouté, et une liste triée évite que cent créateurs de flux choisissent chacun différemment.

Paiement à l'usage · en dessous du tarif officiel

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Modes d'échec spécifiques à Activepieces.

Enregistrement silencieux, première exécution bruyante. Comme le fournisseur OpenAI Compatible saute la validation de connexion, chaque erreur de câblage (mauvaise Base URL, /v1 manquant, mauvaise clé, mauvais nom d'en-tête) apparaît comme une étape IA en échec dans une exécution de flux plutôt que comme une erreur de formulaire. Quand une étape IA échoue juste après des changements de fournisseur, soupçonnez d'abord l'entrée de fournisseur avant le flux. La question du préfixe Bearer. La clé est envoyée telle quelle sous l'en-tête que vous avez choisi. Les endpoints qui exigent le préfixe littéral Bearer en ont besoin saisi dans le champ clé ; APIsRouter accepte les deux formes, mais si vous repointez un jour ce fournisseur ailleurs, rappelez-vous que la plateforme n'ajoutera pas le préfixe pour vous. Les Model IDs sont exacts. Un id enregistré avec une faute de frappe passe le formulaire (les labels sont du texte libre) et échoue à l'exécution avec model-not-found ; la sortie /v1/models de la passerelle fait foi pour l'orthographe. L'absence de découverte automatique est une fonctionnalité, pas un bug. Si un modèle manque dans le sélecteur d'un flux, c'est qu'il n'a pas été enregistré sur le fournisseur ; ajoutez-le dans la console d'administration plutôt que de chercher dans le flow builder. Et gardez bien séparées dans votre tête les connexions au niveau des pieces : des pieces individuelles comme la piece OpenAI peuvent détenir leurs propres identifiants par connexion, tandis que l'entrée de fournisseur décrite ici alimente les capacités IA universelles de la plateforme. Si un flux utilise une piece spécifique à un fournisseur avec sa propre connexion, ce trafic ne passe pas par votre entrée de passerelle.

Qui route Activepieces via une passerelle.

• Les équipes en auto-hébergement qui standardisent l'IA sur des dizaines de flux, où une seule entrée de fournisseur et une seule clé remplacent des identifiants dispersés par piece.
• Les administrateurs de plateforme qui veulent une gouvernance des modèles : une liste de modèles triée, un usage par clé, et la capacité de changer l'endpoint sous-jacent sans toucher aux flux.
• Les agences qui font tourner des automatisations clients sur une seule instance, mesurant l'usage IA par client avec des clés séparées sur le même catalogue.
• Les créateurs dont les flux mélangent étapes de volume et étapes de jugement, associant des ids rapides à des ids frontier par étape via un seul endpoint.
• Les développeurs sans accès à la facturation d'un fournisseur donné. Un accès basé sur la recharge, sans exigence de carte, supprime la dépendance à une inscription par fournisseur.

Vérifiez l'endpoint et déboguez la première étape IA.

Lancez les deux commandes curl ci-dessus avant d'enregistrer le fournisseur ; elles prouvent ensemble la clé, la Base URL et l'id du modèle, exactement ce que le formulaire ne vérifiera pas pour vous. Quand l'étape IA d'un flux échoue après la configuration, lisez l'erreur de l'étape. Les échecs d'authentification signifient que le champ clé ou le nom d'en-tête est incorrect (ou que le préfixe Bearer manque sur un endpoint qui l'exige). Une erreur model-not-found est un id enregistré qui ne correspond pas au catalogue. Une erreur de connexion signifie généralement que la Base URL a perdu son /v1. Si l'étape ne trouve aucun modèle à sélectionner, le fournisseur s'est enregistré mais la liste de modèles est vide pour ce type de modèle. Une fois les flux en cours, la console APIsRouter affiche le modèle par requête, le nombre de tokens et la dépense. Les automatisations planifiées s'accumulent silencieusement, et la vue d'usage par clé est la façon dont un administrateur de plateforme voit quels flux méritent leurs tokens avant que la facture ne le fasse.

Questions fréquentes