Endpoints API Open WebUI : connectez un LLM sans censure

Les valeurs dont vous avez besoin

Open WebUI n'a besoin que de trois choses de ce service. La première est l'URL de base, https://api.dolphinllm.com/v1. La deuxième est une clé API depuis votre compte. La troisième est l'ID de modèle, uncensored, qu'Open WebUI lit lui-même depuis la liste des modèles une fois la connexion établie.

Deux endpoints sont impliqués. GET /v1/models remplit la liste déroulante des modèles, et POST /v1/chat/completions transmet chaque message que vous envoyez. Rien d'autre n'est nécessaire pour le chat. C'est une API textuelle, donc les fonctionnalités image, audio et embedding d'Open WebUI n'ont rien à gérer ici.

Vous n'avez pas besoin d'une carte pour l'essayer. Après l'inscription, vous pouvez obtenir 0,50 $ de crédit d'essai en un clic sur la page des clés. Il dure 7 jours.

Ajoutez la connexion dans le panneau d'administration

Si Open WebUI est déjà en cours d'exécution, c'est la méthode la plus rapide.

1. Connectez-vous en tant qu'administrateur et ouvrez Paramètres admin, puis Connexions.
2. Dans la section API OpenAI, cliquez sur le bouton plus pour ajouter une connexion.
3. Collez https://api.dolphinllm.com/v1 comme URL et votre clé comme clé.
4. Utilisez le bouton de vérification à côté des champs. Une confirmation verte signifie que la liste des modèles est revenue.
5. Enregistrez, ouvrez une nouvelle conversation et sélectionnez uncensored dans le sélecteur de modèle.

Les noms de menu varient légèrement entre les versions d'Open WebUI. Si vous ne trouvez pas Connexions, recherchez « OpenAI » dans les paramètres. Les champs sont toujours les mêmes : URL, clé et parfois un filtre de modèle.

Configurez-le avec des variables d'environnement Docker

Pour une nouvelle installation, vous pouvez ignorer l'écran admin et passer la connexion au démarrage du conteneur. Open WebUI lit OPENAI_API_BASE_URL et OPENAI_API_KEY au démarrage.

Copydocker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL="https://api.dolphinllm.com/v1" \
  -e OPENAI_API_KEY="YOUR_KEY" \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

Puis accédez à http://localhost:3000, créez le premier compte (il devient l'administrateur) et le modèle devrait déjà être listé. Gardez la clé hors de l'historique du shell si la machine est partagée : mettez-la dans un fichier env et utilisez --env-file à la place.

Certaines versions d'Open WebUI traitent ces variables comme des valeurs initiales uniquement. Une fois que vous avez enregistré une connexion dans l'interface, la valeur stockée l'emporte. Si vous modifiez la variable et que rien ne se passe, modifiez la connexion dans Paramètres admin.

L'exécuter pour plusieurs personnes

Open WebUI dispose de ses propres comptes utilisateurs, donc une seule installation peut desservir un foyer ou une petite équipe tandis qu'une seule clé API se trouve sur le serveur. C'est pratique mais aussi un risque : chaque utilisateur dépense du même solde. Décidez qui obtient un compte, et consultez X-Balance-USD de temps en temps, pour qu'un week-end prolongé de jeu de rôle ne vous surprenne pas.

Conservez la clé dans une variable d'environnement ou un fichier de secrets, jamais dans une capture d'écran ou un document partagé. Votre clé se trouve sur la page Clé API ; si vous soupçonnez qu'elle a fui, remplacez-la dans Open WebUI dès que vous en avez une nouvelle. Pour une installation publique, placez-la derrière HTTPS et désactivez les inscriptions ouvertes afin que des inconnus ne puissent pas créer de comptes et utiliser votre crédit.

Un dernier point pour les configurations partagées : le modèle est ajusté pour répondre sans refus de contenu pour un usage adulte légal. C'est une fonctionnalité pour la fiction et la recherche privée, et cela signifie aussi que vous décidez des règles de la maison. Un prompt système sur le modèle partagé est l'endroit le plus simple pour les écrire. Rien de sexuel impliquant des mineurs n'est autorisé sur l'API, quel que soit le prompt.

Bons usages pour cette configuration

Les personnes qui connectent Open WebUI à un endpoint sans censure veulent généralement une fenêtre de chat propre sans les limites d'un chatbot hébergé. Les usages courants incluent la fiction longue et le worldbuilding, le jeu de rôle et les personnages compagnons pour adultes, la rédaction de matériel que les assistants grand public refusent de toucher, et l'aide ordinaire au codage ou à l'écriture. Le même modèle gère tout cela, vous pouvez donc changer de tâche au sein d'une seule conversation.

Open WebUI aide de quelques manières spécifiques. Les prompts enregistrés et les préréglages de modèle vous permettent de garder un personnage ou un persona d'éditeur à un clic. Le téléchargement de documents et les fonctionnalités de recherche web, lorsque vous les activez, envoient du texte supplémentaire dans le prompt, ce qui augmente l'utilisation de tokens, alors surveillez la taille de ce que vous joignez. Les dossiers de chat et la recherche facilitent le retour à un long projet.

Ce qu'il ne fera pas, c'est générer des images, de l'audio ou de la vidéo depuis cette connexion, car l'API est textuelle uniquement.

Testez l'endpoint avant d'accuser Open WebUI

La plupart des configurations échouées proviennent d'une faute de frappe dans l'URL ou d'une clé périmée, et les deux apparaissent plus rapidement dans un terminal. Exécutez ces deux appels depuis la machine qui héberge Open WebUI.

Copycurl https://api.dolphinllm.com/v1/models \
  -H "Authorization: Bearer YOUR_KEY"

curl https://api.dolphinllm.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Say hello in five words."}]
  }'

Le premier appel devrait lister uncensored. Le second devrait retourner une complétion de conversation normale. Vérifiez également les en-têtes de réponse : X-Balance-USD montre ce qu'il reste sur votre compte, ce qui est un moyen pratique de confirmer qu'Open WebUI dépense depuis la clé que vous pensez être la sienne.

La liste complète des paramètres est dans la documentation API.

Paramètres à modifier pour le chat

Prompt système et échantillonnage

Open WebUI vous permet de définir un prompt système par modèle ou par conversation. Parce que le modèle est ajusté pour répondre sans refus de contenu pour un usage adulte légal, un court prompt système qui fixe le ton, le persona ou le format de sortie fait plus qu'une longue liste de règles. La température, top_p, stop, seed et les pénalités sont transmises, donc les curseurs dans Open WebUI ont un effet.

Longueur du contexte

La fenêtre est de 100 000 tokens pour le prompt plus la complétion. Les longues conversations font croître le prompt à chaque tour, et vous payez pour tout l'historique à chaque fois. Si un fil devient lourd, commencez une nouvelle conversation ou résumez l'ancienne.

Requêtes en arrière-plan

Open WebUI peut envoyer des appels supplémentaires en arrière-plan pour les titres et les balises de conversation, en utilisant le même modèle par défaut. Sur une clé d'essai, qui autorise 2 requêtes simultanées et 60 par minute, ces appels peuvent saturer votre message réel. Désactivez la génération de titres et de balises, ou acceptez un court délai. Une clé complète autorise 8 requêtes simultanées et 300 par minute, ce qui est largement suffisant pour une installation personnelle ou petite équipe.

Streaming, mode JSON et outils

Open WebUI diffuse les réponses par défaut, et l'API prend en charge les événements envoyés par le serveur (stream: true), avec un bloc d'utilisation à la fin du flux. Vous voyez le texte apparaître token par token, et l'en-tête de solde sur la réponse finale reflète ce que vous avez dépensé.

L'appel de fonctions est également pris en charge par l'API : tools, tool_choice, tool_calls en streaming, et les résultats envoyés en tant que role: "tool". Jusqu'où Open WebUI expose cela dépend de sa version et des outils ou fonctions que vous installez, alors testez avec un petit outil avant de construire un workflow autour. Le mode JSON (response_format défini sur json_object) est utile lorsque vous appelez le même endpoint depuis des scripts à côté de l'interface de chat.

Un modèle pratique est de garder Open WebUI pour les personnes et d'utiliser la même clé depuis un script pour le travail par lots. Les deux passent par la même URL de base, donc un seul solde couvre tout. N'oubliez pas que les limites s'appliquent par clé : 8 requêtes simultanées sur une clé complète, partagées entre l'interface et vos scripts.

Erreurs courantes et correctifs

• Aucun modèle n'apparaît. L'URL manque probablement de /v1 ou contient une faute de frappe. Comparez-la caractère par caractère avec la valeur ci-dessus et supprimez toute barre oblique finale.
• Erreur d'authentification. La clé a été collée avec un espace au début ou à la fin, ou elle appartient à un compte supprimé. Copiez-la à nouveau depuis la page des clés.
• Le sélecteur de modèle affiche la mauvaise liste. Open WebUI interroge également d'autres connexions que vous avez ajoutées, comme un Ollama local. Désactivez celles que vous n'utilisez pas.
• Les réponses cessent d'apparaître en plein milieu du streaming. Un proxy inverse devant Open WebUI peut mettre en buffer les Server-Sent Events. Désactivez la mise en buffer pour cette route.
• Le solde est faible. Rechargez-le avant qu’il n’atteigne zéro. Les requêtes échouées ou refusées ne sont pas facturées, vous ne payez que pour les complétions qui ont été livrées.

Combien coûte une interface de chat sur cette API

La tarification est de 0,15 $ par 1 M de tokens d’entrée et de 0,50 $ par 1 M de tokens de sortie, prélevés sur le crédit prépayé. Prenons une interaction typique dans une conversation de longueur moyenne : 4 000 tokens d’historique en entrée et 500 tokens en sortie. L’entrée coûte 4 000 x 0,15 $ / 1 000 000 = 0,0006 $. La sortie coûte 500 x 0,50 $ / 1 000 000 = 0,00025 $. L’interaction coûte 0,00085 $.

À ce tarif, le crédit d’essai de 0,50 $ couvre environ 588 interactions, et un rechargement de 20 $ en couvre environ 23 500. Consultez la page de tarification pour les bonus de rechargement. Si vous souhaitez utiliser la même clé en dehors d’Open WebUI, par exemple dans des scripts qui n’ont pas besoin d’un écran de connexion, la page sur l’utilisation d’un LLM sans restrictions de connexion couvre cet aspect.

Plus de guides

• API LLM gratuite pour les développeurs : essai vs paiement à l’usage
• Comment utiliser un LLM sans restrictions de connexion