Configuration de la clé API Open WebUI
Clé API Open WebUI : définissez votre propre clé dans Connexions
Renseignez ces champs sous Connexions dans le panneau d'administration avec votre propre clé API, et Open WebUI peut utiliser les modèles Claude. Payez à l'usage.
Admin Panel → Settings → Connections → OpenAI API → +
URL: https://api.aicodewith.ai/v1
API Key: sk-***
Save → new chat → model selector → claude-haiku-4-5-20251001Étapes de configuration
Enregistrez cette clé pour les terminaux suivants
Cet outil stocke la clé dans ses propres paramètres. Après vous être connecté, copiez la clé et collez-la dans le champ Clé API des étapes ci-dessous.
sk-***Les visiteurs déconnectés ne voient qu'un espace réservé. Connectez-vous et nous remplirons votre clé. Sign in · Obtenir une clé dans la console
Copier ne fait que placer la commande dans le presse-papiers. Vous devez encore l'exécuter dans un terminal, ou coller la clé dans les paramètres de l'outil. Comment obtenir une clé API
Ces étapes ont été testées sur Linux (Open WebUI v0.12.0). macOS et Windows n'ont pas encore été testés, ils ne sont donc pas listés.
Open WebUI pas encore installé ? Installez-le (ignorez cette étape si c'est déjà fait)
Exécutez
uv tool install open-webui, puisuv tool list | grep open-webui. Si la sortie liste open-webui avec une version, Open WebUI est installé. Exécutez ensuiteopen-webui serveet ouvrez l'adresse affichée dans le terminal.Exécutez uv tool list | grep open-webui pour confirmer qu'Open WebUI v0.12.0 est installé (version encadrée en rouge) Cliquez sur votre avatar et ouvrez le panneau d'administration
Sur la page d'accueil d'Open WebUI, cliquez sur votre avatar en bas à gauche, puis cliquez sur Panneau d'administration dans le menu.
Ouvrez la page d'accueil d'Open WebUI et cliquez sur votre avatar en bas à gauche ; l'entrée Panneau d'administration dans le menu est encadrée en rouge Cliquez sur Paramètres en haut
Sur la page du panneau d'administration, cliquez sur l'onglet Paramètres en haut.
Sur la page du panneau d'administration, cliquez sur l'onglet Paramètres en haut (encadré en rouge) Cliquez sur Connexions à gauche
Cliquez sur Connexions sous IA dans la barre latérale gauche. Vous devriez voir une section OpenAI API.
Dans la page Paramètres qui s'ouvre, cliquez sur Connexions sous IA dans la barre latérale gauche (encadré en rouge) Ajoutez une connexion avec l'URL et votre clé API
Dans la section OpenAI API, cliquez sur + à droite. Définissez l'URL sur
https://api.aicodewith.ai/v1, collez votre clé API (Obtenir une clé API), puis cliquez sur Enregistrer.Dans la section OpenAI API, cliquez sur + à droite pour ouvrir Ajouter une connexion : définissez l'URL sur https://api.aicodewith.ai/v1, collez votre clé API, puis cliquez sur Enregistrer Vérifiez que la connexion est activée
Après l'enregistrement, la connexion
https://api.aicodewith.ai/v1apparaît dans la section OpenAI API avec son interrupteur activé.Après l'enregistrement, la connexion https://api.aicodewith.ai/v1 apparaît dans la section OpenAI API et est activée (encadré en rouge) Vous voulez revérifier ? Ouvrez la connexion
Cliquez sur l'engrenage à côté de la connexion pour ouvrir Modifier la connexion et vérifier l'URL. La clé API reste masquée par des points.
Cliquez sur l'engrenage à côté de la connexion pour ouvrir Modifier la connexion : l'URL est https://api.aicodewith.ai/v1, et la clé API ci-dessous reste masquée par des points (Bearer) Choisissez un modèle dans une nouvelle conversation
Démarrez une nouvelle conversation et ouvrez le sélecteur de modèle. Si
claude-haiku-4-5-20251001et d'autres modèles sont listés, l'URL est correcte ; la validité de la clé se vérifiera à l'étape 9, lorsque vous recevrez une réponse.Ouvrez le sélecteur de modèle ; les modèles fournis par aicodewith apparaissent, avec claude-haiku-4-5-20251001 encadré en rouge Envoyez un message de test
Sélectionnez
claude-haiku-4-5-20251001et envoyezReply with exactly: Hello from aicodewith.ai. Une réponseHello from aicodewith.aisignifie que vous avez terminé.Sélectionnez claude-haiku-4-5-20251001 et envoyez « Reply with exactly: Hello from aicodewith.ai » ; le modèle répond Hello from aicodewith.ai (encadré) À quoi ressemble une URL incorrecte : OpenAI: Network Problem
Si l'URL est incorrecte (par exemple
https://api.aicodewith.ai/nope), cliquer sur Vérifier (icône d'actualisation) afficheOpenAI: Network Problemen haut à droite. Consultez Erreurs courantes pour la solution.Si l'URL est incorrecte (p. ex. elle se termine par /nope), cliquer sur Vérifier (icône d'actualisation) affiche la notification « OpenAI: Network Problem » en haut à droite (encadré) Remettez l'URL sur /v1 et discutez à nouveau
Remettez l'URL sur
https://api.aicodewith.ai/v1et enregistrez. Dans une nouvelle conversation, une réponseHello from aicodewith.aisignifie que tout fonctionne à nouveau.Après avoir rétabli l'URL https://api.aicodewith.ai/v1 et enregistré, une nouvelle conversation répond à nouveau Hello from aicodewith.ai, confirmant que la configuration est rétablie
Erreurs courantes
OpenAI : problème de réseau
Ce que vous voyez
OpenAI : problème de réseau
- Cause
- L'URL de connexion est incorrecte (par exemple https://api.aicodewith.ai/nope), donc le bouton Vérifier (icône d'actualisation) ne peut pas se connecter.
- Comment corriger
- Définissez l'URL sur https://api.aicodewith.ai/v1 et enregistrez ; une nouvelle conversation répond alors normalement.
Revenir à l’étape 5 : Ajouter une connexion avec l'URL et votre clé API →
FAQ
Comment utiliser ma propre clé API dans Open WebUI ?
Dans le panneau d'administration → Paramètres → Connexions, cliquez sur + dans la section API OpenAI, définissez l'URL sur https://api.aicodewith.ai/v1, collez votre clé API et enregistrez.
Dois-je saisir à nouveau la clé API Open WebUI ?
Non. La clé est stockée dans la base de données propre d'Open WebUI et survit à un redémarrage, sans qu'aucune variable d'environnement ne soit nécessaire.
Comment vérifier la version d'Open WebUI ?
open-webui n'a pas d'option --version. Si vous l'avez installé avec uv, exécutez uv tool list | grep open-webui.
Open WebUI affiche « OpenAI : problème de réseau ». Que faire ?
L'URL de connexion est incorrecte. Définissez-la sur https://api.aicodewith.ai/v1 et enregistrez ; voir les erreurs courantes ci-dessus.