Utiliser des modèles IA gratuits dans Zed
Zed est un éditeur de code open source doté d'un panneau d'agent. Il peut utiliser un fournisseur compatible OpenAI ou un serveur Ollama. Ce guide connecte Zed à des modèles gratuits via FreeLLMAPI, avec l'une ou l'autre méthode. Une courte section à la fin couvre JetBrains AI Assistant.
Le code, les noms de modèles et les libellés du catalogue en direct sont affichés en anglais.
Deux façons de connecter Zed
| Méthode | Paramètre Zed | Point de terminaison FreeLLMAPI | Clé |
|---|---|---|---|
| Fournisseur compatible OpenAI (recommandé) | language_models.openai_compatible | http://localhost:3001/v1 | Clé unifiée, dans l'interface des paramètres de Zed ou dans une variable d'environnement |
| Fournisseur Ollama | language_models.ollama | http://localhost:3001 (émulation Ollama) | Aucune en boucle locale, ou la clé unifiée |
Les deux méthodes utilisent le même routeur et le même ensemble de modèles gratuits. La méthode compatible OpenAI ne demande aucune modification côté FreeLLMAPI. La méthode Ollama nécessite l'émulation Ollama, désactivée par défaut.
Installez d'abord FreeLLMAPI. Ouvrez http://localhost:3001, ajoutez au moins deux clés de fournisseurs gratuits sur la page Keys et copiez votre clé unifiée.
Installer sur macOS ou Linux
curl -fsSL https://freellmapi.co/install.sh | bashMéthode 1 : fournisseur compatible OpenAI
Ouvrez votre settings.json de Zed et ajoutez ce bloc. L'identifiant du fournisseur est freellmapi. max_tokens correspond à la fenêtre de contexte du modèle.
settings.json de Zed
{
"language_models": {
"openai_compatible": {
"freellmapi": {
"api_url": "http://localhost:3001/v1",
"available_models": [
{
"name": "auto",
"display_name": "FreeLLMAPI Auto",
"max_tokens": 128000,
"max_output_tokens": 8192,
"capabilities": {
"tools": true,
"images": false,
"parallel_tool_calls": false,
"prompt_cache_key": false,
"chat_completions": true
}
}
]
}
}
}
}Ne placez pas la clé dans settings.json. Utilisez l'une de ces deux méthodes :
- Lancez
agent: open settingsdepuis la palette de commandes. Allez dans les fournisseurs de LLM, trouvez le fournisseur et saisissez la clé. Zed la conserve dans le trousseau du système. - Définissez une variable d'environnement. Zed forme le nom à partir de l'identifiant du fournisseur, en majuscules et avec des tirets bas, suivi de
_API_KEY. Pour l'identifiantfreellmapi, le nom estFREELLMAPI_API_KEY. La variable est prioritaire sur le trousseau.
Clé sous forme de variable d'environnement
export FREELLMAPI_API_KEY=<unified-key>
zedAjoutez une entrée dans available_models pour chaque modèle que vous voulez dans le menu des modèles. auto:smart et auto:fast sont aussi des noms valides.
Méthode 2 : émulation Ollama
FreeLLMAPI peut agir comme serveur Ollama. Il sert /api/tags, /api/chat, /api/generate, /api/show, /api/version et /api/embed. Le streaming utilise du JSON délimité par des sauts de ligne, comme Ollama.
- Sur le tableau de bord FreeLLMAPI, ouvrez Keys, Agents.
- Réglez l'émulation Ollama sur
open-loopbackoukey-required. - Ajoutez le bloc ci-dessous au
settings.jsonde Zed. - Ouvrez le panneau d'agent et sélectionnez un modèle.
settings.json de Zed
{
"language_models": {
"ollama": {
"api_url": "http://localhost:3001",
"context_window": 128000
}
}
}open-loopbackne demande aucune clé, mais seulement pour les requêtes venant de cet ordinateur.- Si FreeLLMAPI tourne dans Docker,
open-loopbackrefuse les requêtes passant par un port publié. Utilisezkey-requiredet réglezOLLAMA_API_KEYsur votre clé unifiée, ou saisissez-la dans l'interface du fournisseur. - Zed envoie la taille du contexte sous la forme
num_ctx. La valeur par défaut est 4096 jetons, ce qui est trop petit pour le travail d'agent. Définissezcontext_window.
Choisir les modèles pour le panneau d'agent
La documentation de Zed indique que chaque modèle et chaque fournisseur doit prendre en charge l'appel d'outils. Un modèle sans prise en charge des outils affiche l'étiquette « No tools » dans le panneau d'agent. Utilisez des modèles avec appel d'outils et une grande fenêtre de contexte.
| Modèle | Gratuit sur | Contexte | Limites gratuites (meilleure offre) | Outils | Vision |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 req/min 1 req/min per model | Oui | Non |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 req/min 40 RPM | Oui | Oui |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Oui | Oui |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Oui | Non |
| 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 |
| 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 |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 req/min 250 req/jour 70,000 jetons/min ~6M | Oui | Oui |
Affichage de 10 modèles gratuits sur 109 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.
Les offres gratuites ont des limites par minute et par jour. Lorsqu'un fournisseur envoie une erreur 429, FreeLLMAPI essaie le modèle suivant de votre chaîne. Ajoutez des clés d'au moins quatre fournisseurs pour les longues sessions d'agent.
/v1/completions. FreeLLMAPI sert les deux. La documentation de Zed sur les prédictions de modification n'affiche aucun champ de clé API pour ces deux fournisseurs. Nous n'avons pas vérifié cette combinaison avec FreeLLMAPI. Testez-la avant de vous y fier.JetBrains AI Assistant
JetBrains AI Assistant peut utiliser un fournisseur compatible OpenAI ou un serveur Ollama local. Ouvrez Settings, Tools, AI Assistant, Providers & API keys. Il existe deux options :
- Bring your own key, compatible OpenAI : saisissez l'URL de base
http://localhost:3001/v1, votre clé unifiée et un identifiant de modèle tel queauto. La documentation de JetBrains indique que BYOK fonctionne avec les agents sans abonnement JetBrains AI. - Ollama : dans Third-party AI providers, sélectionnez Ollama. Saisissez
http://localhost:3001dans le champ URL et cliquez sur Test Connection. Attribuez ensuite les modèles dans Models Assignment. Activez d'abord l'émulation Ollama dans FreeLLMAPI.
La documentation de JetBrains fixe des limites pour les modèles locaux : les agents ne peuvent pas les utiliser, et AI Assistant ne peut pas appeler d'outils MCP avec eux. La complétion en ligne et les suggestions de modification suivante utilisent par défaut les modèles JetBrains. Pour le travail d'agent, utilisez l'option BYOK.
Dépannage
| Problème | Cause | Solution |
|---|---|---|
401 « Invalid API key » | Zed n'a pas de clé pour le fournisseur, ou la clé est incorrecte | Définissez FREELLMAPI_API_KEY, ou saisissez la clé dans les paramètres de l'agent |
| Étiquette « No tools » sur le modèle | Les outils sont désactivés pour le modèle, ou le modèle ne prend pas en charge l'appel d'outils | Définissez "tools": true et utilisez un modèle du tableau |
| Le fournisseur Ollama n'affiche aucun modèle | L'émulation Ollama est désactivée dans FreeLLMAPI | Activez-la dans Keys, Agents |
| Requêtes Ollama refusées depuis Docker | open-loopback n'accepte que les pairs en boucle locale | Utilisez key-required avec votre clé unifiée |
| Les longues invites perdent du contexte | num_ctx vaut 4096 jetons | Définissez context_window dans les paramètres Ollama |
| « All models rate-limited after N attempts » | Toutes les clés ont atteint leur limite | Ajoutez des clés d'autres fournisseurs, ou attendez la fin des délais de repos |
Questions fréquentes
Puis-je utiliser un LLM personnalisé dans Zed ?
Oui. Ajoutez un fournisseur openai_compatible avec api_url et available_models dans language_models, dans settings.json. Zed prend aussi en charge un fournisseur Ollama avec une api_url personnalisée.
Comment utiliser des modèles IA gratuits dans Zed ?
Pointez un fournisseur compatible OpenAI vers FreeLLMAPI sur http://localhost:3001/v1. La passerelle envoie chaque requête vers les offres gratuites des fournisseurs, donc l'inférence coûte 0 $.
Où Zed stocke-t-il la clé API d'un fournisseur personnalisé ?
Zed conserve la clé que vous saisissez dans les paramètres de l'agent dans le trousseau du système. Vous pouvez aussi définir une variable d'environnement nommée d'après l'identifiant du fournisseur, par exemple FREELLMAPI_API_KEY.
JetBrains AI Assistant fonctionne-t-il avec des modèles gratuits ?
Oui. Utilisez Bring your own key avec une URL de base compatible OpenAI, ou le fournisseur Ollama. La documentation de JetBrains indique que les agents ne peuvent pas utiliser de modèles locaux. Utilisez donc BYOK pour le travail d'agent.
Guides associés
- Modèles d'IA gratuits dans VS Code
- Continue avec une API LLM gratuite
- Cline, Roo Code et Kilo Code avec une API gratuite
- Meilleures API gratuites de modèles de code
- URL de base des API gratuites compatibles OpenAI
Sources
- Zed docs: use API access (OpenAI-compatible providers) (vérifié le 20 November 2026)
- Zed docs: use a local model (Ollama) (vérifié le 20 November 2026)
- Zed docs: agent panel (vérifié le 20 November 2026)
- Zed docs: edit prediction (vérifié le 20 November 2026)
- JetBrains AI Assistant: use custom models (vérifié le 20 November 2026)
- JetBrains AI Assistant: bring your own key (vérifié le 20 November 2026)
- FreeLLMAPI docs: Ollama clients (vérifié le 20 November 2026)