Chatbot IA — Connecter OpenRouter : récupérer la clé API et la configurer dans Thaïs
Le chatbot IA de Thaïs a besoin d'une clé API pour fonctionner : c'est le mot de passe technique qui autorise Thaïs à dialoguer avec le fournisseur de modèle. Ce guide couvre OpenRouter de bout en bout : créer la clé chez le fournisseur, puis la renseigner dans Thaïs.
Tout se passe dans le module CONFIG → Chatbot IA → onglet OpenRouter.
1. À savoir avant de commencer
Fournisseur | OpenRouter |
|---|---|
Où créer la clé | |
Format de la clé |
|
Modèle proposé par défaut dans Thaïs |
|
Pourquoi le choisir | un passe-partout : une seule clé donne accès aux modèles de presque tous les éditeurs (Google Gemini, Meta Llama, OpenAI, Anthropic, Mistral…). Pratique pour comparer plusieurs modèles sans multiplier les comptes. |
⚠️ OpenRouter est un revendeur : vous payez OpenRouter, qui paie l'éditeur du modèle. Vous n'avez donc besoin d'aucun compte chez OpenAI, Google ou Anthropic.
2. Créer votre clé API chez OpenRouter
- Connectez-vous sur openrouter.ai (connexion possible avec Google ou GitHub).
- Ouvrez la page Keys (adresse directe : openrouter.ai/keys).
- Cliquez sur Create Key, nommez-la — par exemple
Thais-PMS. Vous pouvez fixer un plafond de dépense sur la clé : très pratique pour maîtriser le budget. - Copiez la clé immédiatement : elle commence par
sk-or-v1-et n'est affichée qu'une seule fois.
🔑 La clé ne s'affiche qu'une seule fois. Copiez-la tout de suite, collez-la dans Thaïs dans la minute qui suit. Si vous l'avez perdue, ce n'est pas grave : supprimez-la et créez-en une nouvelle.
Activer la facturation
Une clé sans crédit ne fonctionne pas. C'est la cause n°1 des « le chatbot ne répond pas » juste après une installation.
- Ouvrez Credits et créditez le compte (carte bancaire).
- Chaque modèle a son propre tarif, affiché dans le catalogue Models : vous pilotez le coût en changeant simplement de modèle.
- Astuce : le plafond posé sur la clé plafonne aussi le risque en cas de fuite de celle-ci.
3. Renseigner la clé dans Thaïs
Ouvrez le module CONFIG, puis Chatbot IA dans le menu de gauche : vous arrivez sur l'onglet Fournisseurs, qui regroupe les cinq fournisseurs pris en charge (DeepSeek, Anthropic, OpenAI, Mistral AI, OpenRouter).
- Sélectionnez l'onglet OpenRouter.
- Collez votre clé dans le champ Clé API.
- Cliquez sur Sauvegarder en bas de page.
Une fois la clé enregistrée, Thaïs ne l'affiche plus en clair : le libellé devient « Clé API (clé enregistrée : …xxxx) » avec les 4 derniers caractères, ce qui vous permet de vérifier quelle clé est en place sans jamais l'exposer.
Choisir le modèle
Le sélecteur Modèle reste grisé tant qu'aucune clé n'est enregistrée — le message « Enregistrez une clé API pour découvrir les modèles disponibles » vous le rappelle. C'est normal : Thaïs a besoin de la clé pour interroger le fournisseur et récupérer la liste des modèles auxquels votre compte a droit.
Après la sauvegarde, ouvrez le sélecteur et choisissez votre modèle. En cas de doute, gardez celui proposé par défaut (google/gemini-3.7-flash).
Bien nommer le modèle chez OpenRouter
Chez OpenRouter, un modèle s'écrit toujours sous la forme éditeur/modèle — par exemple google/gemini-3.7-flash, openai/gpt-4o ou anthropic/claude-opus-4-7. Le sélecteur de Thaïs vous propose la liste exacte une fois la clé enregistrée : servez-vous en plutôt que de saisir un nom de mémoire.
Régler les deux derniers paramètres
Paramètre | Rôle | Valeur conseillée |
|---|---|---|
Itérations max | Nombre d'aller-retours que le chatbot peut enchaîner pour aller chercher l'information avant de répondre. | 5 (3 suffit pour des questions simples) |
Température | Créativité de la réponse. Basse = factuelle et stable, haute = plus libre. | 0,2 — on veut des réponses fiables, pas créatives |
Activer le fournisseur
- Cochez Activer ce fournisseur.
- Cliquez sur Sauvegarder.
ℹ️ Un seul fournisseur peut être actif à la fois. En activant OpenRouter, Thaïs désactive automatiquement les autres. Vos clés déjà enregistrées ne sont pas perdues pour autant : vous pouvez rebasculer d'un fournisseur à l'autre en deux clics, ce qui est très pratique pour comparer les réponses ou pour dépanner en cas de panne chez un éditeur.
Un message de confirmation s'affiche en bas de page. Le champ Prompt système, commun à tous les fournisseurs, sert à donner le contexte de votre établissement au chatbot : il n'est pas à modifier pour une première mise en route.
4. Vérifier que tout fonctionne
Posez une question simple au chatbot, par exemple « Combien de chambres sont libres ce soir ? ». Si la réponse arrive, la configuration est bonne.
Symptôme | Cause la plus probable | Ce qu'il faut faire |
|---|---|---|
Le sélecteur Modèle reste grisé | Aucune clé enregistrée pour cet onglet | Collez la clé, puis Sauvegarder avant de revenir au sélecteur |
Erreur d'authentification / clé invalide | Clé incomplète (copier-coller partiel) ou clé supprimée chez le fournisseur | Recréez une clé et collez-la en entier, sans espace avant ni après |
« Quota dépassé » ou aucune réponse | Compte sans crédit chez le fournisseur | Créditez le compte OpenRouter |
Le chatbot répond mais ignore vos données | Le fournisseur n'est pas celui que vous croyez | Vérifiez quel onglet porte la mention Actif |
Rien ne change après modification | Sauvegarde oubliée | Cliquez sur Sauvegarder en bas de page |
5. Sécurité : traitez la clé comme un code de carte bancaire
- Ne la partagez jamais par e-mail ni par chat, y compris avec notre support : nous n'avons jamais besoin de votre clé.
- Une clé par usage : créez-en une dédiée à Thaïs, jamais celle qui sert déjà ailleurs. En cas de problème, vous la révoquez sans rien casser d'autre.
- Fuite suspectée ? Supprimez la clé chez OpenRouter, créez-en une nouvelle et collez-la dans Thaïs. La clé supprimée devient inutilisable dans la seconde.
- Surveillez la consommation sur la console du fournisseur : c'est le meilleur détecteur d'un usage anormal.
Besoin d'aide ? Notre équipe support répond directement depuis le chat de Thaïs — inutile de nous transmettre votre clé API.
Mis à jour le : 26/08/2026
Merci !