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
- Exportez votre clé dans le shell qui lance opencode :
export BROADNET_API_KEY='your-broadnet-key'
- Créez la configuration. Placez-la dans votre projet sous
opencode.jsonc, ou dans~/.config/opencode/opencode.jsoncpour 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 }
}
}
}
}
}
- Lancez opencode et choisissez le modèle avec
/models. La référence estbroadnet/<map key>, par exemplebroadnet/glm-5.3. opencode envoie la valeur demodelIDà 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_KEYest 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 quemodelIDcorrespond 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 quebroadnet/gemma-4-26b-a4bet 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.
