Connecter une API compatible OpenAI
De nombreux services et serveurs d’IA utilisent le même format d’API qu’OpenAI. atbridge.ai fonctionne avec tous via une seule option de fournisseur, Compatible OpenAI (URL personnalisée). Rien à installer, aucune intégration à attendre : saisissez la Base URL et la clé API du service, et le atbridge Chat IA l’utilise comme n’importe quel autre fournisseur.
Cas typiques :
- Un modèle sur votre propre machine ou serveur : LM Studio, vLLM, le serveur llama.cpp, LocalAI.
- Un proxy géré par votre entreprise, par exemple LiteLLM devant plusieurs fournisseurs.
- Une passerelle d’API ou un revendeur qui vous donne accès à des modèles via un point de terminaison compatible OpenAI.
Ce dont vous avez besoin
Section intitulée « Ce dont vous avez besoin »- Base URL : l’adresse de l’API indiquée dans la documentation de votre
fournisseur. C’est la même valeur que le SDK OpenAI appelle
base_url, par exemplehttps://llm.example.com/v1. Collez-la telle qu’elle est documentée ; atbridge.ai l’accepte avec ou sans le/v1final. - Clé API : créée dans le tableau de bord de votre fournisseur. Un serveur
local qui ne vérifie pas les clés accepte n’importe quelle valeur fictive, comme
local.
Le service doit prendre en charge deux points de terminaison OpenAI standard avec
une authentification Authorization: Bearer : /v1/chat/completions (le chat
lui-même) et /v1/models (la liste des modèles, qu’atbridge.ai utilise aussi pour
vérifier la connexion). Presque tous les services compatibles OpenAI et serveurs
locaux fournissent les deux.
Serveurs locaux courants et leur Base URL habituelle (vérifiez votre propre configuration) :
| Serveur | Base URL habituelle |
|---|---|
| LM Studio | http://localhost:1234/v1 |
| vLLM | http://localhost:8000/v1 |
| llama.cpp server | http://localhost:8080/v1 |
| LiteLLM proxy | http://localhost:4000 |
L’ajouter à atbridge.ai
Section intitulée « L’ajouter à atbridge.ai »-
Dans Thunderbird, ouvrez les Paramètres atbridge : l’engrenage, ou Outils → Modules et thèmes → atbridge.ai → Options (voir Ouvrir les paramètres de l’extension atbridge). Allez dans l’onglet Fournisseurs d’IA.
-
Dans le menu Fournisseur, choisissez Compatible OpenAI (URL personnalisée).
-
Renseignez Base URL et collez votre clé dans Clé API. La clé est chiffrée sur cet appareil et n’atteint jamais les serveurs d’atbridge.ai.
-
Cliquez sur Connecter. atbridge.ai vérifie aussitôt l’adresse et la clé en demandant la liste des modèles. Si la vérification réussit, le statut passe à un ✓ vert ; si elle échoue, rien n’est enregistré et la raison s’affiche.
Choisir un modèle et discuter
Section intitulée « Choisir un modèle et discuter »Ouvrez le atbridge Chat IA (le bouton @b dans Thunderbird) et choisissez un modèle dans le menu des modèles, qui affiche les modèles annoncés par le service. Une passerelle peut lister des centaines de modèles ; pour en utiliser un par son nom exact, saisissez-le dans id de modèle personnalisé sous Paramètres → Fournisseur et modèle d’IA préférés.
Qui voit vos données
Section intitulée « Qui voit vos données »Avec un fournisseur compatible OpenAI, vos prompts, ainsi que tout texte de mail ou pièce jointe que vous donnez au Chat IA, sont envoyés à la Base URL que vous avez saisie. atbridge.ai ne les relaie pas et ne les stocke pas. Avant de connecter un service, assurez-vous de faire confiance à celui qui le gère et lisez ses conditions de confidentialité et de conservation des données. Pour les mails qui ne doivent pas quitter votre ordinateur, utilisez un serveur local (le tableau ci-dessus) ou Ollama.
Le configurer en ligne de commande
Section intitulée « Le configurer en ligne de commande »La même connexion depuis un terminal ; la clé est lue sur l’entrée standard, elle n’apparaît donc pas dans l’historique de votre shell :
echo "$MY_API_KEY" | atbridge connect activate --provider openai-compatible \ --base-url https://llm.example.com/v1 --key-stdinSi la connexion échoue
Section intitulée « Si la connexion échoue »- 404 ou “not found” : la Base URL est incorrecte. Copiez-la à nouveau depuis
la documentation du fournisseur ; en général, c’est l’adresse qui se termine
par
/v1. - 401 ou 403 : la clé est incorrecte, a expiré ou n’a pas accès à ce modèle.
- L’URL est correcte mais Connecter échoue toujours : le service ne fournit
peut-être pas la liste des modèles (
/v1/models), dont atbridge.ai a besoin pour vérifier la connexion. Demandez à votre fournisseur s’il la prend en charge. - Le chat répond mais ne consulte jamais vos mails : le modèle ne prend pas en charge l’appel d’outils. Choisissez un autre modèle.
Voir aussi
Section intitulée « Voir aussi »Was this page helpful?
Thanks for the feedback!