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.

Panneau d'administration → Paramètres → ConnexionsUI
config
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.

Clé API
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.

  1. Open WebUI pas encore installé ? Installez-le (ignorez cette étape si c'est déjà fait)

    Exécutez uv tool install open-webui, puis uv tool list | grep open-webui. Si la sortie liste open-webui avec une version, Open WebUI est installé. Exécutez ensuite open-webui serve et 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)
  2. 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
  3. 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)
  4. 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)
  5. 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
  6. Vérifiez que la connexion est activée

    Après l'enregistrement, la connexion https://api.aicodewith.ai/v1 apparaî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)
  7. 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)
  8. 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-20251001 et 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
  9. Envoyez un message de test

    Sélectionnez claude-haiku-4-5-20251001 et envoyez Reply with exactly: Hello from aicodewith.ai. Une réponse Hello from aicodewith.ai signifie 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é)
  10. À 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) affiche OpenAI: Network Problem en 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é)
  11. Remettez l'URL sur /v1 et discutez à nouveau

    Remettez l'URL sur https://api.aicodewith.ai/v1 et enregistrez. Dans une nouvelle conversation, une réponse Hello from aicodewith.ai signifie 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 →

Si l'URL est incorrecte (par ex. elle se termine par /nope), cliquer sur Vérifier (icône d'actualisation) affiche la notification « OpenAI : problème de réseau » en haut à droite (encadrée).

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.

Sources

Liens connexes