Utiliser votre propre clé API avec Self-Managed

Self-Managed permet à NameQuick d’utiliser votre propre compte auprès d’un fournisseur d’IA. Managed utilise le cloud de NameQuick dans l’Union européenne, ne nécessite aucune clé et n’utilise pas votre contenu pour entraîner l’IA.

Les commandes et messages de l’application sont reproduits ici en anglais.

Dans NameQuick 3, sur Mac comme sur Windows, la catégorie AI de Settings apparaît pour les comptes Self-Managed ; elle est masquée pour les comptes Managed. Cette page décrit la version 3.0.11. Pour traiter vos fichiers sur l’appareil, consultez les modèles locaux.

#Obtenir une clé auprès du fournisseur

Les consoles évoluent : suivez les indications officielles plutôt qu’un parcours figé.

OpenAI : créez une clé sur la 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 : créez votre clé dans la 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 : obtenez une clé dans Google AI Studio en suivant 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 : créez une clé OpenRouter et gérez son crédit en suivant le guide de démarrage. Cette clé n’est pas une clé directe d’OpenAI, d’Anthropic ou d’un autre fournisseur.

#Connecter le fournisseur et choisir le modèle

Ouvrez Settings → AI. Dans Provider, choisissez OpenAI, Anthropic, Gemini ou OpenRouter.
Pour un fournisseur non connecté, la fenêtre de connexion s’ouvre. Avec OpenAI, elle s’intitule Connect OpenAI : collez la clé dans Paste your OpenAI API key. Les espaces superflus sont supprimés automatiquement.
La vérification peut démarrer automatiquement ; sinon, cliquez sur Connect. L’état affiche Checking key… ou Validating API key….
Après validation, le message confirme l’enregistrement : Connected · key saved to the macOS Keychain sur Mac ou Connected · key saved to Windows Credential Manager sur Windows. Le fournisseur connecté devient actif.

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. Seule une clé vérifiée est enregistrée.

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.

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

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.

#Comprendre les coûts et tester

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.

#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 Settings → AI, 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.

#Savoir où vont vos fichiers

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.

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 — 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.

OpenAI rejected this key on the last run. Replace it to continue. Une clé auparavant fonctionnelle a été refusée. Utilisez Replace pour continuer.

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.

Si le stockage sécurisé est 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é.