BroadRouter

Utiliser Zed avec BroadNet Inference, fournisseur compatible OpenAI

Mis à jour

Dans le settings.json de Zed, ajoutez un fournisseur sous language_models.openai_compatible, par exemple broadnet, avec api_url sur https://inference.broadnet.ai/v1 et available_models listant des ID BroadNet comme broadnet/glm-5.3, max_tokens étant la taille du contexte. Zed lit la clé dans BROADNET_API_KEY, ou vous pouvez l’enregistrer dans Agent Settings.

Zed est un éditeur de code open source avec un agent intégré. Il se connecte à tout serveur doté d’une API compatible OpenAI grâce à son type de fournisseur openai_compatible. BroadNet Inference sert des chat completions standard à https://inference.broadnet.ai/v1 : il convient donc. BroadRouter est le site de BroadNet ; les étapes ci-dessous suivent la documentation d’accès API de Zed dans sa version Zed 1.28.

Configuration

  1. Obtenez une clé. Créez une clé à l’usage dans la console BroadNet, ou utilisez la clé d’un forfait illimité.
  2. Ajoutez le fournisseur. Ouvrez Agent Settings avec la commande agent: open settings et cliquez sur Add Provider dans la section LLM Providers, ou modifiez directement settings.json :
{
  "language_models": {
    "openai_compatible": {
      "broadnet": {
        "api_url": "https://inference.broadnet.ai/v1",
        "available_models": [
          {
            "name": "broadnet/glm-5.3",
            "display_name": "GLM 5.3 (BroadNet)",
            "max_tokens": 1048576,
            "max_output_tokens": 16000,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": true
            }
          },
          {
            "name": "broadnet/qwen3.8-27b",
            "display_name": "Qwen3.8 27B (BroadNet)",
            "max_tokens": 262144,
            "max_output_tokens": 16000,
            "capabilities": {
              "tools": true,
              "images": true,
              "parallel_tool_calls": false,
              "prompt_cache_key": false,
              "chat_completions": true,
              "interleaved_reasoning": false,
              "max_tokens_parameter": true
            }
          }
        ]
      }
    }
  }
}
  1. Donnez la clé à Zed. Exportez-la avant de lancer Zed, ou collez-la dans le fournisseur depuis Agent Settings. Zed enregistre les clés collées dans le trousseau du système, pas dans settings.json.
export BROADNET_API_KEY='your-broadnet-key'
  1. Testez. Ouvrez l’Agent Panel, choisissez GLM 5.3 (BroadNet) dans le sélecteur de modèle et posez une petite question sur un fichier ouvert. Si une réponse arrive, la connexion fonctionne.

Ce que signifient les réglages

  • name est l’ID de modèle que Zed envoie. Utilisez exactement l’ID de BroadNet, avec le préfixe broadnet/.
  • max_tokens est la fenêtre de contexte dans le schéma de Zed, pas la limite de sortie. Mettez 1 048 576 pour GLM 5.3 et DeepSeek V4.1 Flash, et 262 144 pour Qwen3.8 27B.
  • max_output_tokens plafonne la réponse. Les 16 000 ci-dessus sont notre suggestion, pas une limite de BroadNet. Le raisonnement compte dedans : ne le réglez pas trop bas.
  • max_tokens_parameter: true fait envoyer à Zed la limite de sortie sous le nom max_tokens au lieu de max_completion_tokens. La référence de l’API de BroadNet décrit le champ max_tokens.
  • images vaut false par défaut pour les modèles compatibles OpenAI. Activez-le seulement pour les modèles qui acceptent des images : Qwen3.8 27B, DeepSeek V4.1 Flash et BroadNet Gemma 4 VL 26B.
  • reasoning_effort est facultatif. La documentation de BroadNet suggère low si vous voulez un raisonnement plus court.

Quel modèle choisir

Usage Modèle Pourquoi
Modifications par l’agent avec outils broadnet/glm-5.3 BroadNet liste les outils et la sortie structurée ; contexte de 1M
Captures d’écran et texte arabe broadnet/qwen3.8-27b Outils plus entrée d’images ; contexte de 262K
Longues conversations avec un forfait à prix fixe broadnet/deepseek-v4.1-flash Le modèle du forfait illimité ; entrée image ; outils non listés par BroadNet

Zed suppose tools: true pour les modèles compatibles OpenAI. La documentation de BroadNet ne liste pas l’appel d’outils pour DeepSeek V4.1 Flash : testez-le sur une vraie tâche d’agent avant de compter dessus. Une heure Meteor ($1) est un moyen peu coûteux d’essayer avant un mois Full Moon ($60).

Dépannage

  • 401. La clé est erronée, expirée ou à court de crédit. Si vous avez défini BROADNET_API_KEY, elle l’emporte sur le trousseau ; supprimez-la et relancez Zed pour utiliser la clé enregistrée.
  • 404 sur chaque requête. Vérifiez que api_url se termine par /v1. Vérifiez ensuite que name correspond exactement à l’ID BroadNet. Les modèles payants nécessitent une recharge ; le crédit de $5 ne couvre que broadnet/gemma-4-26b-a4b et les deux modèles Transcribe.
  • Réponses vides. Le modèle a dépensé son budget de sortie en raisonnement. Augmentez max_output_tokens ou réglez reasoning_effort sur low. Pourquoi les réponses reviennent vides.
  • 429. Une clé à l’usage autorise 30 requêtes par minute et 4 en parallèle. Une session de forfait traite une requête à la fois. Voir erreurs et nouvelles tentatives.
  • Projets distants. Zed initialise les fournisseurs dans l’application locale : via SSH, la clé vient donc de votre trousseau local ou de votre environnement local, pas de la machine distante.

Questions fréquentes

Quelle variable d’environnement Zed lit-il pour la clé d’un fournisseur personnalisé ?

Zed construit le nom à partir de l’ID du fournisseur en majuscules avec des underscores, suivi de _API_KEY. Un fournisseur nommé broadnet lit BROADNET_API_KEY. Une variable non vide a priorité sur une clé enregistrée dans le trousseau.

Le modèle BroadNet fonctionne-t-il dans l’Agent Panel de Zed ?

Oui. L’accès API de Zed couvre le Zed Agent, l’Inline Assistant, les messages de commit et les résumés de fils. Zed suppose que les modèles compatibles OpenAI gèrent les outils : choisissez donc GLM 5.3 ou Qwen3.8 27B, que BroadNet liste avec les outils.

Est-ce que cela modifie les prédictions d’édition de Zed ?

Non. Selon la documentation de Zed, la prédiction d’édition a sa propre configuration de fournisseur sous edit_predictions. Le fournisseur de ce guide sert à l’agent et aux autres fonctions d’IA de Zed.

Pourquoi Zed dit-il que le modèle ne fonctionne qu’avec la Responses API ?

Cela ne devrait pas arriver avec BroadNet. Laissez capabilities.chat_completions à sa valeur par défaut, true. BroadNet sert /v1/chat/completions et ne liste pas la Responses API.

Lire en MarkdownDemander à ChatGPTDemander à ClaudeDemander à Perplexity