# Utiliser votre propre clé d’IA

> Ajoutez une clé d’API OpenAI, Anthropic ou Google Gemini pour que les fonctionnalités IA d’Atheneum s’exécutent sur votre propre compte fournisseur sans limite de crédits, et voyez ce qui se passe quand la clé échoue.

URL: https://atheneum.app/fr/docs/byok
Language: Français (fr)
Where in the app: Paramètres → Connexions → Votre propre clé d’IA
Updated: 2026-10-25

Si vous avez une clé d’API OpenAI, Anthropic ou Google Gemini, vous pouvez l’ajouter à Atheneum. Tant que la clé est utilisée, toutes les fonctionnalités IA s’exécutent chez votre fournisseur avec le modèle que vous choisissez, et ne coûtent aucun crédit IA. Votre fournisseur vous facture ce que vous utilisez.

Il vous faut un compte. Toutes les offres peuvent ajouter une clé.

## Fournisseurs

| Fournisseur | Modèle par défaut | Modèles suggérés |
|---|---|---|
| OpenAI | gpt-5-mini | gpt-5-mini, gpt-5, gpt-4.1-mini |
| Anthropic (Claude) | claude-opus-5-5 | claude-opus-5-5, claude-sonnet-5-5, claude-haiku-5-5 |
| Google Gemini | gemini-2.5-flash | gemini-2.5-flash, gemini-2.5-pro |

Vous pouvez saisir n’importe quel nom de modèle auquel votre clé a accès ; les suggestions ne sont qu’un point de départ.

## Ajouter une clé

1. Ouvrez **Paramètres** et choisissez **Connexions**.
2. Faites défiler jusqu’à **Votre propre clé d’IA**.
3. Sous **Ajouter une clé**, choisissez un **Fournisseur**.
4. Facultatif : saisissez un **Modèle**. Laissez le champ vide pour utiliser le modèle par défaut du fournisseur, affiché dans le champ.
5. Collez votre clé dans **Clé d’API**. Si vous n’en avez pas, cliquez sur **Obtenir une clé …** pour ouvrir la page des clés du fournisseur.
6. Cliquez sur **Vérifier et enregistrer**.

Atheneum vérifie d’abord auprès du fournisseur que la clé fonctionne et peut utiliser le modèle choisi. Cette vérification passe par la consultation gratuite des modèles du fournisseur : elle ne vous coûte rien. Si elle réussit, vous verrez « Clé vérifiée et enregistrée. Toutes les fonctionnalités d’IA l’utilisent désormais. »

Vous ne pouvez avoir qu’une clé à la fois. En enregistrer une nouvelle, sous **Remplacer la clé**, remplace l’ancienne.

## Ce qu’elle débloque

Tant que votre clé est active :

- Athena, les résumés, les guides d’étude, les cartes mémoire, les quiz, la correction des quiz, les vérifications Blurt et les plans de leçon s’exécutent chez votre fournisseur, avec votre modèle.
- Ces actions ne coûtent aucun crédit IA, et votre allocation mensuelle ne les limite pas. Elles apparaissent quand même dans le panneau d’utilisation, à zéro crédit, pour que vous voyiez ce que vous avez utilisé.
- La mise en pause de l’IA gratuite ne vous concerne pas, même sur l’offre Free.

Ce qui ne change pas :

- Les limites de carnets, de fichiers, de stockage et d’import de votre offre s’appliquent toujours. Une clé change l’IA, pas le stockage.
- Vos crédits restent où ils sont, pour le moment où la clé sera mise en pause ou retirée.

## Ce qui utilise toujours des crédits

Deux choses s’exécutent toujours sur le service d’IA d’Atheneum et dépensent vos crédits, même avec une clé :

- **L’indexation des fichiers** : la préparation d’un fichier de carnet pour qu’Athena puisse y trouver des passages.
- **L’association de votre question à vos fichiers** : une petite étape qui classe des extraits de vos fichiers de carnet pour Athena. Si vous n’avez plus de crédits, elle se rabat sur une simple correspondance par mots-clés ; votre discussion fonctionne toujours.

## Mettre en pause, réactiver ou retirer une clé

La ligne de votre clé affiche le fournisseur, le modèle, les quatre derniers caractères de la clé et son état :

- **Utilisée pour toutes les fonctionnalités d’IA** : la clé est active. Cliquez sur **Mettre en pause** pour cesser de l’utiliser.
- **En pause — l’IA d’Atheneum est utilisée** : l’IA et les crédits de votre offre sont utilisés à la place. Cliquez sur **Réutiliser ma clé** pour la réactiver. Atheneum vérifie d’abord la clé de nouveau.
- **Refusée par le fournisseur — remplacez-la** : le fournisseur a refusé la clé lors d’une nouvelle vérification. Ajoutez une nouvelle clé.

Cliquez sur **Retirer** et confirmez pour supprimer la clé. L’IA d’Atheneum reprend alors le relais.

## Quand la clé échoue

Atheneum ne vous fait jamais passer à sa propre IA sans vous le demander. Si une requête avec votre clé échoue, vous voyez une erreur qui en donne la raison, par exemple :

- « OpenAI a refusé votre clé API. »
- « … indique que votre compte n’a plus de crédit ou de quota. »
- « … limite actuellement le nombre de requêtes de votre clé. »
- « … ne propose pas le modèle choisi pour cette clé. »
- « … a refusé cette requête. »
- « … a mis trop de temps à répondre. »
- « … a renvoyé une erreur. »

Une fenêtre, **Votre clé d’IA n’a pas fonctionné**, explique le problème et propose deux choix :

- **Corriger ma clé** ouvre Paramètres → Connexions pour que vous puissiez remplacer la clé ou changer de modèle.
- **Utiliser l’IA gratuite** met votre clé en pause (elle est conservée, pas supprimée) pour que la requête suivante utilise l’IA d’Atheneum et vos crédits. Relancez votre requête après le changement.

Rien n’a été facturé pour la requête qui a échoué.

## Confidentialité

- Votre clé est chiffrée avant d’être stockée. Elle n’est jamais renvoyée à votre navigateur ; seuls ses quatre derniers caractères sont affichés.
- Quand une clé est active, vos questions et les supports dont chaque action IA a besoin sont envoyés depuis les serveurs d’Atheneum à votre fournisseur au lieu du service d’IA d’Atheneum. Ce que le fournisseur en fait, y compris la conservation et l’entraînement, relève de votre propre contrat avec lui.
- Retirer la clé la supprime.

Voir la section de la politique de confidentialité sur l’utilisation de votre propre clé d’IA.

## Limites

- Une clé par compte.
- L’enregistrement, la mise en pause, la réactivation et le retrait sont limités à 15 modifications par tranche de 10 minutes. Au-delà, vous verrez « Trop de tentatives — réessayez dans quelques minutes. »

## Dépannage

- **« Collez d’abord votre clé d’API. »** Le champ **Clé d’API** est vide.
- **La vérification échoue à l’enregistrement.** Lisez le message : une clé refusée signifie généralement une faute de frappe ou une clé révoquée ; un modèle introuvable signifie que votre clé ne peut pas utiliser ce modèle. Essayez le modèle par défaut du fournisseur.
- **Je suis passé à l’IA gratuite et je veux récupérer ma clé.** Ouvrez Paramètres → Connexions et cliquez sur **Réutiliser ma clé**.
- **« Impossible de charger les réglages de votre clé d’IA. »** Rechargez la page.

## Voir aussi

- [Crédits IA](https://atheneum.app/fr/docs/ai-credits)
- [Athena, votre tutrice](https://atheneum.app/fr/docs/athena)
- [Offres](https://atheneum.app/fr/docs/plans)
- [Sécurité du compte](https://atheneum.app/fr/docs/security)