FR ▾

Configuration de l'API compatible OpenAI pour Open WebUI en 5 minutes

Pour utiliser les paramètres de l'API compatible OpenAI pour open webui, ajoutez une connexion avec une URL de base et une clé, et le modèle apparaît dans le sélecteur. Voici la configuration exacte pour Abliterated API, de Docker à la première conversation.

Mis à jour

Interface de chat reliée par un câble lumineux à un serveur API hébergé, représentant une connexion Open WebUI

Points clés

  • L'URL de base est https://api.abliteratedapi.com/v1 et l'ID du modèle est uncensored.
  • Ajoutez-le dans les paramètres des connexions administrateur, ou passez OPENAI_API_BASE_URL et OPENAI_API_KEY à Docker.
  • Testez la clé avec curl d'abord, afin de distinguer un problème de clé d'un problème d'interface.
  • Open WebUI n'est que le front-end : vous payez par token pour ce que le modèle lit et écrit, et aucune carte n'est nécessaire pour commencer.

Le résumé

Si vous voulez la configuration de l'API compatible OpenAI pour open webui en un paragraphe : ouvrez les paramètres administrateur, ajoutez une connexion API OpenAI, définissez l'URL sur https://api.abliteratedapi.com/v1, collez votre clé, enregistrez, et sélectionnez le modèle appelé uncensored. C'est tout. Open WebUI communique avec tout ce qui implémente le format de complétions de chat OpenAI, et cette API le fait.

Le service est une API textuelle hébergée compatible OpenAI exécutant un modèle à poids ouverts, optimisé pour répondre sans refus de contenu pour une utilisation adulte légale. Il est géré par un fournisseur indépendant et n'est pas l'API officielle d'un laboratoire de modèles. Open WebUI est simplement l'interface de chat que vous branchez dessus.

Avant de commencer

  • Une clé API. Créez-en une sur la page Clé API. L'inscription se fait avec Google ou avec un e-mail et un mot de passe. Les nouveaux utilisateurs peuvent réclamer 0,50 $ de crédit d'essai en un clic sur cette page, valable 7 jours et sans carte requise.
  • Une instance Open WebUI en cours d'exécution. Une installation Docker ou une installation pip fonctionnent toutes les deux. Les étapes ci-dessous couvrent Docker et l'écran des paramètres.
  • Un accès réseau depuis la machine exécutant Open WebUI vers api.abliteratedapi.com via HTTPS.

Vérifiez la clé avant de toucher à l'interface. Si cet appel renvoie une liste contenant uncensored, la clé et l'URL sont bonnes :

curl https://api.abliteratedapi.com/v1/models   -H "Authorization: Bearer $ABLITERATED_API_KEY"

Puis confirmez qu'une véritable complétion fonctionne :

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

Méthode 1 : ajouter la connexion dans les paramètres

C'est la méthode la plus simple et elle fonctionne sur une installation existante. Les libellés du menu changent entre les versions d'Open WebUI, donc les noms ci-dessous peuvent différer légèrement.

  1. Connectez-vous à Open WebUI en tant qu'administrateur et ouvrez le Panneau d'administration, puis Paramètres, puis Connexions.
  2. Trouvez la section API OpenAI et ajoutez une nouvelle connexion avec le bouton plus.
  3. Dans le champ URL, entrez https://api.abliteratedapi.com/v1. Arrêtez-vous à /v1. N'ajoutez pas /chat/completions ; Open WebUI ajoute le chemin lui-même.
  4. Collez votre clé dans le champ clé. Elle est envoyée en tant que Authorization: Bearer <key>.
  5. Utilisez le bouton de vérification à côté des champs si votre version en dispose, puis enregistrez.

Ouvrez un nouveau chat et ouvrez le sélecteur de modèle. Le modèle uncensored devrait figurer dans la liste, car Open WebUI le lit via GET /v1/models. Si la liste reste vide, consultez la section de dépannage ci-dessous.

Méthode 2 : la configurer au démarrage avec Docker

Pour une nouvelle installation, transmettez l'endpoint en tant que variables d'environnement. Open WebUI lit OPENAI_API_BASE_URL et OPENAI_API_KEY au démarrage.

# base URL: https://api.abliteratedapi.com/v1   model to pick in the UI: uncensored
docker run -d -p 3000:8080   -e OPENAI_API_BASE_URL="https://api.abliteratedapi.com/v1"   -e OPENAI_API_KEY="$ABLITERATED_API_KEY"   -v open-webui:/app/backend/data   --name open-webui --restart always   ghcr.io/open-webui/open-webui:main

Puis visitez http://localhost:3000, créez le premier compte (il devient l'administrateur) et lancez une conversation. Le volume nommé conserve vos conversations et paramètres lorsque vous mettez à jour le conteneur.

Un point qui surprend : de nombreux paramètres d'Open WebUI sont enregistrés dans sa base de données après le premier lancement, et la valeur enregistrée peut l'emporter sur une variable d'environnement ultérieure. Si vous modifiez la clé ou l'URL dans Docker et que rien ne se passe, modifiez-les dans l'écran Connexions, ou réinitialisez le paramètre enregistré.

Paramètres à ajuster

Une fois que les conversations fonctionnent, quelques options améliorent l'expérience et rendent la facture prévisible.

Utilisez la fenêtre de contexte de manière sensée

La fenêtre de contexte est de 100 000 tokens, partagés entre le prompt et la réponse. Open WebUI renvoie l'historique du chat à chaque message, donc une longue conversation devient plus coûteuse à chaque tour. À 0,15 $ par 1 M de tokens d'entrée, un historique de 20 000 tokens coûte 0,003 $ à envoyer, ce qui est peu coûteux, mais cela s'accumule sur des milliers de messages. Lancez un nouveau chat pour un nouveau sujet.

Streaming et échantillonnage

Open WebUI diffuse les réponses en streaming par défaut, et l'API prend en charge le streaming via SSE. Dans les paramètres avancés, vous pouvez définir la température, le top_p, les séquences d'arrêt, une graine pour une sortie reproductible et les pénalités. Ceux-ci sont transmis au modèle. Laissez max_tokens vide sauf si vous voulez un plafond strict, car c'est une option.

Tâches en arrière-plan

Open WebUI peut effectuer des appels de modèle supplémentaires en arrière-plan pour des tâches comme le nommage d'un chat. Chacun est une vraie requête sur votre solde et compte pour les limites. Si vous remarquez des appels que vous n'avez pas tapés, consultez les paramètres du modèle de tâche et pointez-les vers un modèle pour lequel vous acceptez de payer, ou désactivez les utilitaires.

Préréglages et prompts système

Open WebUI vous permet de sauvegarder un préréglage de modèle dans sa section espace de travail : un nom, un modèle de base, un prompt système et des paramètres par défaut. Créez-en un sur la base de uncensored pour chaque tâche que vous effectuez souvent, comme un assistant d'édition, un réviseur de code ou un personnage pour une session de fiction interactive. Un prompt système court qui définit le rôle, le ton et le format des réponses fait plus que de longues instructions collées dans chaque conversation.

C'est ici que le profil du modèle aide. C'est un modèle à poids ouverts optimisé pour répondre sans refus de contenu pour une utilisation adulte légale, ce qui convient à la fiction, au jeu de rôle et aux applications de type compagnon pour adultes, où un refus au milieu d'une scène rompt le flux. Cela ne change pas la limite stricte : aucun contenu sexuel impliquant des mineurs, jamais. Gardez les préréglages et les instances partagées dans cette règle et dans le cadre de la loi de votre pays.

Si d'autres personnes utilisent votre instance Open WebUI, rappelez-vous qu'elles partagent toutes votre clé et ses limites. Une clé complète permet 8 requêtes simultanées, donc une poignée d'utilisateurs actifs est acceptable, tandis qu'un grand groupe discutant en même temps peut atteindre le plafond. Donner à chaque personne ou équipe sa propre clé répartit la charge et rend le solde plus facile à suivre.

Coût d'utilisation

Vous ne payez que les tokens, à partir du crédit prépayé : 0,15 $ par 1 M de tokens d'entrée et 0,50 $ par 1 M de tokens de sortie. Les requêtes échouées ou refusées ne sont pas facturées et le crédit n'expire jamais. Un message de chat typique avec 3 000 tokens d'historique et une réponse de 400 tokens coûte 0,00045 $ + 0,0002 $ = 0,00065 $, donc 10 $ d'utilisation correspondent à environ 15 000 messages.

Les recharges vont de 20 $ à 500 $ en n'importe quel montant entier, avec +5 % à partir de 50 $, +10 % à partir de 100 $ et +15 % à partir de 200 $. Vous pouvez payer par crypto (USDT sur TRC20, USDC sur Base). Voir la page de tarification pour les détails. Le solde restant est retourné dans l'en-tête X-Balance-USD de chaque réponse API, si vous voulez le surveiller depuis un script.

Dépannage

SymptômeCause probableCorrection
La liste des modèles est videURL ou clé incorrecteExécutez le test curl pour /v1/models. L'URL doit se terminer par /v1.
Connexion refusée ou délai d'attente depuis DockerPas de HTTPS sortant du conteneurVérifiez les paramètres DNS, proxy et pare-feu sur l'hôte.
Erreur d'authentification à chaque messageClé collée avec des espaces ou ancienne cléRecopiez la clé depuis la page des clés et enregistrez à nouveau.
Erreurs lors de plusieurs conversations simultanéesLimites de débitUne clé complète permet 8 requêtes simultanées et 300 par minute ; une clé d'essai permet 2 et 60.
Les longues conversations cessent de fonctionnerFenêtre de contexte pleineLa fenêtre fait 100 000 tokens. Commencez une nouvelle conversation ou résumez.

Si le test curl passe mais qu'Open WebUI échoue, le problème vient des paramètres du front-end. Si curl échoue, vérifiez d'abord votre clé et votre solde. Le guide de démarrage rapide liste tous les paramètres de requête, et l'article sur ce qu'est l'API uncensored chat et ce qu'elle n'est pas explique le périmètre du modèle, y compris la limite stricte : pas de contenu sexuel impliquant des mineurs.

Questions et réponses

Quelle URL entrer dans Open WebUI ?

Utilisez https://api.abliteratedapi.com/v1 et rien d'autre. Open WebUI ajoute /chat/completions et /models tout seul.

Quel nom de modèle choisir ?

L'ID du modèle est uncensored. Il apparaît dans le sélecteur de modèles une fois la connexion enregistrée et la liste des modèles chargée.

Ai-je besoin d'une carte pour l'essayer ?

Non. Les nouveaux utilisateurs peuvent obtenir 0,50 $ de crédit d'essai en un clic sur la page de la clé API après l'inscription. Il est valable 7 jours et ne nécessite pas de carte.

Puis-je l'utiliser avec des modèles locaux ?

Oui. Open WebUI prend en charge plusieurs connexions simultanées, donc cet endpoint peut coexister avec des modèles locaux et chacun apparaît dans le même sélecteur de modèles.

Mes conversations sont-elles utilisées pour l'entraînement ?

Non. Les prompts envoyés à l'API ne sont pas utilisés pour l'entraînement. L'historique des conversations stocké par Open WebUI reste dans votre propre installation.

Votre clé n'est qu'à un formulaire d'ici

Créez un compte, copiez la clé, modifiez l'URL de base. C'est toute la configuration.

Obtenir une clé API