BroadRouter
Inizia

Usare Kilo Code con BroadNet Inference (provider OpenAI Compatible)

Aggiornato

In Kilo Code apri Settings, vai su Providers e clicca Custom provider. Scegli Provider API OpenAI Compatible, imposta Base URL su https://inference.broadnet.ai/v1, incolla la tua chiave BroadNet e aggiungi a mano un ID di modello come broadnet/glm-5.3. In kilo.json usa npm @ai-sdk/openai-compatible con options.baseURL e imposta limit.context e limit.output.

Kilo Code è un agente di coding open source per VS Code e per il terminale. Qualsiasi provider con un’API OpenAI Chat Completions si può aggiungere come custom provider. BroadNet Inference serve quel formato su https://inference.broadnet.ai/v1. BroadRouter è il sito di BroadNet; questa guida segue la documentazione di Kilo sui provider come si presentava il 15 novembre 2026.

Configurazione in VS Code

  1. Procurati una chiave. Crea una chiave a consumo nella console di BroadNet, oppure usa la chiave di un piano illimitato.

  2. Apri Settings (icona a ingranaggio) e vai nella scheda Providers.

  3. Scorri fino in fondo e clicca Custom provider.

  4. Compila la finestra:

    Campo Valore
    Provider ID broadnet
    Display name BroadNet Inference
    Provider API OpenAI Compatible
    Base URL https://inference.broadnet.ai/v1
    API key la tua chiave BroadNet
    Models aggiungi a mano broadnet/glm-5.3 (vedi sotto)
  5. Clicca Submit. Il modello compare nel selettore dei modelli.

  6. Provalo. Avvia un task come “explain this file”. Se risponde, la connessione funziona.

Kilo prova a riempire l’elenco dei modelli da /v1/models dell’endpoint. La documentazione di BroadNet descrive quell’endpoint come metadati del catalogo per i sistemi di monitoraggio, e al nostro controllo del 15 novembre 2026 elencava solo i due modelli di trascrizione. Scrivi tu gli ID dei modelli di chat e non scegliere i modelli di trascrizione.

Configurazione in kilo.json (CLI, oppure per limiti e flag degli strumenti)

La finestra di Kilo non imposta né i limiti di token né il tool calling. Per questo la sua documentazione rimanda al file di configurazione: ~/.config/kilo/kilo.json, oppure ./kilo.json in un progetto.

{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "broadnet/glm-5.3",
  "provider": {
    "broadnet": {
      "npm": "@ai-sdk/openai-compatible",
      "env": ["BROADNET_API_KEY"],
      "options": {
        "baseURL": "https://inference.broadnet.ai/v1"
      },
      "models": {
        "glm-5.3": {
          "id": "broadnet/glm-5.3",
          "name": "GLM 5.3",
          "tool_call": true,
          "reasoning": true,
          "limit": { "context": 1048576, "output": 16000 }
        },
        "qwen3.8-27b": {
          "id": "broadnet/qwen3.8-27b",
          "name": "Qwen3.8 27B",
          "tool_call": true,
          "reasoning": true,
          "modalities": { "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 262144, "output": 16000 }
        },
        "deepseek-v4.1-flash": {
          "id": "broadnet/deepseek-v4.1-flash",
          "name": "DeepSeek V4.1 Flash",
          "reasoning": true,
          "limit": { "context": 1048576, "output": 16000 }
        }
      }
    }
  }
}
export BROADNET_API_KEY='your-broadnet-key'
  • Il valore model di primo livello, broadnet/glm-5.3, è il nome del provider più la chiave della mappa (glm-5.3), non l’ID BroadNet. Il campo id è l’ID del modello che Kilo invia a BroadNet. La documentazione di Kilo dice che id prende di default il valore della chiave della mappa, quindi impostalo ogni volta che la chiave non è l’ID BroadNet completo, come con le chiavi brevi qui.
  • Imposta sempre limit.context e limit.output. Per un modello personalizzato senza corrispondenza nel catalogo, la documentazione di Kilo dice che entrambi valgono 0, e questo disattiva la gestione automatica del contesto. Il valore di output di 16.000 è un nostro suggerimento; lascia spazio al ragionamento.
  • tool_call è omesso di proposito per DeepSeek V4.1 Flash: la documentazione di BroadNet non indica il tool calling per quel modello. Aggiungilo dopo averlo testato.

Quale modello scegliere

Attività Modello Note
Coding da agente 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 lunghe, prezzo fisso DeepSeek V4.1 Flash Piani illimitati; strumenti non indicati da BroadNet

Prova il piano illimitato con un’ora di Meteor ($1) prima di un mese di Full Moon ($60).

Risoluzione dei problemi

  • “Invalid API Key” o 401. Incolla di nuovo la chiave. Controlla che abbia ancora quota disponibile e che BROADNET_API_KEY sia impostata nel processo che esegue Kilo.
  • “Model Not Found”. Controlla che l’ID corrisponda esattamente a quello di BroadNet, con il prefisso broadnet/. I modelli a pagamento richiedono una ricarica; il credito di $5 copre solo broadnet/gemma-4-26b-a4b e i due modelli Transcribe.
  • Risposta vuota o “response may be incomplete”. Kilo avvisa quando un modello di ragionamento spende tutto l’output nel ragionamento. Alza limit.output. Perché le risposte arrivano vuote.
  • 429. Una chiave a consumo consente 30 richieste al minuto e 4 in corso contemporaneamente. Vedi errori e retry.
  • Subagent in parallelo su una chiave del piano attendono o falliscono. Una sessione del piano esegue una richiesta alla volta, quindi dai a ogni subagent in parallelo la sua sessione.
  • Errori di connessione. Il Base URL deve finire con /v1. Se la chiave ha una allowlist di IP, aggiungi l’indirizzo della tua macchina.

Domande frequenti

Perché Kilo Code non elenca i modelli di chat di BroadNet dopo che inserisco il Base URL?

Kilo prende i modelli dall’elenco /v1/models dell’endpoint. Al nostro controllo del 15 novembre 2026, il /v1/models pubblico di BroadNet elencava solo i suoi due modelli di trascrizione, quindi aggiungi a mano gli ID dei modelli di chat.

Che valore deve avere limit.context per i modelli BroadNet?

1048576 per GLM 5.3 e DeepSeek V4.1 Flash, 262144 per Qwen3.8 27B e 32768 per BroadNet Gemma 4 VL 26B. La documentazione di Kilo dice che per i modelli personalizzati un limite mancante vale 0, e questo disattiva la gestione automatica del contesto.

Posso usare Kilo Code con il piano illimitato di BroadNet?

Sì. I piani coprono DeepSeek V4.1 Flash, ID broadnet/deepseek-v4.1-flash. Usa la chiave del piano come chiave API. La documentazione di BroadNet non indica il tool calling per quel modello, quindi prova prima un task da agente.

Come Provider API devo scegliere OpenAI Compatible o OpenAI Responses?

OpenAI Compatible. BroadNet serve chat completions su /v1/chat/completions e non elenca la Responses API.

Leggi in MarkdownChiedi a ChatGPTChiedi a ClaudeChiedi a Perplexity