BroadRouter
Inizia

Usare Zed con BroadNet Inference come provider compatibile OpenAI

Aggiornato

Nel settings.json di Zed aggiungi un provider sotto language_models.openai_compatible, per esempio broadnet, con api_url impostato su https://inference.broadnet.ai/v1 e available_models con gli ID BroadNet, come broadnet/glm-5.3, e max_tokens pari alla dimensione del contesto. Zed legge la chiave da BROADNET_API_KEY, oppure puoi salvarla in Agent Settings.

Zed è un editor di codice open source con un agente integrato. Si collega a qualsiasi server con un’API compatibile con OpenAI tramite il tipo di provider openai_compatible. BroadNet Inference serve chat completions standard su https://inference.broadnet.ai/v1, quindi è compatibile. BroadRouter è il sito di BroadNet; i passaggi seguono la documentazione di Zed sull’accesso API aggiornata a Zed 1.28.

Configurazione

  1. Procurati una chiave. Crea una chiave a consumo nella console di BroadNet, oppure usa la chiave di un piano illimitato.
  2. Aggiungi il provider. Apri Agent Settings con il comando agent: open settings e clicca Add Provider nella sezione LLM Providers, oppure modifica direttamente 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. Passa la chiave a Zed. Esportala prima di avviare Zed, oppure incollala nel provider in Agent Settings. Zed salva le chiavi incollate nel portachiavi di sistema, non in settings.json.
export BROADNET_API_KEY='your-broadnet-key'
  1. Provalo. Apri l’Agent Panel, scegli GLM 5.3 (BroadNet) nel selettore dei modelli e fai una piccola domanda su un file aperto. Se arriva una risposta, la connessione funziona.

Cosa significano le impostazioni

  • name è l’ID del modello che Zed invia. Usa l’ID di BroadNet esattamente com’è, con il prefisso broadnet/.
  • max_tokens nello schema di Zed è la finestra di contesto, non il limite di output. Usa 1.048.576 per GLM 5.3 e DeepSeek V4.1 Flash, e 262.144 per Qwen3.8 27B.
  • max_output_tokens limita la risposta. Il valore 16.000 qui sopra è un nostro suggerimento, non un limite di BroadNet. Il ragionamento conta in questo limite, quindi non tenerlo basso.
  • max_tokens_parameter: true fa inviare a Zed il limite di output come max_tokens invece di max_completion_tokens. Il riferimento API di BroadNet descrive il campo max_tokens.
  • images vale false per default nei modelli compatibili con OpenAI. Attivalo solo per i modelli che accettano immagini: Qwen3.8 27B, DeepSeek V4.1 Flash e BroadNet Gemma 4 VL 26B.
  • reasoning_effort è facoltativo. La documentazione di BroadNet suggerisce low se vuoi un ragionamento più breve.

Quale modello scegliere

Uso Modello Perché
Modifiche dell’agente con tool broadnet/glm-5.3 BroadNet indica tool e output strutturato; contesto di 1M
Screenshot e testo in arabo broadnet/qwen3.8-27b Tool più input di immagini; contesto di 262K
Chat lunghe con un piano a prezzo fisso broadnet/deepseek-v4.1-flash Il modello del piano illimitato; input di immagini; BroadNet non indica i tool

Zed presume tools: true per i modelli compatibili con OpenAI. La documentazione di BroadNet non indica il tool calling per DeepSeek V4.1 Flash, quindi prova un vero task dell’agente prima di farci affidamento. Un’ora Meteor ($1) è un modo economico per provarlo prima di un mese Full Moon ($60).

Risoluzione dei problemi

  • 401. La chiave è sbagliata, scaduta o senza più credito disponibile. Se hai impostato BROADNET_API_KEY, ha la precedenza sul portachiavi; rimuovila e riavvia Zed per usare la chiave salvata.
  • 404 su ogni richiesta. Controlla che api_url finisca con /v1. Poi verifica che name corrisponda esattamente all’ID di BroadNet. I modelli a pagamento richiedono una ricarica; il credito di $5 copre solo broadnet/gemma-4-26b-a4b e i due modelli Transcribe.
  • Risposte vuote. Il modello ha speso il budget di output nel ragionamento. Alza max_output_tokens o imposta reasoning_effort su low. Perché le risposte arrivano vuote.
  • 429. Una chiave a consumo consente 30 richieste al minuto e 4 in corso. Una sessione di un piano esegue una richiesta alla volta. Vedi errori e retry.
  • Progetti remoti. Zed inizializza i provider nell’app locale, quindi via SSH la chiave arriva dal portachiavi o dall’ambiente locale, non dalla macchina remota.

Domande frequenti

Quale variabile d’ambiente legge Zed per la chiave di un provider personalizzato?

Zed costruisce il nome dall’ID del provider in upper snake case più _API_KEY. Un provider chiamato broadnet legge BROADNET_API_KEY. Una variabile non vuota ha la precedenza su una chiave salvata nel portachiavi.

Il modello BroadNet funziona nell’Agent Panel di Zed?

Sì. L’accesso API di Zed copre lo Zed Agent, l’Inline Assistant, i messaggi di commit e i riassunti dei thread. Zed dà per scontato il supporto ai tool per i modelli compatibili con OpenAI, quindi scegli GLM 5.3 o Qwen3.8 27B, che BroadNet elenca con i tool.

Questo cambia le edit prediction di Zed?

No. La documentazione di Zed dice che l’edit prediction ha una configurazione del provider separata, sotto edit_predictions. Il provider di questa guida serve all’agente e alle altre funzioni AI di Zed.

Perché Zed dice che il modello funziona solo con la Responses API?

Con BroadNet non dovrebbe succedere. Lascia capabilities.chat_completions al valore predefinito true. BroadNet serve /v1/chat/completions e non elenca la Responses API.

Leggi in MarkdownChiedi a ChatGPTChiedi a ClaudeChiedi a Perplexity