Ressources pour développeurs

LibreChat

Configurez un endpoint personnalisé LibreChat pour RunAPI, montez son YAML dans Docker, redémarrez et vérifiez un chat.

Les points de terminaison personnalisés LibreChat relèvent de la configuration du déploiement, et non d’un formulaire de connexion par utilisateur. Vous devez avoir accès aux fichiers de déploiement LibreChat et disposer d’une clé API RunAPI standard issue du Guide d’authentification.

Installer LibreChat

Installez LibreChat avec la configuration locale officielle ou utilisez votre déploiement existant. Terminez l’installation avant d’ajouter l’endpoint personnalisé.

Ajouter le point de terminaison RunAPI

Créez ou mettez à jour librechat.yaml dans le répertoire de déploiement de LibreChat. Remplacez YOUR_RUNAPI_MODEL_ID par un identifiant actuel du Catalogue de modèles.

YAML

version: 1.3.13
endpoints:
  custom:
    - name: "RunAPI"
      apiKey: "${RUNAPI_API_KEY}"
      baseURL: "https://runapi.ai/v1"
      models:
        default: ["YOUR_RUNAPI_MODEL_ID"]
        fetch: true
      titleConvo: true
      titleModel: "current_model"
      modelDisplayLabel: "RunAPI"

Stockez la clé dans .env, et non directement dans le fichier YAML :

SHELL

RUNAPI_API_KEY=YOUR_RUNAPI_API_TOKEN

Pour Docker Compose, assurez-vous que docker-compose.override.yml monte le fichier de configuration :

YAML

services:
  api:
    volumes:
      - ./librechat.yaml:/app/librechat.yaml

Redémarrez le déploiement LibreChat après avoir modifié l’un de ces fichiers.

Sélectionner un modèle

models.default garantit au moins un modèle connu. Avec models.fetch: true, LibreChat demande également l’inventaire de modèles actuel. Conservez un identifiant par défaut valide même lorsque la découverte est activée, afin que le point de terminaison reste utilisable si la découverte est temporairement indisponible.

Vérifier la connexion

Après le redémarrage, sélectionnez RunAPI dans le sélecteur de point de terminaison, choisissez le modèle configuré et envoyez Reply with the word connected. Une réponse normale confirme à la fois la configuration du déploiement et la requête de modèle.

Résoudre les problèmes

RunAPI est absent du sélecteur de point de terminaison : validez l’indentation YAML, confirmez que docker-compose.override.yml monte le fichier et redémarrez le conteneur API.
Le point de terminaison se charge mais l’authentification échoue : confirmez que .env définit RUNAPI_API_KEY pour le conteneur API et recréez le conteneur si son environnement est obsolète.
Aucun modèle récupéré n’apparaît : conservez un identifiant actuel dans models.default, confirmez que baseURL se termine par /v1 et consultez les journaux du conteneur API.
LibreChat ignore le YAML modifié : vérifiez que le chemin hôte et le chemin conteneur dans le point de montage du volume pointent vers le fichier que vous avez modifié.

Pour le comportement de protocole partagé, utilisez le démarrage rapide de l’API LLM . Pour les champs de requête et de réponse, consultez la référence de l’API Chat Completions .