> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.thais-pms.fr/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # 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**. ![Le module CONFIG et son menu latéral, avec l'entrée Chatbot IA](https://storage.crisp.chat/users/helpdesk/website/-/b/b/b/a/bbba504d0a985800/20menuconfig_1s15r5r.jpg) ## 1. À savoir avant de commencer | **Fournisseur** | OpenRouter | | **Où créer la clé** | [openrouter.ai](https://openrouter.ai) | | **Format de la clé** | `sk-or-v1-…` | | **Modèle proposé par défaut dans Thaïs** | `google/gemini-3.7-flash` | | **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 1. Connectez-vous sur [**openrouter.ai**](https://openrouter.ai) (connexion possible avec Google ou GitHub). 2. Ouvrez la page **Keys** (adresse directe : [openrouter.ai/keys](https://openrouter.ai/keys)). 3. 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. 4. **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). ![L'écran Fournisseurs du Chatbot IA, avec un onglet par fournisseur](https://storage.crisp.chat/users/helpdesk/website/-/b/b/b/a/bbba504d0a985800/21ecranfournisseurs_lxot52.jpg) 1. Sélectionnez l'onglet **OpenRouter**. 2. Collez votre clé dans le champ **Clé API**. 3. Cliquez sur **Sauvegarder** en bas de page. ![L'onglet OpenRouter : clé API, modèle, itérations max et température](https://storage.crisp.chat/users/helpdesk/website/-/b/b/b/a/bbba504d0a985800/30openrouterform_mrewzj.jpg) 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 1. Cochez **Activer ce fournisseur**. 2. Cliquez sur **Sauvegarder**. ![La case Activer ce fournisseur, le prompt système et le bouton Sauvegarder](https://storage.crisp.chat/users/helpdesk/website/-/b/b/b/a/bbba504d0a985800/41activersauvegarder_ggssvo.jpg) > ℹ️ **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.