Faites tourner LobeChat sur un endpoint compatible OpenAI personnalisé.
Updated 2026-07-29
Le module de fournisseurs de LobeChat accepte n'importe quel service compatible OpenAI : créez un fournisseur personnalisé avec le type SDK OpenAI, réglez l'endpoint sur https://api.apisrouter.com/v1, collez une seule clé, et récupérez la liste de modèles. Les id Claude, GPT, Gemini et DeepSeek atterrissent dans le sélecteur de modèle de chaque assistant.
Réponse rapide : un fournisseur personnalisé, un endpoint, une clé.
Ouvrez les réglages de LobeChat et allez dans la section fournisseur de service IA (libellée AI Service Provider ou Language Model selon la version). Depuis que le module de gestion de fournisseurs est arrivé en v1.44, vous pouvez créer un fournisseur personnalisé plutôt que de vous greffer sur l'entrée OpenAI intégrée : ajoutez un fournisseur, donnez-lui un id et un nom d'affichage (apisrouter / APIsRouter), choisissez le type SDK OpenAI, puis remplissez la clé API et l'URL proxy de l'endpoint avec https://api.apisrouter.com/v1. Dans la liste de modèles du fournisseur, utilisez l'action de récupération des modèles pour tirer chaque id que sert l'endpoint via /v1/models, activez ceux que vous voulez, et lancez la vérification de connectivité intégrée. À partir de là, n'importe quel assistant ou conversation peut sélectionner ces id depuis le sélecteur de modèle. Le projet vit désormais à lobehub/lobehub sur GitHub (le nom de dépôt lobe-chat redirige vers là), et les libellés de menu changent d'une version à l'autre, donc traitez le flux, entrée de fournisseur, type SDK, URL, clé, fetch, comme la partie stable plutôt que le libellé exact.
Provider ID: apisrouter
Provider Name: APIsRouter
SDK Type: OpenAI
API Key: sk-YOUR-APISROUTER-KEY
API Proxy URL: https://api.apisrouter.com/v1
Model List → Fetch models → enable ids → checkComment LobeChat route les requêtes vers un fournisseur.
LobeChat (environ 80 000 étoiles GitHub, désormais sous le nom LobeHub) est l'un des frameworks de chat open source les plus déployés : un client web soigné, des assistants avec leurs propres prompts et modèles, un système de plugins, et des fonctionnalités de base de connaissances, déployable en session navigateur ou auto-hébergé avec une base de données. Chaque entrée de fournisseur décrit où vont les requêtes et quel dialecte SDK parler. Un fournisseur personnalisé sur le type SDK OpenAI envoie des requêtes chat-completions standard vers votre URL proxy, avec l'id du modèle comme simple chaîne, exactement la forme qu'attend une passerelle multi-fournisseurs. Une seule entrée porte donc tout le catalogue : les assistants peuvent épingler claude-sonnet-4-6 pour du travail soigné pendant que les conversations rapides tournent sur gemini-3.5-flash, sans aucun second compte nulle part. L'URL de l'endpoint a une nuance documentée qui vaut la peine d'être citée : le besoin ou non d'un suffixe /v1 dépend du service qui se trouve derrière. LobeChat ajoute des chemins de route comme /chat/completions à la base que vous lui donnez, donc pour APIsRouter la valeur correcte est https://api.apisrouter.com/v1. Le symptôme documenté d'un suffixe manquant est le modèle qui renvoie une réponse vide au test ; si vous voyez cela, ajoutez /v1 et réessayez.
Auto-hébergement : le chemin par variable d'environnement.
Si vous déployez LobeChat vous-même, le même routage peut être livré dans le conteneur plutôt que cliqué dans l'interface. La paire classique surcharge le fournisseur OpenAI intégré : OPENAI_API_KEY prend la clé de la passerelle et OPENAI_PROXY_URL prend https://api.apisrouter.com/v1. Chaque utilisateur de ce déploiement hérite alors de l'endpoint sans toucher aux réglages. La visibilité des modèles se contrôle avec la syntaxe de liste de modèles : OPENAI_MODEL_LIST accepte +id pour ajouter, -id pour masquer, et id=Nom d'affichage pour relabeliser, les entrées étant séparées par des virgules. Commencer la valeur par -all vide la liste intégrée pour que seuls vos id explicites s'affichent, ce qui est la forme propre pour un déploiement curé. Les versions serveur plus récentes documentent aussi une famille CUSTOM_PROVIDER_* (count, id, name, type, base URL, keys) pour déclarer des fournisseurs personnalisés complets au moment du déploiement, correspondant à ce que fait le module d'interface. Vérifiez la référence de variables d'environnement actuelle pour votre version avant de vous y fier, car cette surface est plus récente que la paire OPENAI_* et encore en évolution.
OPENAI_API_KEY=sk-YOUR-APISROUTER-KEY
OPENAI_PROXY_URL=https://api.apisrouter.com/v1
OPENAI_MODEL_LIST=-all,+claude-sonnet-4-6=Claude Sonnet 4.6,+gpt-5.5,+gemini-3.5-flash,+deepseek-v4-proChoisir des modèles pour les assistants.
Comme tous les assistants facturent via une seule clé, la comparaison de modèles se résume à un changement de réglages d'assistant. Épinglez deux candidats sur deux assistants dupliqués, lancez vos vrais prompts pendant une semaine, et lisez la dépense par modèle dans la console APIsRouter à côté de la qualité de réponse que vous avez observée.
- Les assistants sont des épinglages de modèle par rôle. Un assistant de rédaction sur claude-sonnet-4-6, un assistant de réponse rapide sur claude-haiku-4-5-20251001, et un assistant de recherche sur gpt-5.5 coexistent tous derrière une seule entrée de fournisseur.
- gemini-3.5-flash est le choix de réactivité pour le modèle de conversation par défaut ; la plupart des tours dans un framework de chat sont courts, et des modèles rapides gardent l'interface avec une sensation instantanée.
- deepseek-v4-pro se justifie pour les longues conversations multilingues et le résumé intensif, où son comportement à long contexte par token dépensé fait tout l'attrait.
- Les conversations avec vision ont besoin d'un id capable de vision avec la capacité activée dans la config de modèle du fournisseur ; LobeChat expose des interrupteurs de capacité par modèle dans le module de fournisseur.
- Activez délibérément un sélecteur à deux niveaux, un id rapide et un id frontier, et n'en ajoutez d'autres que quand un vrai assistant en a besoin ; chaque modèle activé est une ligne que les utilisateurs doivent parcourir.
Paiement à l'usage · en dessous du tarif officiel
Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.
| Modèle | Prix officiel | Notre prix |
|---|---|---|
| Claude Sonnet 4.6 | $3.00 / $15.00 per M | $2.40 / $12.00 per M |
| GPT-5.5 | $5.00 / $30.00 per M | $4.00 / $24.00 per M |
| Gemini 3.5 Flash | $1.50 / $9.00 per M | $1.20 / $7.20 per M |
| DeepSeek V4 Pro | $0.43 / $0.87 per M | $0.40 / $0.90 per M |
| Claude Haiku 4.5 20251001 | $1.00 / $5.00 per M | $0.80 / $4.00 per M |
Modes d'échec spécifiques à LobeChat.
Une réponse vide sur la vérification de connectivité est la signature documentée d'un problème de suffixe de base URL. Ajoutez ou retirez le /v1 (pour APIsRouter il doit être présent) et réessayez avant de déboguer plus en profondeur. Des modèles manquants dans le sélecteur d'un assistant signifient généralement qu'ils ont été récupérés mais pas activés dans la liste de modèles du fournisseur, ou que l'interrupteur du fournisseur lui-même est désactivé. Les deux se trouvent sur le même écran de réglages que l'action de récupération. Sur les déploiements auto-hébergés, rappelez-vous la priorité : les variables d'environnement configurent les défauts côté serveur, tandis que les utilisateurs peuvent toujours saisir leurs propres réglages de fournisseur côté client selon l'auth et les feature flags de votre déploiement. Si un déploiement ignore votre OPENAI_PROXY_URL, confirmez que le conteneur a bien redémarré avec le nouvel environnement et que la session client ne le surcharge pas localement. La dérive de version est bien réelle ici : l'arborescence des réglages a été réorganisée plus d'une fois (Language Model, puis AI Service Provider, avec l'arrivée du module de fournisseur en v1.44), et les captures d'écran de tutoriels plus anciens ne correspondront pas aux menus actuels. Les champs eux-mêmes, id, name, type SDK, URL, clé, sont restés stables.
Qui route LobeChat via une passerelle.
- Les auto-hébergeurs qui font tourner LobeChat pour une équipe et veulent un seul endpoint dans le conteneur et un seul journal d'usage pour tout le monde, plutôt que des clés fournisseur par utilisateur.
- Les utilisateurs avancés d'assistants qui épinglent des fournisseurs différents par rôle, Claude pour la rédaction, GPT pour l'analyse, DeepSeek pour le volume, sans maintenir un compte pour chacun.
- Les utilisateurs qui veulent des modèles que la liste de fournisseurs intégrée ne porte pas, activés en récupérant le catalogue de la passerelle plutôt qu'en attendant les versions amont.
- Les développeurs sans accès à la facturation d'un fournisseur donné. Un accès basé sur la recharge, sans exigence de carte, supprime la dépendance à une inscription par fournisseur.
- Les personnes qui routent déjà leurs outils d'éditeur, de lanceur ou de CLI via une passerelle et veulent leur framework de chat sur la même clé.
Vérifiez l'endpoint et déboguez la première conversation.
Interrogez d'abord en curl le listing des modèles et gardez la sortie ouverte ; c'est l'orthographe faisant autorité pour chaque id que vous activez, que ce soit par fetch ou à la main. Lancez ensuite une completion de chat contre l'id que vous prévoyez de rendre par défaut. Dans LobeChat, faites tourner la vérification de connectivité avant les vraies conversations. Les échecs d'authentification renvoient au champ clé. Une réponse vide renvoie au suffixe /v1. Les erreurs de modèle introuvable sur un modèle spécifique signifient que l'id activé ne correspond pas au listing, ce qui arrive surtout après avoir édité à la main les noms d'affichage et les id ensemble. Une fois que les conversations circulent, la console APIsRouter affiche le modèle par requête, le nombre de tokens et la dépense. Un framework de chat avec assistants génère du trafic sur plusieurs modèles à la fois, et la vue d'usage par clé est là où l'habitude de chaque assistant devient un coût que vous pouvez voir par modèle, par jour.
curl -s https://api.apisrouter.com/v1/models \
-H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
curl -s https://api.apisrouter.com/v1/chat/completions \
-H "Authorization: Bearer $APISROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gemini-3.5-flash",
"messages":[{"role":"user","content":"ping"}]}'Questions fréquentes
Comment ajouter un fournisseur compatible OpenAI personnalisé à LobeChat ?
Dans les réglages, ouvrez la section fournisseur de service IA et créez un fournisseur personnalisé : id et nom d'affichage, type SDK OpenAI, endpoint https://api.apisrouter.com/v1, et votre clé. Récupérez la liste de modèles, activez les id que vous voulez, et lancez la vérification de connectivité.
L'URL de l'endpoint a-t-elle besoin de /v1 ?
Pour APIsRouter, oui : https://api.apisrouter.com/v1. LobeChat ajoute des routes comme /chat/completions à la base que vous lui donnez, et sa doc note qu'un mauvais suffixe se manifeste typiquement par une réponse vide au test. Si vous voyez cela, corrigez le suffixe et réessayez.
Qu'est-ce qu'OPENAI_PROXY_URL et quand l'utiliser ?
C'est la variable d'environnement d'auto-hébergement qui repointe le fournisseur OpenAI intégré de LobeChat vers une autre base URL. Réglez-la avec OPENAI_API_KEY dans le conteneur et chaque utilisateur de ce déploiement hérite de l'endpoint ; utilisez OPENAI_MODEL_LIST pour curer les id affichés.
Différents assistants peuvent-ils utiliser différents fournisseurs via un seul fournisseur ?
Oui. Chaque assistant épingle son propre modèle, et l'id voyage vers l'endpoint comme simple chaîne par requête. Une seule entrée de fournisseur peut servir un assistant Claude, un assistant GPT et un assistant DeepSeek côte à côte, tous facturés via la même clé.
LobeChat est-il le même projet que LobeHub ?
Oui. Le projet a changé de marque et le dépôt GitHub vit désormais à lobehub/lobehub, l'ancien nom lobe-chat redirigeant vers là. La doc et les menus mélangent les deux noms pendant la transition, ce qui explique aussi pourquoi les libellés de réglages varient d'une version à l'autre.
Pourquoi mes modèles récupérés n'apparaissent-ils pas dans les conversations ?
La récupération liste les id ; les activer est un interrupteur séparé par modèle dans la liste de modèles du fournisseur, et le fournisseur lui-même a un interrupteur d'activation. Vérifiez les deux, puis rouvrez le sélecteur de modèle. Si un id activé échoue toujours, comparez son orthographe à la sortie de /v1/models.