L'IA — configuration côté exploitant

Tout ce que vos clients voient — le panneau /ai, l'agent d'organisation, les jetons MCP, l'accès de leurs applications aux modèles d'IA, et ce que tout cela leur coûte — est documenté dans les pages IA du guide du développeur. Cette page couvre l'autre moitié, celle qui leur échappe : les clés de service, les niveaux, les prix, et qui paie les modèles.

Où se trouvent les commandes de l'exploitant

La configuration côté exploitant — les clés d'API de service, la politique de niveau sur les offres, la visibilité des dépenses par organisation, et la santé de la passerelle et des modèles — se trouve dans le tableau de bord d'administration, sous Admin → AI, aux côtés des composants de page d'état AI Gateway et AI Models. Ce que chaque offre obtient — l'assistant IA est-il actif, à quel niveau, avec quel plafond de dépense mensuel, combien de sessions simultanées, et quels prestataires il peut appeler — se règle offre par offre, dans l'éditeur d'offres, à Admin → Plans.

Limiter une offre payante à certains prestataires. Avec AI tier = paid, l'éditeur d'offres affiche une case par prestataire payant, sous Paid providers this plan may call. Laissez-les toutes décochées pour « tous les prestataires que vous avez activés » ; cochez-en quelques-unes pour restreindre les clés de cette offre à ces seuls prestataires (par exemple une offre Groq seul, à côté d'une offre Claude). Un prestataire qui n'est pas encore activé et doté d'une clé sous Admin → AI apparaît en grisé : une offre ne peut proposer que ce que la plateforme a configuré, donc activez d'abord le prestataire, puis revenez le cocher. Les clés existantes de l'offre prennent le changement en compte au cycle de réconciliation suivant ; il n'y a rien à faire tourner.

La section Admin → AI liste les prestataires de modèles pris en charge (Anthropic, OpenAI, Groq — la liste s'étend dans le code au besoin). Activez un prestataire, collez sa clé, et enregistrez : la clé est chiffrée au repos et ses modèles sont poussés dans la passerelle, rendant le niveau payant appelable — aucune modification manuelle de la passerelle. Utilisez le bouton Test de chaque prestataire pour vérifier que la clé répond bien au travers de la passerelle avant de vous y fier (sur le modèle des tests de connexion du Registry et des Domains). Le plafond de dépense par défaut d'une offre qui n'en a jamais fixé est de 20 $/mois (KUPLOY_AI_DEFAULT_SPEND_CAP_CENTS) ; un 0 explicite sur une offre signifie délibérément sans plafond.

Le prix des modèles

Kuploy se sert du prix des modèles pour une seule chose : choisir le modèle sur lequel démarre une organisation payante, et étiqueter l'option la moins chère et la plus chère dans le sélecteur de modèle de l'agent d'organisation. Ces prix n'apparaissent jamais sur la facture d'un locataire — la dépense reste ce que la passerelle a mesuré.

Les prix viennent de deux endroits, consultés dans cet ordre pour chaque modèle :

1. Ce que vous déclarez sous Admin → AI, dans les champs de prix à côté de la clé de chaque prestataire — en dollars par million de jetons, en entrée et en sortie : l'unité qu'impriment les pages de tarifs des prestataires.
2. Ce que rapporte la passerelle, d'après sa propre liste de prix, pour tout ce que vous laissez vide.

Laisser un champ vide signifie « prends celui de la passerelle », qui s'affiche alors comme texte indicatif du champ. Vous pouvez n'en remplacer qu'un côté : déclarer un prix d'entrée et conserver le prix de sortie de la passerelle. Un modèle dont aucune des deux sources ne donne le prix est traité comme inconnu, jamais comme bon marché.

Les prix connus, une organisation payante démarre sur le modèle payant le moins cher à être tarifé (pour Anthropic, Haiku, et non Opus). Si aucun modèle payant n'a de prix du tout, le modèle par défaut est le premier activé — exactement ce qui se produisait avant l'existence des prix. Le modèle gratuit intégré ne rapporte aucun coût, parce qu'il n'en a aucun ; il est proposé comme une option à part, plutôt que de remporter la comparaison.

Les prix de la passerelle sont rafraîchis toutes les quelques minutes. Un changement prend effet la prochaine fois qu'une organisation active Platform AI ou met en service son agent — les conversations en cours gardent le modèle avec lequel elles ont commencé.

Les modèles Claude sur du crédit fourni par Kuploy

Au lieu de votre propre clé Anthropic, les modèles paid/claude-* peuvent tourner sur du crédit d'IA prépayé, que vous achetez sur kuploy.app.

Désactivé par défaut

L'IA fournie par Kuploy dépense votre crédit prépayé : elle reste donc désactivée jusqu'à ce que vous l'activiez — et vous demande confirmation quand vous le faites.

L'activer

1. Achetez un lot de crédit sur kuploy.app.
2. Ouvrez Admin → AI. Dans Claude models: Kuploy-supplied or your own key, cliquez sur Use managed (kuploy.app) et confirmez.
3. Votre licence se synchronise aussitôt : le changement aboutit en un seul aller-retour.

Ce que vous dit la carte

Ce qu'affiche la carte	Ce que cela signifie
BYO — your own Anthropic key	Les modèles Claude utilisent la clé Anthropic saisie sous Model Backends.
Managed — waiting for kuploy.app	Activé ; la licence n'a pas encore fait remonter le crédit, ou kuploy.app a refusé — la raison est indiquée juste en dessous.
Managed — Kuploy-supplied credit	En service sur votre crédit, avec le crédit et ce qui a été dépensé affichés en dessous.

Ce qui change, et ce qui ne change pas

• Seul l'acteur qui sert les modèles Claude change. paid/claude-opus, paid/claude-sonnet et paid/claude-haiku conservent leur nom : les clés des organisations, les niveaux et plafonds de dépense des offres, les rattachements aux applications, l'IA conversationnelle et l'agent d'organisation continuent, sans rien à faire tourner ni à redéployer.
• Les autres prestataires ne sont pas affectés. Une clé Anthropic enregistrée le reste, inutilisée, tant que le mode géré est actif.
• Quand le crédit est épuisé, les appels à Claude sont refusés jusqu'à ce que vous en rachetiez. Si kuploy.app refuse — pas de crédit, ou une offre qui n'inclut pas l'IA — la carte vous dit pourquoi.
• Use my own keys fait aussitôt marche arrière, vers la clé Anthropic de Model Backends si vous en avez une. Sans clé, les modèles Claude cessent de répondre — la confirmation vous en avertit.

Les rouages du déploiement et de l'infrastructure (la passerelle de modèles, l'environnement d'exécution de l'agent, les politiques réseau, le dimensionnement) sont documentés dans le dépôt kuploy-k8s : docs/ai-gateway.md et docs/agent-runtime.md.