BroadRouter
Inizia

Aggiungere BroadNet Inference a opencode come provider personalizzato

Aggiornato

In opencode.jsonc aggiungi una voce broadnet sotto providers con package @opencode/ai/providers/openai-compatible, settings.baseURL impostato su https://inference.broadnet.ai/v1 ed env impostato su BROADNET_API_KEY. Associa chiavi brevi agli ID di BroadNet con modelID, per esempio broadnet/glm-5.3, poi scegli il modello con /models. Le vecchie configurazioni V1 con npm @ai-sdk/openai-compatible e options.baseURL funzionano ancora.

opencode è un agente di coding open source per il terminale. I provider che non fanno parte del suo catalogo integrato si aggiungono come provider personalizzati in opencode.jsonc. BroadNet Inference parla il formato chat completions di OpenAI, quindi usa il pacchetto runtime compatibile con OpenAI di opencode. Questa guida segue la documentazione attuale (V2) di opencode.

Configurazione

  1. Esporta la chiave nella shell da cui avvii opencode:
export BROADNET_API_KEY='your-broadnet-key'
  1. Crea la configurazione. Mettila nel progetto come opencode.jsonc, oppure in ~/.config/opencode/opencode.jsonc per usarla ovunque.
{
  "$schema": "https://opencode.ai/config.json",
  "model": "broadnet/glm-5.3",
  "providers": {
    "broadnet": {
      "name": "BroadNet Inference",
      "env": ["BROADNET_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://inference.broadnet.ai/v1"
      },
      "models": {
        "glm-5.3": {
          "modelID": "broadnet/glm-5.3",
          "name": "GLM 5.3",
          "capabilities": { "tools": true, "input": ["text"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "deepseek-v4.1-flash": {
          "modelID": "broadnet/deepseek-v4.1-flash",
          "name": "DeepSeek V4.1 Flash",
          // BroadNet's docs don't list tool calling for this model: test it first
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "qwen3.8-27b": {
          "modelID": "broadnet/qwen3.8-27b",
          "name": "Qwen3.8 27B",
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 262144, "output": 16000 }
        }
      }
    }
  }
}
  1. Avvia opencode e scegli il modello con /models. Il riferimento è broadnet/<map key>, per esempio broadnet/glm-5.3. opencode invia a BroadNet il valore di modelID.

I file di configurazione si uniscono. opencode applica prima il file globale, poi i file di progetto trovati risalendo dalla directory corrente (prima i più lontani), poi l’eventuale configurazione in .opencode/; così un file di progetto può sovrascrivere il provider globale. La configurazione di sistema gestita, se la tua azienda la usa, ha la precedenza su entrambi. Tieni la chiave nell’ambiente, non nel file, così puoi mettere la configurazione sotto controllo di versione.

Perché gli alias

Gli ID di BroadNet contengono già una barra (broadnet/glm-5.3). La chiave della mappa models è ciò che opencode mostra e seleziona, mentre modelID è ciò che invia. Le chiavi brevi rendono i riferimenti leggibili.

Imposta tu capabilities e limit. Per un modello fuori dal suo catalogo, opencode presume il supporto agli strumenti JSON, input di testo e immagini, un contesto di 200.000 token e 32.000 token di output. La sua documentazione li chiama presupposti di ripiego, non valori rilevati. Il valore output di 16000 qui sopra è un nostro suggerimento, non un limite di BroadNet; lascia spazio al ragionamento.

Vecchie configurazioni V1

opencode V2 legge ancora il formato V1, quindi un blocco esistente come questo continua a funzionare:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "broadnet": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BroadNet Inference",
      "options": {
        "baseURL": "https://inference.broadnet.ai/v1",
        "apiKey": "{env:BROADNET_API_KEY}"
      },
      "models": {
        "broadnet/glm-5.3": { "name": "GLM 5.3" }
      }
    }
  }
}

Nella forma nativa V2, provider diventa providers, npm diventa package (aisdk:@ai-sdk/openai-compatible se vuoi mantenere il pacchetto dell’AI SDK), e options.baseURL e options.apiKey passano sotto settings. La guida alla migrazione dalla V1 di opencode indica la corrispondenza di ogni campo.

Quale modello scegliere

Attività Modello Note
Coding agentico con strumenti GLM 5.3 Strumenti e output strutturato indicati; contesto da 1M
Screenshot, arabo Qwen3.8 27B Strumenti e immagini; contesto da 262K
Sessioni di un’intera giornata, prezzo fisso DeepSeek V4.1 Flash Piani illimitati; strumenti non indicati da BroadNet

opencode si basa sulle chiamate agli strumenti. La documentazione di BroadNet non indica il tool calling per DeepSeek V4.1 Flash, quindi la configurazione lo segna come un’ipotesi da verificare. Prova un task reale con un’ora di Meteor ($1) prima di comprare un mese di Full Moon ($60).

Risoluzione dei problemi

  • 401. La chiave in BROADNET_API_KEY è sbagliata, scaduta o ha esaurito la quota a consumo. Verifica che la variabile sia impostata nel processo che esegue opencode.
  • Modello non trovato o rifiutato. Seleziona la chiave della mappa (broadnet/glm-5.3) e controlla che modelID corrisponda esattamente all’ID di BroadNet. I riferimenti distinguono maiuscole e minuscole. 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. Alza limit.output. Perché le risposte arrivano vuote.
  • 429. Le chiavi a consumo consentono 30 richieste al minuto e 4 in corso. Contano anche i nuovi tentativi. Vedi errori e nuovi tentativi.
  • Subagenti su un piano. Ogni sessione del piano gestisce una richiesta alla volta, quindi i subagenti in parallelo finiscono in coda, a meno che ognuno non abbia la propria sessione.

Domande frequenti

Perché opencode non trova il mio modello BroadNet?

opencode risolve il riferimento come provider/chiave della mappa, e gli ID distinguono maiuscole e minuscole. Con la configurazione qui sotto, seleziona broadnet/glm-5.3, dove glm-5.3 è la chiave della mappa. Il valore di modelID è solo ciò che viene inviato a BroadNet.

La mia configurazione usa provider e npm con @ai-sdk/openai-compatible. È sbagliata?

No. È il formato V1, e la guida alla migrazione di opencode dice che resta supportato. La forma nativa V2 rinomina provider in providers, npm in package (aisdk:@ai-sdk/openai-compatible) e options.baseURL in settings.baseURL.

Perché opencode restituisce risposte vuote?

Il modello ha speso il budget di output nel ragionamento. Alza limit.output per quel modello. Su BroadNet il ragionamento conta in max_tokens.

Leggi in MarkdownChiedi a ChatGPTChiedi a ClaudeChiedi a Perplexity