URL de base de l'API OpenAI pour Open WebUI : Guide de configuration Flatkey

Le paramètre URL de base de l'API OpenAI pour Open WebUI est le petit champ qui décide si Open WebUI envoie le trafic de chat à un fournisseur en amont, à un serveur de modèle local ou à un routeur tel que Flatkey. Pour un déploiement en équipe, ce champ ne doit pas être traité comme un simple détail à copier-coller. Il doit être vérifié avec la clé API, les ID de modèle, le comportement de découverte de modèle, les complétions de chat, le streaming et les journaux d'utilisation.

Ce guide est destiné aux développeurs, aux équipes de produits d'IA, aux créateurs d'automatisation, aux ingénieurs de plateforme, aux opérateurs financiers et aux évaluateurs d'approvisionnement qui souhaitent qu'Open WebUI utilise Flatkey comme un routeur de modèle compatible OpenAI. Il montre le chemin de connexion actuel d'Open WebUI, l'URL de base de Flatkey à vérifier, quand utiliser les filtres de modèle, comment exécuter une requête préliminaire avec curl, et ce qu'il faut enregistrer avant de déployer la configuration à un plus grand nombre d'utilisateurs.

Note sur la source : ceci a été vérifié le 29 juin 2026 par rapport à la documentation officielle sur la compatibilité OpenAI d'Open WebUI, à la page d'accueil de Flatkey en direct, et à la page de tarification de Flatkey en direct. Aucune clé API Flatkey ou instance Open WebUI en direct n'était disponible dans cet environnement d'exécution, donc les commandes ci-dessous sont des modèles à exécuter avec votre propre clé, alias de modèle et déploiement Open WebUI.

Réponse rapide : URL de base de l'API OpenAI pour Open WebUI pour Flatkey

Pour une route Flatkey, définissez l'URL de base de l'API OpenAI pour Open WebUI sur l'URL de base du fournisseur Flatkey actuelle de votre compte. La page d'accueil publique de Flatkey consultée pour cet article indique de pointer les clients compatibles OpenAI vers https://console.flatkey.ai/v1. Dans Open WebUI, utilisez cette URL de base, collez une clé API Flatkey, ajoutez les ID de modèle Flatkey exacts si la découverte de modèle est bruitée ou échoue, puis enregistrez la connexion.

En bref : configurez l'URL, la clé et le filtre de modèle, puis testez une requête de chat et confirmez que la requête apparaît dans l'utilisation de Flatkey. Le reste de ce guide sur l'URL de base de l'API OpenAI pour Open WebUI transforme cela en une liste de contrôle de configuration et de dépannage reproductible.

Ce que confirment les documents actuels d'Open WebUI

Le guide officiel sur la compatibilité OpenAI d'Open WebUI indique qu'Open WebUI peut se connecter à n'importe quel serveur ou fournisseur qui implémente l'API compatible OpenAI. La documentation encadre l'intégration autour de protocoles standards, en particulier le protocole OpenAI Chat Completions, plutôt qu'un module personnalisé pour chaque fournisseur. Cela fait de Flatkey une tâche de configuration de l'URL de base, de la clé et de la sélection de modèle.

Le même guide donne le chemin d'administration actuel : ouvrez Open WebUI, allez dans Paramètres d'administration, puis Connexions, puis OpenAI, puis cliquez sur Ajouter une connexion. À partir de là, remplissez l'URL du fournisseur et la clé API. Si la découverte automatique de modèle ne fonctionne pas, ajoutez les ID de modèle à ID de modèle (Filtre) et enregistrez.

Un avertissement d'Open WebUI est particulièrement important pour les configurations de routeur. Lorsqu'une connexion est ajoutée, Open WebUI la vérifie via le point de terminaison /models du fournisseur avec un jeton porteur standard. La documentation indique que certains fournisseurs n'implémentent pas /models, utilisent un comportement non standard ou renvoient une liste de modèles peu pratique. Une erreur de liste de modèles ne signifie pas automatiquement que les complétions de chat sont incompatibles. Cela signifie que vous devrez peut-être ajouter manuellement les ID de modèle et tester directement le point de terminaison de chat.

Pour une compatibilité totale, Open WebUI liste /v1/models comme recommandé et /v1/chat/completions comme le point de terminaison de chat principal requis. Il transmet également des paramètres OpenAI courants tels que temperature, top_p, max_tokens ou max_completion_tokens, stop, seed, et logit_bias. L'utilisation d'outils est prise en charge lorsque le modèle et le serveur supportent tools et tool_choice.

Valeurs Flatkey à vérifier avant de modifier Open WebUI

La page d'accueil de Flatkey consultée le 29 juin 2026 a pour titre One API gateway for production AI teams et décrit un accès unifié aux modèles, le routage, la facturation, l'analyse de l'utilisation et les contrôles opérationnels. Elle indique également que les équipes doivent pointer un client compatible OpenAI vers https://console.flatkey.ai/v1 et conserver le modèle de SDK ou de client existant.

La page de tarification de Flatkey, consultée le même jour, indique que le catalogue public compte 633 modèles activés auprès de 23 fournisseurs. Elle expose également des familles de points de terminaison, notamment /v1/chat/completions, /v1/responses, /v1/messages, /v1/images/generations et /v1/video/generations. Pour le chat Open WebUI, commencez avec un modèle disponible via le chemin des complétions de chat et approuvé pour la clé que vous prévoyez d'utiliser.

Ne présumez pas que chaque modèle du catalogue est un bon modèle pour Open WebUI. L'URL de base de l'API OpenAI pour Open WebUI pointe vers un routeur, mais l'expérience utilisateur dépend de l'alias de modèle choisi, de la prise en charge du point de terminaison, de la latence, du comportement du contexte, de la prise en charge des outils et de la bonne apparition du modèle dans le sélecteur de modèles d'Open WebUI.

Étape par étape : ajouter Flatkey comme connexion OpenAI

1. Choisissez la portée d'Open WebUI. Décidez s'il s'agit d'une connexion à l'échelle de l'administration, d'une instance de test ou d'un déploiement auto-hébergé géré via des variables d'environnement.
2. Créez ou sélectionnez une clé Flatkey. Utilisez une clé dédiée pour le test Open WebUI afin que l'utilisation puisse être attribuée et plafonnée.
3. Choisissez un modèle de départ. Copiez l'alias exact du modèle depuis la page de tarification de Flatkey, la console Flatkey ou la liste de modèles visible dans votre compte.
4. Ouvrez l'écran de connexion. Dans Open WebUI, allez dans Paramètres d'administration > Connexions > OpenAI > Ajouter une connexion.
5. Collez l'URL de Flatkey. Utilisez https://console.flatkey.ai/v1 si votre compte le confirme. La valeur doit inclure /v1 mais pas /chat/completions.
6. Collez la clé Flatkey. Utilisez la clé créée pour ce déploiement Open WebUI, et non une clé de fournisseur personnelle ou une clé de fournisseur en amont non liée.
7. Ajoutez les ID de modèle si nécessaire. Si la découverte de modèles échoue, renvoie trop d'options ou expose des modèles non conformes à la politique, ajoutez les alias exacts approuvés dans ID de modèle (Filtre).
8. Enregistrez et gardez l'itinéraire précédent à portée de main. Open WebUI permet d'activer ou de désactiver les connexions, alors conservez un itinéraire de restauration pendant les tests.
9. Exécutez une invite à faible risque. Utilisez une invite simple dans Open WebUI, puis confirmez la requête dans l'historique d'utilisation de Flatkey par horodatage, clé, modèle, nombre de jetons et coût.
10. Documentez le propriétaire. Notez qui possède la clé, qui peut la renouveler, quels modèles sont approuvés et quel quota s'applique avant d'étendre l'accès.

Modèle de variable d'environnement facultatif

Si votre déploiement est géré via des variables d'environnement, utilisez les noms pris en charge par votre version d'Open WebUI et votre méthode de déploiement. Les exemples de fournisseurs d'Open WebUI montrent les modèles OPENAI_API_BASE_URL et OPENAI_API_KEY pour les backends compatibles avec OpenAI, mais le panneau d'administration peut également gérer les connexions. Considérez ceci comme un modèle de déploiement à vérifier par rapport à votre version.

OPENAI_API_BASE_URL=https://console.flatkey.ai/v1
OPENAI_API_KEY=fk_replace_with_flatkey_key

Si vous acheminez également les embeddings, la génération d'images, la parole ou d'autres fonctionnalités de type OpenAI via Open WebUI, ne configurez ces variables d'URL de base et de clé spécifiques à la fonctionnalité qu'après avoir confirmé que Flatkey et le modèle sélectionné prennent en charge cette famille de points de terminaison. Pour le premier déploiement de l'URL de base de l'API OpenAI pour Open WebUI, concentrez le test sur les complétions de chat.

Vérifiez l'itinéraire Flatkey avant de blâmer Open WebUI

Une vérification préalable avec curl permet de distinguer les problèmes de routeur et d'identifiants des problèmes d'interface utilisateur d'Open WebUI. Exécutez cette commande depuis un emplacement réseau comparable à celui du serveur Open WebUI.

export FLATKEY_API_KEY="fk_replace_me"
export FLATKEY_BASE_URL="https://console.flatkey.ai/v1"
export FLATKEY_OPEN_WEBUI_MODEL="replace-with-flatkey-model-alias"

curl "$FLATKEY_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$FLATKEY_OPEN_WEBUI_MODEL"'",
    "messages": [
      {
        "role": "user",
        "content": "Renvoyez le mot ok."
      }
    ],
    "stream": false,
    "max_tokens": 16
  }'

Si cette requête échoue, corrigez la clé Flatkey, l'URL, l'alias du modèle, l'autorisation du compte ou l'itinéraire réseau avant de modifier à nouveau Open WebUI. Si elle réussit, répétez l'opération via Open WebUI et comparez le journal d'utilisation de Flatkey.

Pour une expérience de chat en streaming, testez le streaming séparément. Une réponse sans streaming prouve que l'itinéraire peut répondre. Cela ne prouve pas que votre proxy inverse, votre déploiement Open WebUI et le navigateur client gèrent le streaming sans mise en mémoire tampon ni délais d'attente.

curl "$FLATKEY_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$FLATKEY_OPEN_WEBUI_MODEL"'",
    "messages": [
      {
        "role": "user",
        "content": "Diffusez trois points de liste courts."
      }
    ],
    "stream": true,
    "max_tokens": 96
  }'

Liste de contrôle pour la découverte et le filtrage des modèles

La configuration la plus sûre de l'URL de base de l'API OpenAI pour Open WebUI utilise intentionnellement des filtres de modèles. Un routeur peut exposer de nombreux modèles, et une liste de modèles étendue n'est pas toujours ce que les administrateurs souhaitent que les utilisateurs voient.

Modes d'échec à déboguer en premier

Runbook de production pour Open WebUI et Flatkey

Avant d'effectuer la modification de l'URL de base de l'API OpenAI pour Open WebUI pour un groupe plus large, notez les faits opérationnels qui soutiennent la propriété, le retour en arrière et l'examen des coûts.

Place dans l'écosystème d'intégration d'outils Flatkey

Open WebUI n'est qu'une des interfaces pouvant utiliser une route compatible OpenAI. Si votre équipe standardise plusieurs outils, utilisez le même modèle pour l'ensemble de l'écosystème : une URL de base actuelle, une clé appartenant au compte par interface, des alias de modèle exacts, un petit test de fumée, une preuve d'utilisation et des notes de retour en arrière.

Pour des configurations connexes, consultez le guide de configuration de l'API Cherry Studio pour la discipline de l'URL de base du client de bureau, le guide CC Switch Claude Code Flatkey pour le routage des outils de développement, et le playbook plus large de migration d'API compatible OpenAI pour les changements d'URL de base, la vérification des alias de modèle et le retour en arrière. Utilisez la tarification Flatkey pour examiner la couverture actuelle des modèles et des points de terminaison, puis obtenez une clé pour l'espace de travail qui possède le premier déploiement d'Open WebUI.

FAQ

Que dois-je mettre dans le champ URL de base de l'API OpenAI pour Open WebUI ?

Utilisez l'URL de base actuelle du fournisseur Flatkey depuis votre compte. La page d'accueil publique de Flatkey, vérifiée le 29 juin 2026, dirige les clients compatibles OpenAI vers https://console.flatkey.ai/v1. N'incluez pas le chemin complet /chat/completions dans le champ de l'URL de base.

Pourquoi Open WebUI affiche-t-il une erreur de découverte de modèle ?

Open WebUI vérifie une nouvelle connexion compatible OpenAI en appelant /models. La documentation officielle avertit que certains fournisseurs n'implémentent pas ce point de terminaison, utilisent un comportement non standard ou renvoient des listes de modèles très volumineuses. Si les complétions de chat fonctionnent, ajoutez les ID de modèle exacts au filtre et testez à nouveau.

Puis-je exposer chaque modèle Flatkey à Open WebUI ?

Techniquement, un routeur peut exposer de nombreux modèles, mais les administrateurs de production devraient commencer par une liste d'autorisation restreinte. Choisissez des modèles qui correspondent aux besoins de chat d'Open WebUI, à la prise en charge des points de terminaison, aux attentes en matière de latence, à la politique d'utilisation et aux contrôles budgétaires.

Est-ce que Flatkey remplace les paramètres d'Open WebUI ?

Non. Flatkey fournit la route compatible OpenAI, la clé, l'accès aux modèles, la visibilité de l'utilisation et les contrôles de facturation. Open WebUI contrôle toujours ses propres paramètres de connexion, son sélecteur de modèle, l'accès des utilisateurs, le comportement des invites et la mise en réseau au niveau du déploiement.

Comment savoir si la configuration fonctionne ?

Exécutez une pré-vérification curl vers /chat/completions, enregistrez la connexion Open WebUI, envoyez une invite sûre et confirmez que la requête apparaît dans l'utilisation de Flatkey avec la clé, le modèle, l'horodatage, les jetons, le statut et le coût attendus.

Liste de contrôle finale

• URL de base de Flatkey confirmée à partir de la source du compte actuel.
• Clé Flatkey dédiée créée pour le déploiement d'Open WebUI.
• Un alias de modèle de chat approuvé sélectionné en premier.
• URL de base de l'API OpenAI pour Open WebUI définie sur l'URL de base du fournisseur, et non sur le point de terminaison complet.
• ID de modèle ajoutés manuellement lorsque la découverte échoue ou renvoie trop d'options.
• Chat en streaming et non-streaming testé.
• Ligne d'utilisation de Flatkey confirmée après la première invite d'Open WebUI.
• Propriétaire, quota, liste d'autorisation de modèles et chemin de restauration enregistrés.

Une fois ces vérifications réussies, l'URL de base de l'API OpenAI pour Open WebUI devient plus qu'un simple champ de connexion. Elle devient une route Flatkey contrôlée avec une clé unique, des modèles approuvés, une visibilité de l'utilisation et un plan de restauration clair.