Accueil / Guides / Utiliser des modèles IA gratuits dans Zed

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éthodeParamètre ZedPoint de terminaison FreeLLMAPIClé
Fournisseur compatible OpenAI (recommandé)language_models.openai_compatiblehttp://localhost:3001/v1Clé unifiée, dans l'interface des paramètres de Zed ou dans une variable d'environnement
Fournisseur Ollamalanguage_models.ollamahttp://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 | bash

Mé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 settings depuis 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'identifiant freellmapi, le nom est FREELLMAPI_API_KEY. La variable est prioritaire sur le trousseau.

Clé sous forme de variable d'environnement

export FREELLMAPI_API_KEY=<unified-key>
zed

Ajoutez 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.

  1. Sur le tableau de bord FreeLLMAPI, ouvrez Keys, Agents.
  2. Réglez l'émulation Ollama sur open-loopback ou key-required.
  3. Ajoutez le bloc ci-dessous au settings.json de Zed.
  4. 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-loopback ne demande aucune clé, mais seulement pour les requêtes venant de cet ordinateur.
  • Si FreeLLMAPI tourne dans Docker, open-loopback refuse les requêtes passant par un port publié. Utilisez key-required et réglez OLLAMA_API_KEY sur 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éfinissez context_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èles gratuits pour le panneau d'agent de Zed : appel d'outils et contexte de 128K+
ModèleGratuit surContexteLimites gratuites (meilleure offre)OutilsVision
GLM 5.3UnoRouter1M1 req/min
1 req/min per model
OuiNon
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 req/min
40 RPM
OuiOui
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaOuiOui
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceOuiNon
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
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
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 req/min
250 req/jour
70,000 jetons/min
~6M
OuiOui

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.

Prédictions de modification : Zed peut envoyer des prédictions de modification à un serveur Ollama ou à un point de terminaison compatible OpenAI /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 que auto. 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:3001 dans 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èmeCauseSolution
401 « Invalid API key »Zed n'a pas de clé pour le fournisseur, ou la clé est incorrecteDéfinissez FREELLMAPI_API_KEY, ou saisissez la clé dans les paramètres de l'agent
Étiquette « No tools » sur le modèleLes outils sont désactivés pour le modèle, ou le modèle ne prend pas en charge l'appel d'outilsDéfinissez "tools": true et utilisez un modèle du tableau
Le fournisseur Ollama n'affiche aucun modèleL'émulation Ollama est désactivée dans FreeLLMAPIActivez-la dans Keys, Agents
Requêtes Ollama refusées depuis Dockeropen-loopback n'accepte que les pairs en boucle localeUtilisez key-required avec votre clé unifiée
Les longues invites perdent du contextenum_ctx vaut 4096 jetonsDéfinissez context_window dans les paramètres Ollama
« All models rate-limited after N attempts »Toutes les clés ont atteint leur limiteAjoutez des clés d'autres fournisseurs, ou attendez la fin des délais de repos
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

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

Sources

Tous les guides · Parcourir tous les modèles gratuits