---
title: "Zed: provider compatibile OpenAI (GLM, Qwen) | BroadRouter"
description: "Aggiungi BroadNet Inference a Zed come provider compatibile con OpenAI in settings.json, con ID dei modelli, limiti di token, capabilities e variabile della chiave."
url: https://broadrouter.com/it/guides/zed-openai-compatible-provider/
lang: it
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Tradotto dall’inglese con l’aiuto dell’IA. [Leggi l’originale in inglese](https://broadrouter.com/guides/zed-openai-compatible-provider/) (aggiornato il 2026-11-16).

# Usare Zed con BroadNet Inference come provider compatibile OpenAI

Aggiornato 2026-11-16

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](https://zed.dev/docs/ai/use-api-access#openai-compatible) 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](https://broadrouter.com/it/guides/unlimited-llm-api-sessions/).
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`:

```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
            }
          }
        ]
      }
    }
  }
}
```

3.  **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`.

```bash
export BROADNET_API_KEY='your-broadnet-key'
```

4.  **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](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/).
-   **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](https://broadrouter.com/it/guides/errors-and-retries/).
-   **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.

## Termini in questa guida

[Pagamento a consumo (pay-as-you-go)](https://broadrouter.com/it/glossary/pay-as-you-go/)

Il pagamento a consumo è un modello di prezzo in cui paghi solo ciò che usi, misurato per unità come token, richieste o minuti di audio, senza abbonamento né impegno minimo. La maggior parte delle API LLM fattura così, da un saldo prepagato o con una fattura periodica.

[Concorrenza (concurrency)](https://broadrouter.com/it/glossary/concurrency/)

La concorrenza è il numero di richieste che un client ha in corso nello stesso momento. Le API LLM spesso la limitano per chiave o per piano, separatamente dalle richieste al minuto, perché ogni richiesta aperta occupa capacità GPU finché la sua risposta non è terminata.

[Rate limit (limite di frequenza)](https://broadrouter.com/it/glossary/rate-limit/)

Un rate limit è un tetto che un’API pone a quanto un client può usarla in un intervallo di tempo, per esempio richieste al minuto o token al minuto. Le richieste oltre il limite vengono rifiutate, di solito con HTTP 429 Too Many Requests, finché l’uso non torna sotto la soglia.

[Tool calling (chiamata di strumenti)](https://broadrouter.com/it/glossary/tool-calling/)

Il tool calling, detto anche function calling, è una funzionalità delle API LLM in cui il modello restituisce una richiesta strutturata di eseguire una funzione definita dallo sviluppatore, con argomenti JSON. L’applicazione esegue la funzione e rimanda il risultato; il modello non esegue mai codice da solo.

[API compatibile con OpenAI](https://broadrouter.com/it/glossary/openai-compatible-api/)

Un’API compatibile con OpenAI è un’API HTTP che accetta gli stessi formati di richiesta e di risposta dell’API di OpenAI, come POST /v1/chat/completions, così SDK e strumenti di OpenAI possono usarla cambiando solo base URL, chiave API e nome del modello.

[Chat Completions API](https://broadrouter.com/it/glossary/chat-completions-api/)

La Chat Completions API è l’endpoint HTTP di OpenAI, POST /v1/chat/completions, che riceve il nome di un modello e una lista di messaggi con un ruolo e restituisce il messaggio successivo del modello. La forma della sua richiesta e risposta è diventata il formato comune che riusano provider e SDK compatibili con OpenAI.

[Credito prepagato (prepaid credit)](https://broadrouter.com/it/glossary/prepaid-credit/)

Il credito prepagato è denaro aggiunto a un account API prima dell’uso. Ogni richiesta scala il proprio costo dal saldo e, quando il saldo si esaurisce, le richieste a consumo si fermano finché non ricarichi. Limita la spesa a quanto hai versato.

[Finestra di contesto (context window)](https://broadrouter.com/it/glossary/context-window/)

La finestra di contesto è il numero massimo di token con cui un modello linguistico può lavorare in una singola richiesta. Comprende prompt, cronologia della conversazione, definizioni degli strumenti, immagini e output generato, token di ragionamento inclusi. Ciò che non ci sta va tagliato, riassunto o diviso su più richieste.

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

## Guide correlate

-   [Usare Kilo Code con BroadNet Inference (provider OpenAI Compatible)](https://broadrouter.com/it/guides/kilo-code-openai-compatible/)
-   [Usare Cline con BroadNet Inference (provider OpenAI Compatible)](https://broadrouter.com/it/guides/cline-openai-compatible/)
-   [Perché un modello di ragionamento restituisce una risposta vuota](https://broadrouter.com/it/guides/reasoning-tokens-empty-response/)
-   [Codici di errore di BroadNet Inference e quando ritentare](https://broadrouter.com/it/guides/errors-and-retries/)
-   [Tutti gli strumenti che funzionano con BroadNet Inference (in inglese)](https://broadrouter.com/integrations/): SDK, agenti di coding, interfacce di chat e strumenti di automazione, con le impostazioni esatte per ciascuno

Provalo sul tuo carico di lavoro reale. I nuovi account partono con USD 5 di credito per Gemma e trascrizione. DeepSeek, GLM e Qwen3.8 richiedono una ricarica.

[Inizia](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-zed-openai-compatible-provider&utm_content=page-cta) ·

**Fonti**

-   [Documentazione di Zed, Use API Access, endpoint compatibili con OpenAI (verificata il 2026-11-15)](https://zed.dev/docs/ai/use-api-access#openai-compatible)
-   [Release di Zed su GitHub, ultima v1.28.1 (verificata il 2026-11-15)](https://github.com/zed-industries/zed/releases)
-   [Riferimento API di BroadNet Inference (verificato il 2026-11-15) (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-guides-zed-openai-compatible-provider&utm_content=sources)
