> For the complete documentation index, see [llms.txt](https://cleyrop.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cleyrop.gitbook.io/docs/v-4.5/administration/gerer-les-modeles-et-les-cles-api.md).

# Gérer les modèles et les clés API

En tant que Platform Manager, vous pouvez connecter vos propres fournisseurs de modèles IA (OpenAI, Mistral, Anthropic, OVH, etc.), définir les modèles par défaut utilisés par Le Druide et les corpus, et rendre les autres modèles disponibles pour les développeurs via la librairie PyAI.

<figure><img src="/files/iDw3c01OA1t8ob0to10t" alt=""><figcaption></figcaption></figure>

***

### Types de clés API

Deux types de clés coexistent dans l'interface :

**Clés client** : ajoutées par le Platform Manager, entièrement modifiables et supprimables.

**Clés Cleyrop** : préconfigurées par Cleyrop. Leurs modèles sont utilisables et peuvent être définis comme modèles par défaut. Elles ne peuvent pas être supprimées.

### Ajouter une clé API

1. Cliquez sur **+ Ajouter**
2. Renseignez le **nom**, l'**URL de l'API** et la **clé API**
3. Cliquez sur **Découvrir les modèles** pour récupérer automatiquement la liste des modèles disponibles chez ce fournisseur, ou ajoutez-les manuellement
4. Ajoutez un **nom d'affichage** pour chaque modèle si nécessaire
5. Validez

La clé apparaît dans la liste avec ses modèles associés.

{% hint style="info" %}
Le nom technique (techname) d'un modèle n'est modifiable qu'à la création et uniquement pour les modèles ajoutés manuellement.
{% endhint %}

### Configurer les modèles par défaut

Trois modèles par défaut peuvent être définis pour la plateforme :

* **Modèle instruct (general-model)** — utilisé par le Druide pour les conversations. Accessible dans PyAI via `"default-instruct"`.
* **Modèle embedding (emb-model)** — utilisé pour la vectorisation des corpus. Accessible dans PyAI via `"default-embedding"`.
* **Modèle coder** — utilisé pour les fonctionnalités de code (MCP Dataset). Accessible dans PyAI via `"default-coder"`.

Le changement de modèle par défaut est **immédiatement effectif** sur toute la plateforme.

{% hint style="warning" %}
Un corpus créé avec un modèle d'embedding donné ne peut pas être utilisé avec un autre modèle d'embedding. Veillez à ne pas changer le modèle d'embedding par défaut si des corpus existants en dépendent.
{% endhint %}

### Modifier ou supprimer une clé API

* **Modifier** : ouvrez la clé, modifiez les champs souhaités et sauvegardez. Un modèle défini comme modèle par défaut ne peut pas être supprimé tant qu'il est en usage — un message explicite vous invite à changer le modèle par défaut au préalable.
* **Supprimer** : une modale affiche les éléments impactés (assistants, corpus, Dataflows) avant confirmation.

### Suivre la consommation de tokens

Depuis **Administration > Monitoring**, onglet **Tokens**, vous pouvez suivre la consommation de tokens de vos modèles LLM.

La page affiche pour la période sélectionnée :

* **Tokens de prompt** : tokens envoyés aux modèles
* **Tokens de complétion** : tokens générés en réponse
* **Total tokens** : somme des deux

Un graphe d'évolution est affiché pour chaque modèle configuré, avec le nom du modèle et le fournisseur associé. Vous pouvez naviguer entre les périodes via les flèches de navigation.
