Utiliser votre propre clé API avec Self-Managed
Configurez OpenAI, Anthropic, Gemini, OpenRouter, Mistral, la passerelle d’IA de votre université ou un serveur compatible OpenAI dans NameQuick 3, sur Mac et Windows.
Avec Self-Managed, vous apportez votre propre clé API (BYOK, « Bring Your Own Key ») : NameQuick utilise votre compte auprès d’un fournisseur d’IA. Les commandes et messages de l’application sont reproduits ici en anglais.
Obtenir une clé auprès du fournisseur#
Les consoles évoluent : suivez les indications officielles plutôt qu’un parcours figé.
| Fournisseur | Où créer la clé | À savoir |
|---|---|---|
| OpenAI | Page des clés API | La facturation de l’API est distincte de l’abonnement ChatGPT, qui n’inclut pas de crédit API. |
| Anthropic | Claude Console, selon la documentation d’authentification | Privilégiez une clé limitée à l’espace de travail prévu, conformément à la politique de votre organisation. |
| Gemini | Google AI Studio, selon le guide officiel | Les quotas et conditions d’utilisation des données dépendent du niveau de facturation du projet. Les offres gratuites peuvent appliquer des conditions différentes : vérifiez-les avant de traiter des documents sensibles. |
| OpenRouter | Selon le guide de démarrage | Gérez son crédit chez OpenRouter. Cette clé n’est pas une clé directe d’OpenAI, d’Anthropic ou d’un autre fournisseur. |
| Mistral | Console Mistral | Certaines offres Mistral n’autorisent que quelques requêtes par minute sur un modèle, voire aucune. Si le renommage s’interrompt à cause d’une limite de débit, choisissez un autre modèle ou vérifiez vos limites dans la console. |
| Custom | Documentation de l’opérateur du serveur | Serveur compatible avec l’API de conversation OpenAI ; voir plus bas. |
Connecter le fournisseur et choisir le modèle#
Ouvrez SettingsAI.
Choisir le fournisseur
Dans Provider, choisissez OpenAI, Anthropic, Gemini, OpenRouter ou Mistral. Pour un fournisseur non connecté, la fenêtre de connexion s’ouvre ; avec OpenAI, elle s’intitule Connect OpenAI.
Coller la clé
Collez la clé dans Paste your OpenAI API key. Les espaces superflus sont supprimés automatiquement.
Laisser vérifier la clé
La vérification peut démarrer automatiquement ; sinon, cliquez sur Connect. L’état affiche Checking key… ou Validating API key…. Seule une clé vérifiée est enregistrée.
Choisir le modèle
Le fournisseur connecté devient actif. Choisissez ensuite le modèle séparément dans Model ; un modèle recommandé est présélectionné. Certains fournisseurs proposent aussi Reasoning effort, avec Low, Medium ou High. Les changements de fournisseur et de modèle sont enregistrés automatiquement.
Après validation, le message confirme l’enregistrement : Connected · key saved to the macOS Keychain.
Après validation, le message confirme l’enregistrement : Connected · key saved to Windows Credential Manager.
Bon à savoir
La vérification envoie une petite requête réelle pour confirmer que la clé fonctionne et que le compte dispose du crédit ou de la facturation nécessaires. Elle peut donc entraîner un coût minime chez le fournisseur.
Utiliser un serveur compatible OpenAI#
Dans Provider, choisissez Custom pour un serveur prenant en charge l’API de conversation OpenAI. Renseignez Base URL avec son adresse et Model name avec l’identifiant du modèle. Ajoutez une clé si le serveur l’exige. Vous passez par la passerelle d’IA de votre université ou de votre administration, comme ELM, Chat AI (GWDG) ou Albert API ? Consultez Utiliser la passerelle d’IA de votre université.
Attention
Utilisez une adresse HTTPS. Sans HTTPS, la clé et le contenu sont transmis sans chiffrement. NameQuick affiche alors Key and file content are sent unencrypted to this address. Vérifiez l’adresse et la politique de l’opérateur avant tout envoi.
Stocker, remplacer ou supprimer une clé#
Les clés sont conservées dans macOS Keychain sur Mac ou Windows Credential Manager sur Windows, jamais dans un simple fichier de réglages. Elles restent stockées après votre déconnexion du compte NameQuick.
Dans SettingsAI, utilisez Replace pour remplacer une clé. Pour la supprimer de NameQuick, cliquez sur Remove, puis confirmez avec Remove key. Cette suppression ne révoque pas la clé chez le fournisseur. Si elle a pu être exposée, révoquez-la aussi dans son tableau de bord.
Comprendre les coûts et savoir où vont vos fichiers#
La licence NameQuick et l’utilisation du fournisseur sont facturées séparément. Le coût dépend du fournisseur, du modèle, du contenu des fichiers et de votre compte.
Consultez les pages de consommation et de facturation du fournisseur. Testez quelques copies de fichiers avant de lancer un traitement important. Les essais d’un préréglage de nommage via Test this Preset sont gratuits côté NameQuick, mais sollicitent votre fournisseur et peuvent donc être facturés par celui-ci. Consultez le guide des préréglages de nommage.
En Self-Managed avec une API cloud, les fichiers à renommer sont transmis au fournisseur choisi ; rien n’est envoyé à NameQuick pour le nommage. Le fournisseur reçoit le contenu nécessaire à l’opération, qui peut inclure le fichier lui-même, notamment une image ou un PDF, et pas seulement un extrait de texte.
OpenRouter et les serveurs personnalisés ont leurs propres politiques de routage et d’utilisation des données. En cas d’échec du fournisseur, NameQuick ne bascule pas silencieusement vers Managed.
Résoudre les problèmes courants#
Les messages ci-dessous prennent OpenAI comme exemple.
« Invalid API key. Please check and try again. »
Vérifiez la clé et le fournisseur sélectionné, puis réessayez.
OpenAI rejected this key on the last run. Replace it to continue. signale qu’une clé auparavant fonctionnelle a été refusée. Utilisez Replace pour continuer.
« Your OpenAI account has no API credit. »
Le message complet est Your OpenAI account has no API credit. Add billing with OpenAI, then try again. Activez la facturation ou ajoutez du crédit chez OpenAI, puis relancez la vérification. La clé n’est pas enregistrée.
« Connection timed out » ou « No internet connection »
Connection timed out — check your internet ou No internet connection signale un problème réseau, pas la preuve d’une clé incorrecte. Vérifiez votre connexion, puis réessayez.
Unable to validate right now. Please try again. Réessayez plus tard ; ce message ne confirme pas que la clé est invalide.
Liste des modèles indisponible
Couldn't load OpenAI's model list. Showing your current model and the recommended set. La liste complète n’a pas pu être chargée, mais le modèle actuel et les modèles recommandés restent disponibles.
Stockage sécurisé illisible
Vérifiez l’accès à macOS Keychain ou à Windows Credential Manager selon votre système. Consultez le guide de dépannage si le problème persiste, sans communiquer votre clé.