Aller au contenu
Ressources pour développeurs
Ressources pour développeurs

Open WebUI

Installez Open WebUI, ajoutez RunAPI comme connexion compatible OpenAI, sélectionnez un modèle et vérifiez un chat.

Voir en Markdown

Connectez Open WebUI à RunAPI via sa connexion compatible OpenAI. Vous avez besoin d’un accès administrateur Open WebUI et d’une clé API RunAPI standard obtenue dans le Guide d’authentification.

Installer Open WebUI

Suivez le démarrage rapide officiel d’Open WebUI pour votre plateforme. Pour une installation Docker locale, l’image officielle peut être démarrée avec :

SHELL 
docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main

Ouvrez l’application, créez le compte administrateur et connectez-vous avant d’ajouter la connexion.

Ajouter la connexion RunAPI

  1. Ouvrez Admin Settings → Connections → OpenAI, puis sélectionnez Add Connection.
  2. Définissez l’URL sur https://runapi.ai/v1 et saisissez votre clé API RunAPI.
  3. Laissez Model IDs (Filter) vide lors de la première tentative de connexion afin qu’Open WebUI puisse découvrir les modèles disponibles.
  4. Enregistrez la connexion et attendez la fin de la vérification.

Open WebUI envoie la vérification de connexion depuis son backend et utilise GET /v1/models pour la découverte. L’URL RunAPI est en HTTPS public, donc une installation Docker n’a pas besoin de host.docker.internal pour cette connexion.

Sélectionner un modèle

Ouvrez une nouvelle conversation et sélectionnez un modèle RunAPI dans le sélecteur de modèle de conversation. Utilisez le Catalogue de modèles pour confirmer l’identifiant et les capacités actuels du modèle.

Si la découverte ne renseigne pas le sélecteur, modifiez la connexion et ajoutez l’identifiant exact sous Model IDs (Filter). Une erreur de découverte de modèle et une erreur de Chat Completions sont des signaux distincts ; testez le modèle ajouté manuellement avant de supprimer la connexion.

Vérifier la connexion

Envoyez une courte invite comme Reply with the word connected. Une réponse normale en streaming ou complète confirme qu’Open WebUI peut utiliser le modèle RunAPI sélectionné.

Résoudre les problèmes

  • La vérification retourne 401 ou 403 : remplacez la clé API dans la connexion par une clé standard valide issue du Guide d’authentification.
  • Aucun modèle RunAPI n’apparaît : confirmez que l’URL se termine par /v1, puis ajoutez un identifiant actuel dans Model IDs (Filter) et relancez le chat.
  • Le modèle est visible mais le chat échoue : confirmez que l’identifiant prend en charge Chat Completions compatible OpenAI dans le Catalogue de modèles, puis inspectez les journaux du backend Open WebUI pour connaître l’état de la requête.
  • Une URL locale fonctionne dans le navigateur mais pas dans Open WebUI : les connexions Open WebUI proviennent de son backend. Cela n’affecte pas l’URL publique https://runapi.ai/v1, mais c’est important pour les autres connexions locales.

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 .