Accueil / Guides / API LLM gratuite pour Open WebUI

API LLM gratuite pour Open WebUI

Open WebUI est une interface de chat auto-hébergée. Elle se connecte à tout serveur qui utilise l'API OpenAI Chat Completions. Ce guide connecte Open WebUI à FreeLLMAPI, qui regroupe 45 offres gratuites de fournisseurs derrière une seule clé. Vous ajoutez une seule connexion. Le routeur envoie chaque chat vers un modèle gratuit et passe au fournisseur suivant lorsqu'une limite bloque une requête.

Le code, les noms de modèles et les libellés du catalogue en direct sont affichés en anglais.

Fonctionnement de la connexion

Open WebUI envoie les requêtes de chat à l'URL de chaque connexion OpenAI. FreeLLMAPI écoute sur http://localhost:3001/v1 et accepte les mêmes requêtes. Il sélectionne un modèle gratuit, envoie la requête et renvoie la réponse au format OpenAI.

  • Une connexion, plusieurs fournisseurs : vous ajoutez une URL et une clé unifiée. Vos clés de fournisseurs restent dans FreeLLMAPI, sur votre ordinateur.
  • Basculement : lorsqu'un fournisseur renvoie une erreur 429, le routeur essaie le modèle suivant de votre chaîne de secours.
  • Limites : les offres gratuites ont des limites de requêtes et de jetons. Plus de clés de fournisseurs donnent plus de requêtes par jour. Le basculement répartit la charge, mais il ne supprime pas les limites.

Installez d'abord FreeLLMAPI. Il fonctionne avec Docker. Ouvrez le tableau de bord à l'adresse http://localhost:3001, ajoutez au moins deux clés de fournisseurs gratuits sur la page Keys et copiez votre clé unifiée.

Installer FreeLLMAPI (macOS ou Linux)

curl -fsSL https://freellmapi.co/install.sh | bash

Étape 1 : trouver la bonne URL

L'URL à utiliser dans Open WebUI dépend de l'endroit où chaque programme s'exécute. Open WebUI fonctionne en général dans Docker. Dans un conteneur, localhost désigne le conteneur lui-même, et non votre ordinateur.

Open WebUI s'exécuteFreeLLMAPI s'exécuteURL à utiliser
Sur l'hôte (pip ou uv)Sur l'hôte (Docker ou application de bureau)http://localhost:3001/v1
Dans Docker Desktop (macOS, Windows)Sur l'hôtehttp://host.docker.internal:3001/v1
Dans Docker sous LinuxDans Docker (script d'installation)http://freellmapi:3001/v1 sur un réseau Docker partagé
Sur un autre ordinateurSur un serveur de votre réseau localhttp://<server-ip>:3001/v1, avec HOST_BIND=0.0.0.0 uniquement sur un réseau de confiance

Par défaut, le conteneur FreeLLMAPI publie son port sur 127.0.0.1 uniquement. Sous Linux, un second conteneur ne peut pas toujours atteindre ce port via l'hôte. Connectez les deux conteneurs à un même réseau Docker. Utilisez ensuite le nom de service freellmapi comme nom d'hôte.

Connecter Open WebUI au réseau FreeLLMAPI (Linux)

# Find the network of the FreeLLMAPI stack (usually freellmapi_default)
docker network ls

# Attach the Open WebUI container to it
docker network connect freellmapi_default open-webui

# Test the URL from inside the Open WebUI container
docker exec open-webui curl -s http://freellmapi:3001/v1/models \
  -H "Authorization: Bearer <unified-key>" | head -c 300

Étape 2 : ajouter la connexion

Vous pouvez ajouter la connexion dans l'interface ou avec des variables d'environnement. L'interface est la méthode la plus simple.

  1. Ouvrez le Admin Panel et allez dans Settings > Connections.
  2. Repérez la liste Manage OpenAI API Connections. Cliquez sur Add Connection.
  3. Dans URL, saisissez l'URL de l'étape 1, par exemple http://host.docker.internal:3001/v1.
  4. Dans API Key, collez votre clé unifiée FreeLLMAPI.
  5. Cliquez sur Verify Connection. Cliquez ensuite sur Save.

Pour définir la connexion au démarrage du conteneur, utilisez OPENAI_API_BASE_URL et OPENAI_API_KEY. La commande ci-dessous est la commande docker run standard d'Open WebUI, avec ces deux variables ajoutées.

docker run avec la connexion FreeLLMAPI

docker run -d -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -e OPENAI_API_BASE_URL=http://host.docker.internal:3001/v1 \
  -e OPENAI_API_KEY=<unified-key> \
  -v open-webui:/app/backend/data \
  --name open-webui --restart always \
  ghcr.io/open-webui/open-webui:main

Pour conserver une connexion OpenAI existante, utilisez les variables au pluriel. OPENAI_API_BASE_URLS et OPENAI_API_KEYS acceptent des listes séparées par des points-virgules. La première clé correspond à la première URL.

Deux connexions dans un même conteneur

-e OPENAI_API_BASE_URLS="https://api.openai.com/v1;http://host.docker.internal:3001/v1" \
-e OPENAI_API_KEYS="<openai-key>;<unified-key>"
Important : ces variables sont enregistrées dans la base de données d'Open WebUI au premier démarrage. Ensuite, les valeurs enregistrées dans l'Admin Panel prévalent sur l'environnement. Si une modification des variables n'a aucun effet, modifiez la connexion dans l'Admin Panel. Vous pouvez aussi définir ENABLE_PERSISTENT_CONFIG=False pour que l'environnement prévale.

Étape 3 : limiter la liste des modèles

FreeLLMAPI renvoie son catalogue complet sur /v1/models. Ce catalogue contient aussi des modèles que vous ne pouvez pas encore appeler, car vous n'avez pas ajouté de clé pour eux. Open WebUI affiche chaque modèle renvoyé par la connexion. Une longue liste de modèles qui échouent n'est pas utile.

Ouvrez de nouveau la connexion et utilisez le champ Model IDs. Lorsque vous ajoutez des identifiants, Open WebUI n'affiche que ces identifiants et cesse de lire la liste complète. Ajoutez d'abord les entrées du routeur :

Identifiant du modèleCe que fait le routeur
autoSuit votre chaîne de secours active depuis le tableau de bord
auto:fastClasse les modèles activés selon leur vitesse mesurée
auto:smartClasse les modèles activés par intelligence
auto:reliableClasse les modèles activés selon leur taux de réussite récent
auto:<profile>Utilise une chaîne de secours nommée, par exemple une chaîne de vision

Vous pouvez aussi ajouter un identifiant de modèle fixe, par exemple un modèle du tableau ci-dessous. Un modèle fixe donne un style de réponse identique à chaque fois. Il s'arrête aussi lorsque la limite gratuite de ce modèle est atteinte, sauf si le même modèle est gratuit chez d'autres fournisseurs.

Pour économiser votre quota, définissez le modèle de tâche sur une entrée rapide. Open WebUI utilise le modèle de tâche pour les titres et les requêtes de recherche. La variable est TASK_MODEL_EXTERNAL, par exemple TASK_MODEL_EXTERNAL=auto:fast.

Modèles de chat gratuits performants avec 128K+ de contexte
ModèleGratuit surContexteLimites gratuites (meilleure offre)OutilsVision
GLM 5.3APINex, UnoRouter1M5 req/min
10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account
OuiNon
GLM 5.3 FlashAPINex, BlazeAPI, NVIDIA NIM +1 de plus1M40 req/min
40 RPM
OuiOui
Gemini 3.8 FlashAPINex, Google AI Studio1M5 req/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
OuiOui
Qwen3.8 Flash NextAMD Radeon Cloud, BlazeAPI, ElectronHub262KRecurring daily account allowanceOuiNon
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditOuiOui
Deepseek V4.1 FlashAPINex1M5 req/min
10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account
NonNon
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditOuiOui
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 req/min
50 req/jour
50 req/day account-wide (1,000 after a $10 purchase)
OuiOui
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 req/min
50 req/jour
Shared rate limit
OuiNon

Affichage de 10 modèles gratuits sur 184 correspondants. Voir tous les modèles.

Données en direct du catalogue FreeLLMAPI (version 2026.11.19, vérifié le 2026-11-19). Les limites gratuites changent souvent. Le catalogue est vérifié chaque jour.

Si vous envoyez des images dans Open WebUI, le routeur n'utilise que des modèles de vision pour cette requête. Si aucun modèle de vision ne figure dans votre chaîne, la requête renvoie l'erreur 422. Ces modèles gratuits acceptent les images :

Modèles gratuits avec entrée d'images
ModèleGratuit surContexteLimites gratuites (meilleure offre)OutilsVision
GLM 5.3 FlashUnoRouter1M1 req/min
1 req/min per model
OuiOui
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaOuiOui
Gemini Flash (latest alias)Google AI Studio-10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditOuiOui
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditOuiOui

Affichage de 6 modèles gratuits sur 67 correspondants. Voir tous les modèles.

Données en direct du catalogue FreeLLMAPI (version 2026.11.19, vérifié le 2026-11-19). Les limites gratuites changent souvent. Le catalogue est vérifié chaque jour.

Utiliser des embeddings gratuits pour vos documents

Open WebUI peut créer des embeddings pour vos documents via une API compatible OpenAI. FreeLLMAPI sert /v1/embeddings. Le basculement des embeddings ne change jamais de modèle, donc les vecteurs de votre stockage restent compatibles.

Paramètres d'embeddings pour Open WebUI

-e RAG_EMBEDDING_ENGINE=openai \
-e RAG_OPENAI_API_BASE_URL=http://host.docker.internal:3001/v1 \
-e RAG_OPENAI_API_KEY=<unified-key> \
-e RAG_EMBEDDING_MODEL=bge-m3

Choisissez une famille d'embeddings et conservez-la. Si vous changez de famille, recréez les embeddings de tous les documents. Les modèles d'embeddings gratuits du catalogue actuel sont :

ModèleFournisseurDimensionsEntrée maxLimite gratuite
Gemini Embedding
gemini-embedding-001
Google AI Studio30722048100 rpm · 1K req/day
Nemotron Embed VL 1B
nvidia/llama-nemotron-embed-vl-1b-v2
NVIDIA NIM20488192~40 rpm
Nemotron 3 Embed 1B (OR free)
nvidia/nemotron-3-embed-1b:free
OpenRouter20483276820 rpm · shared free daily cap
SEA-LION E5 Embedding 600M
aisingapore/SEA-LION-E5-Embedding-600M
SEA-LION10248192free · 10 rpm
SEA-LION ModernBERT Embedding 300M
aisingapore/SEA-LION-ModernBERT-Embedding-300M
SEA-LION10248192free · 10 rpm
SEA-LION ModernBERT Embedding 600M
aisingapore/SEA-LION-ModernBERT-Embedding-600M
SEA-LION10248192free · 10 rpm
BGE-M3
@cf/baai/bge-m3
Cloudflare Workers AI1024819210K neurons/day (shared)
EmbeddingGemma 300M
@cf/google/embeddinggemma-300m
Cloudflare Workers AI768204810K neurons/day (shared)
Qwen3 Embedding 0.6B
@cf/qwen/qwen3-embedding-0.6b
Cloudflare Workers AI1024819210K neurons/day (shared)
Cohere Embed v4
embed-v4.0
Cohere15361280001K calls/mo (shared w/ chat)
Gemini Embedding 2
gemini-embedding-2
Google AI Studio30728192free-tier rate limited
Nemotron 3 Embed 1B
nvidia/nemotron-3-embed-1b
NVIDIA NIM20484096~40 rpm
PLaMo Embedding 1B (CF)
@cf/pfnet/plamo-embedding-1b
Cloudflare Workers AI2048409610K neurons/day (shared)
BGE Small EN v1.5 (CF)
@cf/baai/bge-small-en-v1.5
Cloudflare Workers AI38451210K neurons/day (shared)
BGE Base EN v1.5 (CF)
@cf/baai/bge-base-en-v1.5
Cloudflare Workers AI76851210K neurons/day (shared)
BGE Large EN v1.5 (CF)
@cf/baai/bge-large-en-v1.5
Cloudflare Workers AI102451210K neurons/day (shared)
Mistral Embed
mistral-embed
Mistral10248192free mode · monthly cap (shared)
Codestral Embed
codestral-embed
Mistral15368192free mode · monthly cap (shared)
Llama Text Embed v2 (Pinecone)
llama-text-embed-v2
Pinecone102420485M tokens/mo per model
Multilingual E5 Large (Pinecone)
multilingual-e5-large
Pinecone10245075M tokens/mo per model
Nemotron 3 Embed 1B (Speka)
nvidia/nemotron-3-embed-1b
Speka20488192$1/month shared across Speka models
OpenAI: Text Embedding 3 Small (ElectronHub)
text-embedding-3-small
ElectronHub15368192$0.25/week shared free credits
OpenAI: Text Embedding 3 Large (ElectronHub)
text-embedding-3-large
ElectronHub30728192$0.25/week shared free credits
Nemotron 3 Embed 8B (Inferbase)
nvidia-nemotron-3-embed-8b
Inferbase409681925,000 requests/month; 100 requests and $0.50 usage/day shared
Qwen 3 Embedding 0.6B (Inferbase)
qwen3-embedding-0-6b
Inferbase102481925,000 requests/month; 100 requests and $0.50 usage/day shared
Qwen 3 Embedding 4B (Inferbase)
qwen3-embedding-4b
Inferbase256081925,000 requests/month; 100 requests and $0.50 usage/day shared
Qwen 3 Embedding 8B (Inferbase)
qwen3-embedding-8b
Inferbase409681925,000 requests/month; 100 requests and $0.50 usage/day shared
LFM2.5 Embedding 350M (LLMTR)
liquid/lfm-2.5-embedding-350m-free
LLMTR1024512Ongoing zero-price route; provider terms apply
BGE-M3 (SEA-LION)
BAAI/bge-m3
SEA-LION10248192free · 10 rpm
Cohere Embed English v3
embed-english-v3.0
Cohere10245121K calls/mo (shared w/ chat)
Qwen3 Embedding 8B (OVH)
Qwen3-Embedding-8B
OVH AI Endpoints409632768free · anonymous 2 req/min per IP
BGE-M3 (OVH)
bge-m3
OVH AI Endpoints10248192free · anonymous 2 req/min per IP
BGE Multilingual Gemma2 (OVH)
bge-multilingual-gemma2
OVH AI Endpoints35848192free · anonymous 2 req/min per IP
Mistral: Codestral Embed (ElectronHub)
codestral-embed
ElectronHub15368192$0.25/week shared free credits
Mistral: Mistral Embed (ElectronHub)
mistral-embed
ElectronHub10248192$0.25/week shared free credits
Google: Gemini Embedding 2 (ElectronHub)
gemini-embedding-2
ElectronHub30728192$0.25/week shared free credits
Google: Gemini Embedding 001 (ElectronHub)
gemini-embedding-001
ElectronHub30722048$0.25/week shared free credits
OpenAI: Text Embedding Ada 002 (ElectronHub)
text-embedding-ada-002
ElectronHub15368192$0.25/week shared free credits
Cohere Embed English Light v3
embed-english-light-v3.0
Cohere3845121K calls/mo (shared w/ chat)
Cohere Embed Multilingual v3
embed-multilingual-v3.0
Cohere10245121K calls/mo (shared w/ chat)
Cohere Embed Multilingual Light v3
embed-multilingual-light-v3.0
Cohere3845121K calls/mo (shared w/ chat)

Données en direct du catalogue FreeLLMAPI (version 2026.11.19, vérifié le 2026-11-19). Les limites gratuites changent souvent. Le catalogue est vérifié chaque jour.

Dépannage

ProblèmeCauseSolution
Verify Connection échoue avec une erreur réseaulocalhost désigne le conteneur Open WebUIUtilisez host.docker.internal ou un réseau Docker partagé, comme à l'étape 1
Verify Connection échoue avec l'erreur 401La clé est fausse ou contient des espacesCopiez de nouveau la clé unifiée depuis la page Keys
Des centaines de modèles dans le sélecteurLa connexion lit le catalogue completAjoutez auto et vos identifiants choisis dans Model IDs
Un modèle échoue à chaque messageAucune clé pour le fournisseur de ce modèleAjoutez la clé du fournisseur, ou sélectionnez auto
Erreur 429 après de nombreux chatsToutes les clés de fournisseurs de la chaîne ont atteint leur limiteAjoutez des clés d'autres fournisseurs, ou attendez l'heure de réinitialisation indiquée dans l'en-tête Retry-After
Les variables d'environnement n'ont aucun effetLes valeurs enregistrées dans la base de données prévalentModifiez la connexion dans l'Admin Panel

Pour savoir quel fournisseur a répondu à un chat, lisez l'en-tête X-Routed-Via de la réponse. La visionneuse Server Logs du menu Analytics du tableau de bord affiche aussi les décisions de routage et les temps d'attente des clés.

Utilisez chacun de ces modèles avec une seule clé. FreeLLMAPI est un routeur open source auto-hébergé. Il place toutes ces offres gratuites derrière un seul point de terminaison compatible OpenAI, et bascule vers une autre offre lorsqu'une limite de débit est atteinte. Parcourir le catalogue ou passer en production.

Questions fréquentes

Existe-t-il une API gratuite pour Open WebUI ?

Oui. Open WebUI fonctionne avec toute API compatible OpenAI. FreeLLMAPI regroupe des offres gratuites de fournisseurs derrière une seule URL et une seule clé. Chaque offre gratuite a ses propres limites.

Quelle URL utiliser pour une connexion compatible OpenAI dans Open WebUI ?

Utilisez l'URL de base avec /v1 à la fin, par exemple http://host.docker.internal:3001/v1. N'ajoutez pas /chat/completions. Si Open WebUI fonctionne dans Docker, n'utilisez pas localhost.

Pourquoi Open WebUI ignore-t-il ma modification de OPENAI_API_BASE_URL ?

Open WebUI enregistre les paramètres de connexion dans sa base de données après le premier démarrage. Les valeurs de la base de données prévalent. Modifiez la connexion dans l'Admin Panel, ou définissez ENABLE_PERSISTENT_CONFIG=False.

Open WebUI peut-il utiliser plusieurs fournisseurs gratuits à la fois ?

Oui. Vous pouvez ajouter une connexion par fournisseur. Avec FreeLLMAPI, une seule connexion suffit, car le routeur choisit le fournisseur et passe au suivant lorsqu'une limite bloque une requête.

Quel est le meilleur modèle gratuit dans Open WebUI ?

Commencez avec auto. Il suit votre chaîne de secours. Pour un modèle fixe, choisissez-en un avec une grande fenêtre de contexte dans le tableau de cette page.

Guides associés

Sources

Tous les guides · Parcourir tous les modèles gratuits