Aller au contenu

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.
  • 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 exemple https://llm.example.com/v1. Collez-la telle qu’elle est documentée ; atbridge.ai l’accepte avec ou sans le /v1 final.
  • 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) :

ServeurBase URL habituelle
LM Studiohttp://localhost:1234/v1
vLLMhttp://localhost:8000/v1
llama.cpp serverhttp://localhost:8080/v1
LiteLLM proxyhttp://localhost:4000
  1. 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.

  2. Dans le menu Fournisseur, choisissez Compatible OpenAI (URL personnalisée).

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

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

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.

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.

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 :

Fenêtre de terminal
echo "$MY_API_KEY" | atbridge connect activate --provider openai-compatible \
--base-url https://llm.example.com/v1 --key-stdin
  • 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.

Was this page helpful?