Passer au contenu principal
LobeChat est une interface de chat open-source soignée que vous pouvez exécuter dans un navigateur, en tant qu’application de bureau ou auto-hébergée. Elle atteint les points de terminaison compatibles OpenAI via son fournisseur OpenAI — définissez l’API Proxy Address sur https://api.tokios.com/v1 avec votre clé sk-tok-…, et LobeChat communiquera avec un modèle sur votre propre matériel au lieu de l’API hébergée par défaut.

​
Prérequis

Connecteur appairé

Installez et appairez tokios-connector à côté du modèle que vous souhaitez que LobeChat atteigne.

Modèle enregistré

Enregistrez un déploiement (nom public) pour ce modèle.

Clé API créée

Créez une clé sk-tok-…, éventuellement limitée à ce déploiement.

Backends pris en charge

Confirmez que votre backend local (Ollama, llama.cpp, vLLM, LM Studio) est en cours d’exécution.

​
Option A — configuration dans l’application

1

Ouvrir les paramètres du fournisseur OpenAI

Dans LobeChat, accédez à Settings → Language Model → OpenAI. Activez le fournisseur.
2

Définir la clé API et l'adresse du proxy

Entrez votre clé et pointez l’adresse du proxy vers Tokios :
L’API Proxy Address est la substitution de l’URL de base de LobeChat — incluez /v1.
3

Ajouter votre déploiement en tant que modèle

Ajoutez un modèle en utilisant le nom de déploiement public que vous avez enregistré dans l’onglet Models — par exemple, gemma-tunnel. Il s’agit de la valeur que LobeChat envoie dans le champ model, et non de l’identifiant de modèle local de votre backend.

​
Option B — configuration avec des variables d’environnement

Si vous auto-hébergez LobeChat (par exemple avec Docker), définissez ces variables d’environnement au lieu d’utiliser les champs de l’application :
.env
OPENAI_PROXY_URL substitue l’URL de base (incluez /v1), et OPENAI_MODEL_LIST=+gemma-tunnel ajoute votre déploiement au sélecteur de modèles. Les noms exacts des variables peuvent varier entre les versions de LobeChat — confirmez-les par rapport à la documentation sur les fournisseurs de modèles pour l’auto-hébergement pour votre version.
N’engagez jamais une clé sk-tok-… réelle dans le contrôle de version ou un fichier compose partagé. Fournissez-la plutôt via l’environnement ou le champ de l’application.

​
Interface hébergée, modèle domestique

Exécutez LobeChat où que ce soit — un navigateur, un VPS ou un conteneur — et il atteint toujours un modèle sur votre machine domestique. Le connecteur à côté de ce modèle appelle vers l’extérieur Tokios ; LobeChat appelle https://api.tokios.com/v1 avec votre clé. Vous n’avez pas besoin de lier votre backend à 0.0.0.0, d’ouvrir un port entrant ou de configurer un VPN.

​
Dépannage

La clé API envoyée par LobeChat est manquante, mal formée ou a été révoquée. Confirmez que la clé (dans l’application ou dans OPENAI_API_KEY) est la valeur complète sk-tok-… sans espace supplémentaire, et vérifiez son statut dans l’onglet Keys.
La valeur du modèle ne correspond pas à un déploiement enregistré, ou l’adresse du proxy manque /v1. Confirmez que le nom du modèle correspond au nom public dans l’onglet Models, et que l’adresse est https://api.tokios.com/v1.
Le connecteur pour ce déploiement est hors ligne ou a atteint sa limite de concurrence. Vérifiez l’onglet Connectors — le connecteur doit afficher Online, et la machine qui l’exécute doit toujours être active et accessible.

​
Étapes suivantes

Clients compatibles

Consultez la configuration de l’URL de base et de la clé pour d’autres clients compatibles OpenAI et Anthropic.

Clés API

Créez des clés limitées séparées pour les membres de l’équipe utilisant la même instance LobeChat.