BroadRouter
Commencer

Ajouter BroadNet Inference à opencode comme fournisseur personnalisé

Mis à jour

Dans opencode.jsonc, ajoutez une entrée broadnet sous providers avec package @opencode/ai/providers/openai-compatible, settings.baseURL défini sur https://inference.broadnet.ai/v1 et env sur BROADNET_API_KEY. Associez des clés de modèle courtes aux ID BroadNet via modelID, par exemple broadnet/glm-5.3, puis choisissez le modèle avec /models. Les anciennes configurations V1 avec npm @ai-sdk/openai-compatible et options.baseURL fonctionnent toujours.

opencode est un agent de code open source pour le terminal. Les fournisseurs absents de son catalogue intégré s’ajoutent comme fournisseurs personnalisés (custom providers) dans opencode.jsonc. BroadNet Inference parle le format chat completions d’OpenAI et utilise donc le paquet d’exécution compatible OpenAI d’opencode. Ce guide suit la documentation actuelle (V2) d’opencode.

Mise en place

  1. Exportez votre clé dans le shell qui lance opencode :
export BROADNET_API_KEY='your-broadnet-key'
  1. Créez la configuration. Placez-la dans votre projet sous opencode.jsonc, ou dans ~/.config/opencode/opencode.jsonc pour l’utiliser partout.
{
  "$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. Lancez opencode et choisissez le modèle avec /models. La référence est broadnet/<map key>, par exemple broadnet/glm-5.3. opencode envoie la valeur de modelID à BroadNet.

Les fichiers de configuration se fusionnent. opencode applique d’abord le fichier global, puis les fichiers de projet trouvés en remontant depuis le répertoire courant (le plus éloigné d’abord), puis toute configuration .opencode/ : un fichier de projet peut donc remplacer le fournisseur global. La configuration système gérée, si votre entreprise en utilise une, l’emporte sur les deux. Gardez la clé dans l’environnement, pas dans le fichier, pour pouvoir versionner la configuration.

Pourquoi des alias

Les ID BroadNet contiennent déjà une barre oblique (broadnet/glm-5.3). La clé de la map models est ce qu’opencode affiche et sélectionne, et modelID est ce qu’il envoie. Des clés courtes gardent les références lisibles.

Définissez vous-même capabilities et limit. Pour un modèle hors de son catalogue, opencode suppose la prise en charge des outils JSON, l’entrée texte et image, un contexte de 200 000 tokens et 32 000 tokens de sortie. Sa documentation parle d’hypothèses par défaut, pas de valeurs détectées. La valeur output de 16000 ci-dessus est notre suggestion, pas une limite de BroadNet ; elle laisse de la place au raisonnement.

Anciennes configurations V1

opencode V2 lit toujours le format V1 : un bloc existant comme celui-ci continue de fonctionner.

{
  "$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" }
      }
    }
  }
}

Dans la forme native V2, provider devient providers, npm devient package (aisdk:@ai-sdk/openai-compatible si vous voulez garder le paquet AI SDK), et options.baseURL et options.apiKey passent sous settings. Le guide de migration V1 d’opencode fait la correspondance de chaque champ.

Quel modèle choisir ?

Tâche Modèle Remarques
Code agentique avec outils GLM 5.3 Outils et sortie structurée indiqués ; contexte de 1M
Captures d’écran, arabe Qwen3.8 27B Outils et images ; contexte de 262K
Sessions toute la journée, prix forfaitaire DeepSeek V4.1 Flash Forfaits illimités ; outils non indiqués par BroadNet

opencode repose sur les appels d’outils. La documentation de BroadNet n’indique pas l’appel d’outils pour DeepSeek V4.1 Flash : la configuration le marque donc comme une hypothèse à tester. Essayez une vraie tâche avec une heure Meteor ($1) avant d’acheter un mois Full Moon ($60).

Dépannage

  • 401. La clé dans BROADNET_API_KEY est erronée, expirée ou son quota de paiement à l’usage est épuisé. Vérifiez que la variable est définie dans le processus qui exécute opencode.
  • Modèle introuvable ou refusé. Sélectionnez la clé de la map (broadnet/glm-5.3) et vérifiez que modelID correspond exactement à l’ID BroadNet. Les références sont sensibles à la casse. 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. Augmentez limit.output. Pourquoi les réponses reviennent vides.
  • 429. Les clés à l’usage autorisent 30 requêtes par minute et 4 requêtes en cours. Les nouvelles tentatives comptent aussi. Voir codes d’erreur et nouvelles tentatives.
  • Sous-agents sur un forfait. Chaque session de forfait traite une requête à la fois : des sous-agents parallèles font la queue, sauf si chacun a sa propre session.

Questions fréquentes

Pourquoi opencode ne trouve-t-il pas mon modèle BroadNet ?

opencode résout la référence sous la forme fournisseur/clé de la map, et les ID sont sensibles à la casse. Avec la configuration ci-dessous, sélectionnez broadnet/glm-5.3, où glm-5.3 est la clé de la map. La valeur de modelID n’est que ce qui est envoyé à BroadNet.

Ma configuration utilise provider et npm avec @ai-sdk/openai-compatible. Est-ce une erreur ?

Non. C’est le format V1, et le guide de migration d’opencode indique qu’il reste pris en charge. La forme native V2 renomme provider en providers, npm en package (aisdk:@ai-sdk/openai-compatible) et options.baseURL en settings.baseURL.

Pourquoi les réponses d’opencode sont-elles vides ?

Le modèle a dépensé son budget de sortie en raisonnement. Augmentez limit.output pour ce modèle. Chez BroadNet, le raisonnement est décompté de max_tokens.

Lire en MarkdownDemander à ChatGPTDemander à ClaudeDemander à Perplexity