Utiliser ses propres clés d'API
Par défaut, Forra appelle les modèles d'IA en utilisant ses propres clés d'API auprès des fournisseurs (OpenAI, Anthropic, Google, Azure, etc.). La consommation est facturée à votre organisation via Forra.
Il est possible d'utiliser vos propres clés d'API pour un ou plusieurs fournisseurs, par exemple pour :
- Bénéficier d'un contrat ou de tarifs négociés directement avec le fournisseur.
- Respecter une contrainte de conformité (les données passent par votre propre compte fournisseur).
- Isoler la facturation par projet ou département.
Prérequis
- Un compte chez le fournisseur de modèles (ex. OpenAI, Anthropic, Azure OpenAI).
- Une clé d'API valide avec accès aux modèles que vous voulez utiliser.
Configurer une clé pour un modèle
- Admin Locataire → onglet Modèles.
- Repérer un modèle du fournisseur visé dans la liste des modèles sélectionnés.
- Ouvrir son menu et choisir Configurer la clé d'API.
- Saisir la nouvelle clé d'API dans le champ Nouvelle clé d'API.
- (Optionnel) Cocher Appliquer à tous les modèles {fournisseur} pour utiliser cette clé pour tous les modèles du même fournisseur. Sinon, elle ne s'applique qu'au modèle ouvert.
- Enregistrer.
La clé est appliquée immédiatement.
Retirer une clé personnalisée
Dans le panneau Configurer la clé d'API d'un modèle, cliquer sur Supprimer la clé d'API. Forra retombe sur sa clé partagée par défaut.
Vérifier l'état des clés
Dans la liste des modèles, une mention Clé d'API personnalisée apparaît sur les modèles qui utilisent une clé propre à votre organisation. Les autres utilisent la clé Forra par défaut.
Notes
- Les clés saisies sont chiffrées au repos.
- Si une clé devient invalide (révoquée, expirée), les appels aux modèles correspondants échoueront. Retirer la clé pour retomber sur la clé Forra, ou en saisir une nouvelle.
- Pour les fournisseurs auto-hébergés ou les déploiements Azure OpenAI avec endpoint personnalisé, contacter l'équipe Forra — l'interface actuelle gère la clé mais pas l'URL d'endpoint.