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écute | FreeLLMAPI s'exécute | URL à 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ôte | http://host.docker.internal:3001/v1 |
| Dans Docker sous Linux | Dans Docker (script d'installation) | http://freellmapi:3001/v1 sur un réseau Docker partagé |
| Sur un autre ordinateur | Sur un serveur de votre réseau local | http://<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.
- Ouvrez le Admin Panel et allez dans Settings > Connections.
- Repérez la liste Manage OpenAI API Connections. Cliquez sur Add Connection.
- Dans URL, saisissez l'URL de l'étape 1, par exemple
http://host.docker.internal:3001/v1. - Dans API Key, collez votre clé unifiée FreeLLMAPI.
- 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:mainPour 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>"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èle | Ce que fait le routeur |
|---|---|
auto | Suit votre chaîne de secours active depuis le tableau de bord |
auto:fast | Classe les modèles activés selon leur vitesse mesurée |
auto:smart | Classe les modèles activés par intelligence |
auto:reliable | Classe 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èle | Gratuit sur | Contexte | Limites gratuites (meilleure offre) | Outils | Vision |
|---|---|---|---|---|---|
| GLM 5.3 | APINex, UnoRouter | 1M | 5 req/min 10M weighted tokens/day shared across APINex free routes; 4x token multiplier; 5 requests/minute/account | Oui | Non |
| GLM 5.3 Flash | APINex, BlazeAPI, NVIDIA NIM +1 de plus | 1M | 40 req/min 40 RPM | Oui | Oui |
| Gemini 3.8 Flash | APINex, Google AI Studio | 1M | 5 req/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Oui | Oui |
| Qwen3.8 Flash Next | AMD Radeon Cloud, BlazeAPI, ElectronHub | 262K | Recurring daily account allowance | Oui | Non |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Oui | Oui |
| Deepseek V4.1 Flash | APINex | 1M | 5 req/min 10M weighted tokens/day shared across APINex free routes; 3x token multiplier; 5 requests/minute/account | Non | Non |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Oui | Oui |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 req/min 50 req/jour 50 req/day account-wide (1,000 after a $10 purchase) | Oui | Oui |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 req/min 50 req/jour Shared rate limit | Oui | Non |
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èle | Gratuit sur | Contexte | Limites gratuites (meilleure offre) | Outils | Vision |
|---|---|---|---|---|---|
| GLM 5.3 Flash | UnoRouter | 1M | 1 req/min 1 req/min per model | Oui | Oui |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Oui | Oui |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Oui | Oui |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Oui | Oui |
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-m3Choisissez 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èle | Fournisseur | Dimensions | Entrée max | Limite gratuite |
|---|---|---|---|---|
Gemini Embeddinggemini-embedding-001 | Google AI Studio | 3072 | 2048 | 100 rpm · 1K req/day |
Nemotron Embed VL 1Bnvidia/llama-nemotron-embed-vl-1b-v2 | NVIDIA NIM | 2048 | 8192 | ~40 rpm |
Nemotron 3 Embed 1B (OR free)nvidia/nemotron-3-embed-1b:free | OpenRouter | 2048 | 32768 | 20 rpm · shared free daily cap |
SEA-LION E5 Embedding 600Maisingapore/SEA-LION-E5-Embedding-600M | SEA-LION | 1024 | 8192 | free · 10 rpm |
SEA-LION ModernBERT Embedding 300Maisingapore/SEA-LION-ModernBERT-Embedding-300M | SEA-LION | 1024 | 8192 | free · 10 rpm |
SEA-LION ModernBERT Embedding 600Maisingapore/SEA-LION-ModernBERT-Embedding-600M | SEA-LION | 1024 | 8192 | free · 10 rpm |
BGE-M3@cf/baai/bge-m3 | Cloudflare Workers AI | 1024 | 8192 | 10K neurons/day (shared) |
EmbeddingGemma 300M@cf/google/embeddinggemma-300m | Cloudflare Workers AI | 768 | 2048 | 10K neurons/day (shared) |
Qwen3 Embedding 0.6B@cf/qwen/qwen3-embedding-0.6b | Cloudflare Workers AI | 1024 | 8192 | 10K neurons/day (shared) |
Cohere Embed v4embed-v4.0 | Cohere | 1536 | 128000 | 1K calls/mo (shared w/ chat) |
Gemini Embedding 2gemini-embedding-2 | Google AI Studio | 3072 | 8192 | free-tier rate limited |
Nemotron 3 Embed 1Bnvidia/nemotron-3-embed-1b | NVIDIA NIM | 2048 | 4096 | ~40 rpm |
PLaMo Embedding 1B (CF)@cf/pfnet/plamo-embedding-1b | Cloudflare Workers AI | 2048 | 4096 | 10K neurons/day (shared) |
BGE Small EN v1.5 (CF)@cf/baai/bge-small-en-v1.5 | Cloudflare Workers AI | 384 | 512 | 10K neurons/day (shared) |
BGE Base EN v1.5 (CF)@cf/baai/bge-base-en-v1.5 | Cloudflare Workers AI | 768 | 512 | 10K neurons/day (shared) |
BGE Large EN v1.5 (CF)@cf/baai/bge-large-en-v1.5 | Cloudflare Workers AI | 1024 | 512 | 10K neurons/day (shared) |
Mistral Embedmistral-embed | Mistral | 1024 | 8192 | free mode · monthly cap (shared) |
Codestral Embedcodestral-embed | Mistral | 1536 | 8192 | free mode · monthly cap (shared) |
Llama Text Embed v2 (Pinecone)llama-text-embed-v2 | Pinecone | 1024 | 2048 | 5M tokens/mo per model |
Multilingual E5 Large (Pinecone)multilingual-e5-large | Pinecone | 1024 | 507 | 5M tokens/mo per model |
Nemotron 3 Embed 1B (Speka)nvidia/nemotron-3-embed-1b | Speka | 2048 | 8192 | $1/month shared across Speka models |
OpenAI: Text Embedding 3 Small (ElectronHub)text-embedding-3-small | ElectronHub | 1536 | 8192 | $0.25/week shared free credits |
OpenAI: Text Embedding 3 Large (ElectronHub)text-embedding-3-large | ElectronHub | 3072 | 8192 | $0.25/week shared free credits |
Nemotron 3 Embed 8B (Inferbase)nvidia-nemotron-3-embed-8b | Inferbase | 4096 | 8192 | 5,000 requests/month; 100 requests and $0.50 usage/day shared |
Qwen 3 Embedding 0.6B (Inferbase)qwen3-embedding-0-6b | Inferbase | 1024 | 8192 | 5,000 requests/month; 100 requests and $0.50 usage/day shared |
Qwen 3 Embedding 4B (Inferbase)qwen3-embedding-4b | Inferbase | 2560 | 8192 | 5,000 requests/month; 100 requests and $0.50 usage/day shared |
Qwen 3 Embedding 8B (Inferbase)qwen3-embedding-8b | Inferbase | 4096 | 8192 | 5,000 requests/month; 100 requests and $0.50 usage/day shared |
LFM2.5 Embedding 350M (LLMTR)liquid/lfm-2.5-embedding-350m-free | LLMTR | 1024 | 512 | Ongoing zero-price route; provider terms apply |
BGE-M3 (SEA-LION)BAAI/bge-m3 | SEA-LION | 1024 | 8192 | free · 10 rpm |
Cohere Embed English v3embed-english-v3.0 | Cohere | 1024 | 512 | 1K calls/mo (shared w/ chat) |
Qwen3 Embedding 8B (OVH)Qwen3-Embedding-8B | OVH AI Endpoints | 4096 | 32768 | free · anonymous 2 req/min per IP |
BGE-M3 (OVH)bge-m3 | OVH AI Endpoints | 1024 | 8192 | free · anonymous 2 req/min per IP |
BGE Multilingual Gemma2 (OVH)bge-multilingual-gemma2 | OVH AI Endpoints | 3584 | 8192 | free · anonymous 2 req/min per IP |
Mistral: Codestral Embed (ElectronHub)codestral-embed | ElectronHub | 1536 | 8192 | $0.25/week shared free credits |
Mistral: Mistral Embed (ElectronHub)mistral-embed | ElectronHub | 1024 | 8192 | $0.25/week shared free credits |
Google: Gemini Embedding 2 (ElectronHub)gemini-embedding-2 | ElectronHub | 3072 | 8192 | $0.25/week shared free credits |
Google: Gemini Embedding 001 (ElectronHub)gemini-embedding-001 | ElectronHub | 3072 | 2048 | $0.25/week shared free credits |
OpenAI: Text Embedding Ada 002 (ElectronHub)text-embedding-ada-002 | ElectronHub | 1536 | 8192 | $0.25/week shared free credits |
Cohere Embed English Light v3embed-english-light-v3.0 | Cohere | 384 | 512 | 1K calls/mo (shared w/ chat) |
Cohere Embed Multilingual v3embed-multilingual-v3.0 | Cohere | 1024 | 512 | 1K calls/mo (shared w/ chat) |
Cohere Embed Multilingual Light v3embed-multilingual-light-v3.0 | Cohere | 384 | 512 | 1K 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ème | Cause | Solution |
|---|---|---|
| Verify Connection échoue avec une erreur réseau | localhost désigne le conteneur Open WebUI | Utilisez host.docker.internal ou un réseau Docker partagé, comme à l'étape 1 |
| Verify Connection échoue avec l'erreur 401 | La clé est fausse ou contient des espaces | Copiez de nouveau la clé unifiée depuis la page Keys |
| Des centaines de modèles dans le sélecteur | La connexion lit le catalogue complet | Ajoutez auto et vos identifiants choisis dans Model IDs |
| Un modèle échoue à chaque message | Aucune clé pour le fournisseur de ce modèle | Ajoutez la clé du fournisseur, ou sélectionnez auto |
| Erreur 429 après de nombreux chats | Toutes les clés de fournisseurs de la chaîne ont atteint leur limite | Ajoutez 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 effet | Les valeurs enregistrées dans la base de données prévalent | Modifiez 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.
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
- API gratuite pour SillyTavern
- URL de base des API gratuites compatibles OpenAI
- API d'embeddings gratuite
- API LLM gratuite pour RAG
- Limites de débit des API LLM gratuites
Sources
- Open WebUI docs: environment variable configuration (vérifié le 20 November 2026)
- Open WebUI docs: connect an OpenAI-compatible provider (vérifié le 20 November 2026)
- Open WebUI README: Docker installation (vérifié le 20 November 2026)
- FreeLLMAPI docs: REST API (routing strategies, model listing, embeddings) (vérifié le 20 November 2026)
- FreeLLMAPI docs: Docker deployment (vérifié le 20 November 2026)