Passer au contenu principal

​
Introduction

OpenRouter est une passerelle unifiée vers la majorité des modèles d’IA du marché (OpenAI, Anthropic, Google, Meta, etc.). Une seule clé d’API suffit pour alimenter tous les agents IA de Fanify : auto-réponse de chat, classification d’intention, vision, embeddings, etc. C’est l’étape la plus courte de la configuration : une clé à coller, et tous les modèles sont synchronisés automatiquement.

​
Prérequis

  • Un compte OpenRouter : openrouter.ai
  • Des crédits sur le compte : OpenRouter facture à l’usage, vous devez créditer votre compte avant utilisation
  • Accès administrateur à votre instance Fanify
Sans clé OpenRouter, les fonctionnalités IA (auto-réponse, agents de chat, classification, vision, etc.) ne fonctionneront pas.

​
Étapes

​
1) Créer une clé d’API OpenRouter

  1. Connectez-vous sur openrouter.ai
  2. Ouvrez la page Keys
  3. Cliquez sur Create Key, donnez-lui un nom (ex : Fanify)
  4. Copiez la clé générée (format sk-or-...)
La clé n’est affichée qu’une seule fois. Conservez-la en lieu sûr le temps de la coller dans Fanify.

​
2) Ajouter des crédits

Sur openrouter.ai/credits, créditez votre compte. Sans crédits, les appels IA échoueront.

​
3) Saisir la clé dans Fanify

  1. Onglet Admin Onglet Admin
  2. Section Services Section Services
  3. Cliquez sur OpenRouter Service OpenRouter
  4. Collez la clé dans Clé d’API, puis Enregistrer
  5. Cliquez sur Synchroniser les modèles (et Synchroniser les modèles d’embedding pour activer la recherche sémantique RAG)
Le guide de mise en route vous redirige directement vers cet écran via l’étape « Fournisseur d’inférence LLM ».

​
Vérification

Une fois la clé enregistrée, la page Service OpenRouter affiche :
  • Crédits utilisés / restants et le tier du compte (gratuit ou payant)
  • Le nombre de modèles synchronisés disponibles dans Fanify
Vous pouvez actualiser ces informations à tout moment avec Actualiser.
Le solde affiché est actualisé automatiquement (environ toutes les 4 heures) ; vous pouvez aussi le rafraîchir manuellement quand vous le souhaitez. Lorsque vos crédits sont épuisés, Fanify le signale par un badge Plus de crédits et propose un lien pour recharger votre compte.

​
Bon à savoir

​
Modèles d’embedding

Les modèles d’embedding sont nécessaires à la recherche sémantique (RAG, mémoire long-terme des agents). Pensez à lancer Synchroniser les modèles d’embedding en plus de la synchronisation standard.

​
Resynchroniser après une mise à jour

OpenRouter ajoute régulièrement de nouveaux modèles. Relancez Synchroniser les modèles ponctuellement pour les rendre disponibles dans Fanify.

​
Changer de clé

Pour remplacer la clé : écrasez le champ Clé d’API, Enregistrer, puis relancez une synchronisation.

​
Dépannage rapide

  • Clé invalide : vérifiez le format sk-or-... et que la clé n’a pas été révoquée sur OpenRouter
  • Aucun modèle disponible : cliquez sur Synchroniser les modèles
  • Appels IA en échec : vérifiez que votre compte OpenRouter a des crédits suffisants
  • Recherche RAG indisponible : lancez Synchroniser les modèles d’embedding

​
Liens utiles