--- title: Open WebUI | RunAPI description: Installez Open WebUI, ajoutez RunAPI comme connexion compatible OpenAI, sélectionnez un modèle et vérifiez un chat. url: https://runapi.ai/fr/docs/resources/application-practices/open-webui.md canonical: https://runapi.ai/fr/docs/resources/application-practices/open-webui locale: fr --- > Version HTML: https://runapi.ai/fr/docs/resources/application-practices/open-webui > Index du site pour les agents: https://runapi.ai/llms.txt # Open WebUI 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](https://runapi.ai/fr/docs/guides/authentication.md). ## Installer Open WebUI Suivez le [démarrage rapide officiel d'Open WebUI][1] pour votre plateforme. Pour une installation Docker locale, l'image officielle peut être démarrée avec : [1]: https://docs.openwebui.com/getting-started/quick-start/ ```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](https://runapi.ai/fr/models) 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](https://runapi.ai/fr/docs/guides/authentication.md). * **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](https://runapi.ai/fr/models), 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 ](https://runapi.ai/fr/docs/guides/llm-api/quickstart.md). Pour les champs de requête et de réponse, consultez la [référence de l'API Chat Completions ](https://runapi.ai/fr/docs/api/openai/chat-completions.md). --- ## Plus de ressources de RunAPI - [Accueil](https://runapi.ai/fr/.md) - [Catalogue de modèles](https://runapi.ai/fr/models.md) - [Tarifs](https://runapi.ai/fr/pricing.md) - [Fournisseurs](https://runapi.ai/fr/models) - [Documentation](https://runapi.ai/fr/docs/guides) - [SDK](https://runapi.ai/fr/sdk.md) - [CLI](https://runapi.ai/fr/cli.md) - [Serveur MCP](https://runapi.ai/fr/mcp.md) - [Claude Code vs Cursor](https://runapi.ai/fr/claude-code-vs-cursor.md) - [Configuration de l’API Cursor](https://runapi.ai/fr/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/fr/openrouter-alternative.md) - [Entreprise](https://runapi.ai/fr/contact.md) - [Contact](https://runapi.ai/fr/contact.md) - [Conditions](https://runapi.ai/fr/terms.md) - [Confidentialité](https://runapi.ai/fr/privacy.md) - [Index du site pour les agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Données structurées ```json [ { "@context": "https://schema.org", "inLanguage": "fr", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/fr", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/fr/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "fr", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/fr", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/fricon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "fr", "@type": "TechArticle", "headline": "Open WebUI", "description": "Installez Open WebUI, ajoutez RunAPI comme connexion compatible OpenAI, sélectionnez un modèle et vérifiez un chat.", "url": "https://runapi.ai/fr/docs/resources/application-practices/open-webui", "mainEntityOfPage": "https://runapi.ai/fr/docs/resources/application-practices/open-webui" } ] ```