Par défaut, chaque génération de contenu sur Fexa AI tourne sur l'infrastructure IA de la plateforme et consomme vos crédits. Mais si vous gérez de gros volumes ou si vous avez déjà un compte chez un fournisseur d'IA, vous pouvez brancher votre propre clé API. C'est le principe du BYOK (Bring Your Own Key — « apportez votre clé »).
BYOK en une phrase : avec le plan Agency, vous renseignez votre clé API Gemini ou OpenAI, et la génération s'exécute sur votre compte IA — donc sans débiter les crédits Fexa AI.
À quoi sert le BYOK ?
Le BYOK répond à un besoin précis : découpler le coût de l'IA de votre abonnement Fexa AI.
- Vous ne consommez plus les crédits de la plateforme. Quand votre clé est active, chaque optimisation est facturée directement par votre fournisseur (Google ou OpenAI), pas par Fexa AI.
- Vous gardez la main sur votre fournisseur. Vous choisissez le modèle exact à utiliser parmi ceux de votre fournisseur.
- Idéal pour les très gros catalogues. Si vous optimisez des milliers de fiches, passer par votre propre quota IA peut être plus économique qu'un volume de crédits équivalent.
Le reste de Fexa AI ne change pas : même moteur d'ancrage catalogue, mêmes prompts nourris par vos données PrestaShop réelles (caractéristiques, déclinaisons, marque, mots-clés Search Console), même qualité de sortie, le tout dans votre voix de marque. Le BYOK ne modifie que la clé qui exécute l'appel et la façon dont il est facturé.
Quels plans débloquent le BYOK ?
Le BYOK est une fonctionnalité réservée au plan Agency (Entreprise).
| Plan | Crédits / mois | BYOK (clé IA dédiée) |
|---|---|---|
| Starter — 39 €/mois | 1 500 | Non |
| Growth — 99 €/mois | 5 000 | Non |
| Agency — 299 €/mois | 20 000 | Oui |
Sur les plans Starter et Growth, la section BYOK s'affiche mais reste verrouillée : un encart vous invite à passer en Agency. La restriction est aussi appliquée côté serveur : enregistrer une clé sans le plan Agency renvoie une erreur. Et si vous repassez sur un plan inférieur, la clé cesse automatiquement de s'appliquer — la génération bascule alors sur l'IA de la plateforme et consomme à nouveau des crédits.
À noter : la facturation annuelle réduit le prix (la remise dépend du plan). Le BYOK reste lié au plan Agency, quel que soit le rythme de facturation.
Quels fournisseurs sont compatibles ?
Deux fournisseurs sont proposés en BYOK :
- Google Gemini — votre clé Google AI ;
- OpenAI — votre clé OpenAI (modèles GPT).
Anthropic (Claude) n'est pas proposé en BYOK. Le sélecteur de fournisseur ne propose que Gemini et OpenAI. Si vous souhaitez la qualité Gemini sans gérer de clé, sachez qu'elle est incluse dans votre abonnement (aucune clé à fournir) — voir Configuration initiale.
Configurer votre clé API étape par étape
Tout se passe dans les préférences de votre boutique.
- Ouvrez Settings depuis le menu latéral.
- Allez dans la section Préférences (choix du modèle IA et clé personnelle).
- Repérez le bloc « Clé API personnelle (BYOK) ».
- Choisissez le fournisseur dans le menu déroulant : Google Gemini ou OpenAI.
- Sélectionnez le modèle à utiliser pour ce fournisseur.
- Collez votre clé API dans le champ prévu (le champ est masqué, comme un mot de passe).
- Cliquez sur « Enregistrer ma clé ».
Une fois la clé enregistrée, un bandeau vert confirme qu'elle est active et indique le fournisseur. La clé n'est jamais réaffichée en clair : seule une version masquée (••••••••) apparaît. Le modèle actif reste modifiable à tout moment via le menu déroulant juste en dessous.
Choisir un modèle qui nécessite une clé
Dans le sélecteur de modèles, les modèles d'un fournisseur autre que Gemini affichent un badge BYOK. Si vous tentez de sélectionner un tel modèle sans avoir enregistré la clé correspondante, Fexa AI vous le signale et vous renvoie vers le formulaire BYOK. C'est normal : un modèle OpenAI ne peut tourner qu'avec une clé OpenAI valide.
Où et comment votre clé est-elle stockée ?
La sécurité de votre clé est traitée comme celle d'un secret sensible.
- Chiffrement au repos. Votre clé est chiffrée avant d'être enregistrée en base (chiffrement symétrique AES-256-GCM). Elle n'est jamais stockée en clair.
- Jamais renvoyée au navigateur. L'API ne retourne jamais la clé (même chiffrée) au client. L'interface n'affiche qu'un masque.
- Déchiffrée uniquement au moment de l'appel. La clé n'est déchiffrée que côté serveur, juste avant d'être transmise au fournisseur pour exécuter la génération.
Vous pouvez supprimer votre clé à tout moment via le bouton Supprimer du bandeau « Clé active ». Si le modèle actif dépendait de cette clé, la boutique repasse automatiquement sur le modèle Gemini par défaut de la plateforme.
Que se passe-t-il si la clé échoue ?
Fexa AI est conçu pour que la génération aboutisse malgré tout, sans que vous deviez surveiller votre compte fournisseur.
- Limite de débit (429). Si votre fournisseur renvoie une erreur de débit, la passerelle IA réessaie automatiquement avec un délai croissant avant d'abandonner.
- Modèle indisponible. Si le modèle choisi n'existe plus ou a été renommé côté fournisseur, la passerelle bascule une fois sur le modèle Gemini stable de la plateforme plutôt que de faire échouer toute la génération.
- Clé invalide ou absente. Les erreurs d'authentification remontent telles quelles : si votre clé est invalide, corrigez-la dans les préférences.
En clair : le BYOK est un levier de coût, pas un point de fragilité. La plateforme reste capable de terminer le travail.
BYOK et crédits : qui paie quoi ?
C'est le cœur de l'intérêt du BYOK. Le comportement dépend de l'état de votre clé :
| Situation | Qui exécute l'appel IA | Crédits Fexa AI débités |
|---|---|---|
| Clé BYOK active (Agency, fournisseur cohérent) | Votre compte IA | Aucun |
| Pas de clé / plan sans BYOK | IA de la plateforme | Oui (1 crédit / fiche) |
| Clé présente mais plan rétrogradé | IA de la plateforme | Oui (la clé ne s'applique plus) |
Pour rappel, 1 crédit = une optimisation complète (titre + métas + descriptions courte/longue + ALT + FAQ + données structurées). Pour bien comprendre ce qu'un crédit recouvre et comment fonctionnent les quotas et les packs booster, consultez le système de crédits. Et pour comprendre comment l'IA construit chaque fiche à partir de votre catalogue, voyez la génération IA.
Questions fréquentes
Le BYOK est-il inclus dans tous les plans ?
Non. Le BYOK est réservé au plan Agency. Sur Starter et Growth, la section reste verrouillée et vous invite à passer en Agency.
Puis-je utiliser ma clé Claude (Anthropic) ?
Non. Le BYOK accepte uniquement Google Gemini et OpenAI. Anthropic n'est pas proposé pour le BYOK.
Est-ce que je consomme encore des crédits Fexa AI avec le BYOK ?
Non, tant que votre clé est active et que son fournisseur correspond au fournisseur de génération. Dans ce cas, l'optimisation est facturée par votre fournisseur IA, pas en crédits Fexa AI.
Ma clé est-elle en sécurité ?
Oui. Elle est chiffrée au repos (AES-256-GCM), n'est jamais renvoyée au navigateur, et n'est déchiffrée côté serveur qu'au moment d'exécuter un appel. Vous pouvez la supprimer à tout moment.
Que se passe-t-il si ma clé tombe en panne au milieu d'un lot ?
La passerelle IA réessaie en cas de limite de débit et bascule sur le modèle Gemini stable de la plateforme si le modèle demandé est indisponible, afin que la génération puisse aboutir.