Avant de commencer
- Créez une clé API. Dans le portail, ouvrez Clés API et cliquez sur Créer la clé. Votre clé commence par
ni_live_. - Ajoutez des crédits. Les nouveaux comptes démarrent avec un solde de 0 $, et chaque requête est refusée tant que vous n'ajoutez pas de crédits. Ouvrez Facturation et cliquez sur Acheter des crédits.
- Installez Docker. Installez Docker Desktop et démarrez-le. Sous Windows, Docker Desktop utilise WSL 2 ; acceptez cette option pendant l'installation.
Démarrer Open WebUI
Exécutez ceci dans un terminal (cela fonctionne de la même façon dans PowerShell et dans Terminal sur Mac et Linux) :
docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main
Ouvrez http://localhost:3000 et créez votre compte. Le premier compte créé devient l'administrateur.
Connecter Open WebUI à Inférence Nordique
- Cliquez sur votre nom ou votre avatar, puis sur Settings, puis Admin, puis Connections.
- À côté de Manage OpenAI API Connections, cliquez sur +.
- Saisissez l'URL
https://northerninference.ca/v1et collez votre cléni_live_. - Cliquez sur Save.
Open WebUI liste alors automatiquement les modèles d'Inférence Nordique. Démarrez un nouveau clavardage, choisissez un modèle comme claude-sonnet-4-6-t4 et envoyez un message. Il apparaît dans le portail sous Utilisation en quelques secondes.
Les noms se terminant par -t3 fonctionnent au Canada, par exemple mistral-large-2402-t3. La page Modèles liste chaque modèle et son prix.
Définir plutôt la connexion dans docker-compose (facultatif)
Vous pouvez aussi transmettre la connexion sous forme de variables d'environnement :
services:
open-webui:
image: ghcr.io/open-webui/open-webui:main
ports:
- "3000:8080"
environment:
OPENAI_API_BASE_URL: https://northerninference.ca/v1
OPENAI_API_KEY: ni_live_YOUR_KEY_HERE
volumes:
- open-webui:/app/backend/data
Open WebUI ne lit ces valeurs qu'à son premier démarrage. Ensuite, il conserve les paramètres enregistrés dans sa base de données : modifier le fichier plus tard n'a donc aucun effet. Modifiez plutôt la connexion dans Settings, Admin, Connections.
Une clé par personne (facultatif)
Chaque utilisateur d'Open WebUI a ses propres paramètres Connections. Si chaque membre de votre équipe a sa propre clé Inférence Nordique, il peut l'ajouter là plutôt que de partager une seule clé pour tout le serveur.
Dépannage
| Ce que vous voyez | Ce qu'il faut faire |
|---|---|
| Aucun modèle dans la liste des modèles | Vérifiez l'URL et la clé dans Settings, Admin, Connections. L'URL doit être exactement https://northerninference.ca/v1. |
402 Insufficient credits. Add credits in the portal under Billing (https://northerninference.ca/portal/?page=billing) to continue. | Ajoutez des crédits dans le portail, sous Facturation. |
404 Model 'X' is not a route this key can call. | Choisissez un modèle dans la liste, ou tapez ni-models comme message de clavardage pour lister les modèles que votre clé peut appeler. |
| Vous avez modifié le fichier compose et rien ne s'est passé | Open WebUI conserve ses paramètres enregistrés. Modifiez plutôt la connexion dans Settings. |