> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fanifyai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenRouter

> Configurez OpenRouter dans Fanify pour donner accès aux modèles d'IA à tous les agents (chat, vision, embeddings, etc.)

## 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](https://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

<Note>
  Sans clé OpenRouter, les fonctionnalités IA (auto-réponse, agents de chat, classification, vision, etc.) ne fonctionneront pas.
</Note>

## Étapes

### 1) Créer une clé d'API OpenRouter

1. Connectez-vous sur [openrouter.ai](https://openrouter.ai)
2. Ouvrez la page [Keys](https://openrouter.ai/settings/keys)
3. Cliquez sur **Create Key**, donnez-lui un nom (ex : `Fanify`)
4. Copiez la clé générée (format `sk-or-...`)

<Warning>
  La clé n'est affichée **qu'une seule fois**. Conservez-la en lieu sûr le temps de la coller dans Fanify.
</Warning>

### 2) Ajouter des crédits

Sur [openrouter.ai/credits](https://openrouter.ai/credits), créditez votre compte. Sans crédits, les appels IA échoueront.

### 3) Saisir la clé dans Fanify

1. Onglet **Admin** <img src="https://mintcdn.com/saufrasoft/aFq2Mb0yAiM80Ukz/assets/ui-elements/sidebar/tab_admin_hover.png?fit=max&auto=format&n=aFq2Mb0yAiM80Ukz&q=85&s=56afaefa40d91e63ee894ed87eb0209d" alt="Onglet Admin" style={{ display: "inline", height: "1.8em", verticalAlign: "middle", margin: "0 0.25em" }} width="240" height="50" data-path="assets/ui-elements/sidebar/tab_admin_hover.png" />
2. Section **Services** <img src="https://mintcdn.com/saufrasoft/aFq2Mb0yAiM80Ukz/assets/ui-elements/pages/admin-settings/setting-item/services_fr.png?fit=max&auto=format&n=aFq2Mb0yAiM80Ukz&q=85&s=c7e656a007400c325b89bd00bd49a769" alt="Section Services" style={{ display: "inline", height: "1.8em", verticalAlign: "middle", margin: "0 0.25em" }} width="554" height="68" data-path="assets/ui-elements/pages/admin-settings/setting-item/services_fr.png" />
3. Cliquez sur **OpenRouter** <img src="https://mintcdn.com/saufrasoft/aFq2Mb0yAiM80Ukz/assets/ui-elements/pages/admin-settings/services/openrouter.png?fit=max&auto=format&n=aFq2Mb0yAiM80Ukz&q=85&s=d137881ba2816171b81d517404a50645" alt="Service OpenRouter" style={{ display: "inline", height: "1.8em", verticalAlign: "middle", margin: "0 0.25em" }} width="180" height="56" data-path="assets/ui-elements/pages/admin-settings/services/openrouter.png" />
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)

<Tip>
  Le guide de [mise en route](/fr/basics/configuration/onboarding) vous redirige directement vers cet écran via l'étape « Fournisseur d'inférence LLM ».
</Tip>

## 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**.

<Note>
  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.
</Note>

## 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

* Site OpenRouter : [openrouter.ai](https://openrouter.ai)
* Gestion des clés : [openrouter.ai/settings/keys](https://openrouter.ai/settings/keys)
* Crédits : [openrouter.ai/credits](https://openrouter.ai/credits)
* Liste des modèles : [openrouter.ai/models](https://openrouter.ai/models)