Your AI Connector Docs

Modèle d’IA et BYOK

Cette page explique quel modèle d’IA alimente votre bot, pourquoi un seul fournisseur est pris en charge pour le BYOK (Bring Your Own Key), et comment configurer votre propre clé si votre forfait l’inclut.


Quel modèle d’IA alimente le bot

La plateforme utilise Anthropic Claude comme modèle principal pour votre bot. Claude a été choisi car, après des tests approfondis sur tous les principaux modèles de pointe (terme industriel désignant les modèles d’IA les plus avancés disponibles) sur le marché, c’est le seul qui gère de manière fiable le volume de messages en production.

Vous n’avez pas besoin de choisir un modèle. La plateforme sélectionne automatiquement le modèle approprié pour chaque tâche et maintient le coût par conversation à un niveau bas.


Pourquoi uniquement Anthropic pour le BYOK

Les clients nous demandent souvent si nous ajouterons la prise en charge d’OpenAI, de Google Gemini, d’OpenRouter ou de modèles open source pour le BYOK. La réponse honnête est la suivante : aucun d’entre eux, utilisé tel quel et sans optimisation, ne tient la route à un volume de production.

Pour un petit projet, un taux de réussite de 9 sur 10 de la part d’une IA est acceptable. Une fois que vous gérez de vraies conversations clients à grande échelle, un taux d’échec de 10 % signifie des réservations interrompues, des réponses erronées, des suivis manqués et des ventes perdues. C’est l’ordre de grandeur de ce que nous observons même avec les modèles de pointe de premier plan d’autres fournisseurs (environ 6 à 10 % sur des cas limites contradictoires, c’est-à-dire des questions de test délicates et délibérément difficiles) — et cela avant même de prendre en compte les modèles moins coûteux.

Les problèmes se répartissent en trois catégories :

  • Les cas limites échouent de manière imprévisible. Un modèle peut fonctionner parfaitement pendant des centaines de discussions, puis soudainement halluciner un appel d’outil, prétendre avoir fait quelque chose qu’il n’a pas fait, ou abandonner des instructions au milieu d’une conversation.
  • Le contexte long est mal géré. Une seule réponse de bot utilise l’historique de discussion, la FAQ, la logique de suivi, les appels d’outils et le raisonnement. La plupart des modèles s’étouffent avec ce volume et produisent des résultats de moindre qualité.
  • Le “moins cher” l’est rarement. Le prix affiché plus bas par jeton est compensé par davantage de tentatives, plus de jetons de sortie et une moins bonne conversion. Le coût réel par conversation réussie finit par être plus élevé.

Prendre en charge 100 modèles différents est davantage un argument marketing qu’une réelle capacité. Nous préférons vous offrir un fournisseur qui fonctionne de manière fiable plutôt que cinq qui échouent chacun de manières différentes.


Max

Max est conçu pour les conversations de vente et de support que la plateforme gère réellement. Il coûte une fraction du prix de Pro (0,25 crédit par action) et reste précis là où un modèle économique fait défaut.

Max ne nécessite aucune configuration : pas de choix de modèle, pas de compte fournisseur, pas de clé. C’est le modèle le plus précis que nous proposons, et le meilleur pour respecter ce que votre entreprise déclare réellement. Pour savoir comment Max se compare à Claude et aux modèles tiers économiques sur lesquels les clients s’interrogent souvent, consultez Pourquoi Max est le meilleur rapport qualité-prix.

Qui peut voir le niveau Max

Si le sélecteur Qualité de l’IA dans l’onglet Instructions IA de votre agent affiche Pro mais pas Max ou Mini, c’est simplement que Max n’est pas activé pour le compte auquel vous êtes connecté. Deux éléments permettent de l’activer :

  • Les comptes bénéficiant d’un plan à vie éligible obtiennent Max automatiquement.
  • Tout autre compte doit avoir Max activé explicitement.

Sur un compte fourni par une agence, votre fournisseur a peut-être choisi le modèle pour vous. Si le sélecteur de qualité de l’IA n’affiche qu’une seule carte et qu’il n’y a rien d’autre vers quoi basculer, il s’agit d’un paramètre délibéré de votre compte, et non d’une erreur ; demandez à la personne qui fournit votre compte de le modifier. Si une carte est toujours affichée avec une note indiquant qu’elle n’est plus disponible, votre agent utilise un modèle que votre fournisseur a supprimé depuis : il continue de répondre, mais en utilisant l’un des modèles qu’il autorise. Choisissez donc l’un d’entre eux pour que le sélecteur corresponde à ce qui est réellement exécuté.

Connecter votre propre clé Anthropic (BYOK) n’a rien à voir avec la visibilité de Max. Les deux fonctionnent côte à côte — consultez la note d’exception sous Configuration de BYOK pour savoir comment un Agent Max est facturé lorsque vous avez une clé connectée. Supprimer votre clé API ne fera pas apparaître Max.

Le niveau Mini

Si vous avez accès à Max, vous avez également accès à Mini, au tarif de 0,15 crédit par action. Mini utilise la même IA que Max à un prix inférieur, avec deux compromis :

  • Un risque d’erreur plus élevé. Mini est le modèle le plus léger des deux. Max est le modèle le plus précis que nous proposons — optimisé au maximum pour rester fidèle à ce que votre entreprise dit réellement — tandis qu’avec Mini, il existe un risque plus élevé qu’une petite erreur ou une hallucination se glisse dans une réponse.
  • Mémoire plus légère. Dans les longues conversations, Mini retient moins de messages anciens et extrait moins d’extraits de la base de connaissances par réponse.

Max reste le choix recommandé pour tout ce qui concerne des situations où un détail erroné peut coûter une vente — réservations, questions sur les prix, support avec des enjeux réels. Mini convient aux conversations à fort volume et sensibles au prix, où la vitesse et le coût importent plus que le dernier pourcent de précision.

Mini se trouve dans le même sélecteur de qualité IA que Max, sur tous les comptes disposant de Max. Comme Max, Mini n’utilise jamais de clé BYOK ; par conséquent, une clé Anthropic connectée n’est ni utilisée ni facturée lorsqu’un agent utilise Mini.

Ce que couvre le tarif Mini à 0,15. Le prix Mini s’applique à tout ce qui se passe au sein d’une conversation en direct : réponses de l’IA, appels d’outils par l’IA (comme la prise de rendez-vous ou l’alerte d’un humain), évaluations de chat (décider si une conversation doit être ignorée ou fermée), gestion des interruptions (lorsqu’un contact envoie un nouveau message alors que le bot est encore en train de rédiger sa réponse), résumés de chat et marquage automatique par l’IA. Les fonctionnalités d’IA ponctuelles en dehors de la conversation — optimisation des agents (Optimiser avec l’IA), génération de base de connaissances et marquage effectué via l’API — ont un tarif forfaitaire unique de 0,25 crédit à la fois sur Max et Mini. Vous pourriez donc voir des entrées occasionnelles à 0,25 dans votre historique de crédits, même si chaque agent est configuré sur Mini. Il s’agit de ces fonctionnalités, et non du modèle Max répondant à vos chats.


Configuration du BYOK

BYOK est inclus dans les forfaits Agency et Agency Unlimited, ainsi que dans les niveaux à vie AppSumo à partir du Plan 2. Il ne fait pas partie du forfait Business. Si votre forfait l’inclut, vous pouvez connecter votre propre clé API Anthropic (un code privé provenant de votre compte Anthropic qui permet à la plateforme de vous facturer directement votre utilisation de l’IA au lieu d’utiliser les crédits de la plateforme).

Seules les clés officielles d’Anthropic fonctionnent. Une clé valide provient de votre propre compte sur console.anthropic.com et commence toujours par sk-ant-. Les clés provenant de revendeurs, de proxys ou de sites proposant des « API Claude à prix réduit » (commençant souvent par un préfixe différent) ne sont pas prises en charge et ne seront pas enregistrées. Soyez prudent face aux offres de jetons Claude bon marché, bien en dessous des prix pratiqués par Anthropic : personne ne peut légitimement revendre l’accès à Claude à un tarif inférieur à celui d’Anthropic, et ces offres sont presque toujours des escroqueries basées sur des clés volées ou conçues pour hameçonner vos informations de paiement.

Sur un téléphone ? La barre latérale gauche peut être masquée. Appuyez d’abord sur l’icône de menu (☰), puis appuyez sur Paramètres.

Vous ne voyez pas les clés API BYOK dans le groupe Avancé ? Cette section n’apparaît que sur les forfaits incluant BYOK. Si votre compte est géré par un fournisseur, elle n’apparaît que lorsqu’il a activé Apporter votre propre clé API (Bring Your Own API Key) pour votre compte.

  1. Dans la barre latérale gauche principale, cliquez sur Paramètres (l’icône en forme d’engrenage près du bas).
  2. Sur la page Paramètres, dans le menu de gauche, faites défiler jusqu’au groupe Avancé.
  3. Cliquez sur Clés API BYOK.
  1. Cliquez sur Add key sur la carte Anthropic. Un champ Secret key apparaît (espace réservé sk-ant-…).
  1. Collez votre clé API Anthropic dans le champ, puis cliquez sur Save key.

Une fois activés, les agents du niveau de qualité IA Pro utilisent votre propre clé pour leurs réponses, et vous payez Anthropic directement pour cette utilisation au lieu de dépenser des crédits de la plateforme pour ces réponses. Les agents des niveaux Max ou Mini n’utilisent jamais votre clé et continuent d’utiliser des crédits (voir l’exception ci-dessous). L’infrastructure des canaux (serveurs WhatsApp Web, numéros de téléphone, etc.) continue d’utiliser des crédits comme d’habitude.

Une exception : le niveau Max. Si la qualité IA d’un agent est définie sur le niveau Max, cet agent est facturé à 0,25 crédit par action, même si vous avez connecté votre propre clé (BYOK) — le niveau Max n’utilise jamais votre clé Anthropic. (Il en va de même pour le niveau Mini, lorsqu’il est disponible : 0,15 crédit par action, jamais votre clé.) Pour facturer les réponses sur votre propre compte Anthropic, maintenez l’agent au niveau Pro. Les niveaux sont Max, Pro et Mini ; il n’existe pas de niveau Standard distinct. Le sélecteur de Qualité IA se trouve dans l’onglet Instructions IA de chaque agent. La page des paramètres Clés API BYOK affiche une notification dès que votre clé est enregistrée mais qu’un ou plusieurs de vos agents fonctionnent toujours au niveau Max, en listant lesquels — afin que vous puissiez identifier en un coup d’œil pourquoi des crédits sont toujours utilisés.

Une remarque sur le coût : Apporter votre propre clé n’est plus l’option la moins chère. Avec une clé connectée, votre agent fonctionne sur Claude et vous payez directement les tarifs à l’usage d’Anthropic (Anthropic vous facture en fonction de votre utilisation réelle, comme une facture de services publics). Mesuré sur les comptes utilisant leur propre clé, une réponse IA coûte environ 3 fois plus cher que la même réponse sur Max et plus de 5 fois plus cher que sur Mini, une fois que l’on compte le travail en arrière-plan déclenché par une réponse (recherche dans la base de connaissances, vérification anti-spam, extraction de nom et d’e-mail, évaluations de chat, étiquetage), tout cela étant inclus dans le tarif forfaitaire Max et Mini mais facturé par jeton sur votre clé. Max et Mini sont tout simplement beaucoup moins chers, et Max est également le modèle le plus précis que nous proposons. Utilisez BYOK lorsque vous souhaitez spécifiquement que l’utilisation de l’IA soit facturée sur votre propre compte Anthropic, et non pour économiser de l’argent.

Pourquoi la première réponse dans une conversation coûte beaucoup plus cher que les suivantes. La mise en cache fonctionne en stockant le contexte de la conversation auprès d’Anthropic la première fois qu’il est envoyé, puis en le réutilisant. L’écriture coûte plus cher qu’une requête normale ; chaque réponse qui le réutilise coûte environ un vingtième du prix. Ainsi, la première réponse semble alarmante en termes de coût, tandis que les suivantes sont très bon marché. Tout élément volumineux dans la conversation augmente le coût de cette première réponse — un document téléchargé par un visiteur en est la cause principale. Un PDF de 24 pages représente environ 70 000 jetons, car chaque page est envoyée à la fois sous forme de texte et d’image, et elle reste dans la conversation, donc elle est renvoyée (et remise en cache) à chaque réponse. Si une conversation reste inactive pendant plus d’une heure, la copie stockée expire et la réponse suivante paie à nouveau les frais d’écriture.

Si vous développez une solution intensive en documents — explications de contrats, consultation de manuels, ou tout autre cas où les utilisateurs téléchargent des fichiers — le niveau Max est généralement plus adapté : il s’agit d’un tarif fixe de 0,25 crédit par réponse, quelle que soit la taille du document. Il n’y a donc pas de pic de coût sur le premier message ni d’exposition aux frais par jeton. Consultez Pourquoi Max est le meilleur rapport qualité-prix pour comparer Max en termes de qualité et de coût.

Si votre clé BYOK échoue (invalide, hors quota ou limitée en débit — ce qui signifie qu’Anthropic a temporairement plafonné le nombre de requêtes que votre clé peut effectuer), le fait que votre bot continue de fonctionner dépend du commutateur « Repli sur les crédits » sur la même page des clés API BYOK :

  • Activé : la plateforme utilise temporairement les crédits de la plateforme afin que votre bot continue de répondre, et continue de réessayer votre clé en arrière-plan — dès qu’un appel réussit à nouveau, elle repasse automatiquement à votre propre clé.
  • Désactivé (par défaut) : les réponses de l’IA sont bloquées jusqu’à ce que vous corrigiez la clé. Rien ne consomme vos crédits silencieusement, mais votre bot cesse également de répondre. Si vous préférez qu’il continue à fonctionner sur vos crédits pendant que vous réglez le problème de clé, activez ce commutateur à l’avance.

Dans les deux cas, vous recevrez un e-mail la première fois que votre clé échouera (pas un par message).


Foire aux questions

Puis-je utiliser OpenAI, Gemini ou un autre fournisseur pour BYOK ? Pas pour le moment, pour les autres fournisseurs. Pour la plupart des gens, la réponse est déjà là : Max et Mini, à 0,25 et 0,15 crédit par action.

Ma clé BYOK sera-t-elle utilisée pour tout ? La plupart des opérations d’IA sont exemptes de frais de crédit lorsque votre propre clé Anthropic (BYOK) est connectée : les réponses IA, l’utilisation d’outils, l’optimisation des agents, la génération de base de connaissances et la recherche web fonctionnent toutes sur votre clé. Quatre éléments coûtent toujours des crédits même avec une clé connectée : le niveau Max à 0,25 crédit par action et le niveau Mini à 0,15 (cela inclut une importation de base de connaissances liée à un agent configuré sur Max, à 0,25 par bloc) ; Lead Finder à 0,25 par adresse e-mail trouvée ; et les automatisations à 0,25 par exécution plus 0,25 par étape IA. Pour garder un agent entièrement sur votre propre clé à 0 crédit, laissez-le sur le niveau Pro. Les frais de canal (frais mensuels de WhatsApp Web, frais de livraison et de modèle par message WhatsApp) sont facturés séparément de l’utilisation de l’IA dans tous les cas. Si la clé échoue lors d’un appel qui aurait dû fonctionner avec elle, le fait que la plateforme bascule sur les crédits dépend de votre option Basculer sur les crédits — voir l’option “Basculer sur les crédits” décrite plus haut sur cette page.

Quand les réponses de l’IA coûtent-elles exactement 0 crédit ? BYOK est défini par compte. Les réponses de l’IA ne coûtent 0 crédit que lorsque ce compte a connecté sa propre clé Anthropic. Sans sa propre clé, les réponses consomment des crédits au tarif normal.

Le BYOK affecte-t-il la distribution des messages ou la fiabilité des canaux ? Non. Le BYOK modifie uniquement la façon dont les appels d’IA de votre bot sont facturés. Tout le reste — routage des messages, infrastructure des canaux, suivis et diffusions — fonctionne exactement de la même manière.


Voir aussi : Pourquoi le niveau Max est le meilleur rapport qualité-prix · Configuration de votre bot IA · Agents IA