Skip to main content
LibreChat est un client AI open source hautement configurable, qui utilise librechat.yaml pour décrire les fournisseurs, les modèles et les règles de routage. Il prend en charge des points de terminaison compatibles avec OpenAI personnalisés, permettant ainsi de se connecter à Ace Data Cloud. Cet article décrit le processus de configuration.

Processus de demande

Pour intégrer Ace Data Cloud dans LibreChat, commencez par vous rendre sur le tableau de bord Ace Data Cloud pour obtenir votre jeton API, à conserver pour référence. Obtenir la clé API Ace Data Cloud Si vous n’êtes pas encore connecté ou inscrit, vous serez automatiquement redirigé vers la page de connexion pour vous inviter à vous inscrire et à vous connecter. Après vous être connecté ou inscrit, vous serez automatiquement renvoyé à la page actuelle. Lors de votre première demande, un quota gratuit sera offert, vous permettant d’expérimenter gratuitement les services de modèle d’Ace Data Cloud.

Déployer LibreChat

LibreChat se déploie via Docker Compose, commencez par préparer le répertoire et télécharger la configuration officielle :
Dans le fichier .env, générez JWT_SECRET, JWT_REFRESH_SECRET, CREDS_KEY, CREDS_IV et d’autres clés de sécurité avec openssl rand -hex 32, et configurez ALLOW_REGISTRATION selon vos besoins.

Configurer Ace Data Cloud

Créez librechat.yaml, en ajoutant Ace Data Cloud comme point de terminaison OpenAI compatible personnalisé (pour une description complète des champs, voir la documentation officielle des points de terminaison personnalisés, remplacez {token} par votre jeton) :
Dans le fichier docker-compose.yml, montez ce fichier dans le service api, puis démarrez avec docker compose up -d :
Notez les règles de chemin pour baseURL :

Choisir un modèle

Le répertoire des modèles sera mis à jour en continu. Utilisez de préférence la liste des modèles chargée automatiquement par le client ; si vous devez remplir manuellement, demandez d’abord GET https://api.acedata.cloud/v1/models pour obtenir l’ID du modèle actuel, puis choisissez en fonction des capacités de contexte, d’image et d’appel d’outils prises en charge par le client.

Vérifier l’intégration

Si vous n’êtes pas sûr que le problème provienne de LibreChat ou du réseau, vous pouvez d’abord vérifier le point de terminaison directement avec curl (remplacez {token} par votre jeton) :
Le retour d’un objet chat.completion compatible avec OpenAI indique que le jeton et le point de terminaison sont prêts ; si vous recevez HTTP 403 used_up, cela signifie que le jeton est valide mais que le solde est insuffisant, rechargez sur le tableau de bord.

Avancé : astuces de configuration yaml

librechat.yaml prend en charge plusieurs groupes de points de terminaison, vous pouvez utiliser apiKey: "user_provided" pour permettre à chaque utilisateur de remplir sa propre clé ; titleModel spécifie le modèle pour générer le titre de la conversation ; dropParams peut être utilisé pour supprimer uniformément les paramètres non pris en charge par l’API cible. Pour plus de détails, voir détails de la configuration de librechat.yaml.

Questions fréquentes

Pas de point de terminaison Ace Data Cloud après le démarrage

Il s’agit généralement d’un problème de montage du yaml dans le conteneur ou d’une erreur d’indentation. Vérifiez les volumes dans docker-compose.yml et validez l’indentation du yaml.

Message 404

Le baseURL a été écrit comme .../openai/v1 ou /v1 a été omis. Modifiez-le en https://api.acedata.cloud/v1.

Liste des modèles vide

Si fetch: true mais que /v1/models échoue, changez en fetch: false et listez manuellement default.

Modifications du yaml non effectives

Il est nécessaire de redémarrer le conteneur : docker compose restart api.

En savoir plus