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

# Clé API LLM

> Configurer la clé API qui alimente toutes les fonctionnalités IA de Stafx.

Stafx s'appuie sur un LLM externe pour ses fonctionnalités IA (extraction de CV, matching, génération et enrichissement de dossiers). **Vous fournissez votre propre clé API**.

## Fournisseurs supportés

| Fournisseur    | Console                                                | Recommandé pour                                |
| -------------- | ------------------------------------------------------ | ---------------------------------------------- |
| **Anthropic**  | [console.anthropic.com](https://console.anthropic.com) | Qualité élevée, simplicité                     |
| **OpenRouter** | [openrouter.ai](https://openrouter.ai)                 | Choix multiple de modèles, facturation unifiée |

## Configurer

1. Allez dans **Paramètres > Organisation** (propriétaire uniquement)
2. Section **Clé API LLM**, sélectionnez votre fournisseur
3. Collez votre clé API
4. Validez

La clé est chiffrée côté serveur. Elle est utilisée à la volée à chaque appel IA et n'est jamais exposée dans l'app.

## Sans clé API

Tant qu'aucune clé n'est configurée, toutes les fonctionnalités IA sont désactivées :

* Import de CV (le fichier est stocké mais l'extraction n'a pas lieu)
* Matching
* Génération et enrichissement de dossiers

L'app reste utilisable pour l'édition manuelle, mais perd tout l'apport IA.

## Quelle est la consommation typique

Voici les ordres de grandeur pour comprendre l'impact de chaque action :

| Action                                          | Appels IA                        |
| ----------------------------------------------- | -------------------------------- |
| Import d'un CV                                  | 1                                |
| Lancement d'un matching, mode standard          | 1 par **nouveau** candidat scoré |
| Lancement d'un matching, mode force             | 1 par candidat du vivier         |
| Création d'un dossier                           | 1                                |
| Régénération d'un dossier                       | 1                                |
| Enrichissement d'un dossier pour une mission    | 1                                |
| Édition manuelle, export DOCX/PDF, consultation | 0                                |

<Info>
  **Bonnes pratiques pour limiter la conso**

  * Soignez le briefing d'un besoin **avant** de lancer le matching.
  * Évitez le mode **force** sauf si nécessaire (briefing fortement modifié).
  * Ne régénérez pas un dossier si une simple édition manuelle suffit.
  * Enrichissez un dossier au moment de le présenter, pas à chaque modification du briefing.
</Info>

## Rôle propriétaire

Seul le propriétaire de l'organisation peut configurer ou modifier la clé API. Les autres membres utilisent l'IA via cette clé sans la voir.