---
title: "opencode : fournisseur personnalisé compatible OpenAI"
description: "Ajoutez BroadNet Inference à l’agent de code opencode comme fournisseur compatible OpenAI dans opencode.jsonc, avec alias de modèles, capacités et limites."
url: https://broadrouter.com/fr/guides/opencode-custom-provider/
lang: fr
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Traduit de l’anglais avec l’aide de l’IA. [Lire l’original en anglais](https://broadrouter.com/guides/opencode-custom-provider/) (mis à jour le 2026-11-16).

# Ajouter BroadNet Inference à opencode comme fournisseur personnalisé

Mis à jour 2026-11-16

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 :

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

2.  **Créez la configuration.** Placez-la dans votre projet sous `opencode.jsonc`, ou dans `~/.config/opencode/opencode.jsonc` pour l’utiliser partout.

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

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

```json
{
  "$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](https://opencode.ai/docs/migrate-v1/) fait la correspondance de chaque champ.

## Quel modèle choisir ?

| Tâche | Modèle | Remarques |
| --- | --- | --- |
| Code agentique avec outils | [GLM 5.3](https://broadrouter.com/fr/models/glm-5.3/) | Outils et sortie structurée indiqués ; contexte de 1M |
| Captures d’écran, arabe | [Qwen3.8 27B](https://broadrouter.com/fr/models/qwen3.8-27b/) | Outils et images ; contexte de 262K |
| Sessions toute la journée, prix forfaitaire | [DeepSeek V4.1 Flash](https://broadrouter.com/fr/models/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](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/).
-   **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](https://broadrouter.com/fr/guides/errors-and-retries/).
-   **Sous-agents sur un forfait.** Chaque [session de forfait](https://broadrouter.com/fr/guides/unlimited-llm-api-sessions/) traite une requête à la fois : des sous-agents parallèles font la queue, sauf si chacun a sa propre session.

## Termes de ce guide

[Appel d’outils (tool calling, function calling)](https://broadrouter.com/fr/glossary/tool-calling/)

L’appel d’outils, aussi appelé function calling, est une fonctionnalité des API LLM dans laquelle le modèle renvoie une demande structurée d’exécution d’une fonction définie par le développeur, avec des arguments JSON. L’application exécute la fonction et renvoie le résultat ; le modèle n’exécute jamais de code lui-même.

[Token](https://broadrouter.com/fr/glossary/token/)

Un token est l’unité de texte qu’un modèle de langage lit et écrit : un mot, une partie de mot, un signe de ponctuation ou une suite d’octets produite par le tokenizer du modèle. Les API LLM comptent, limitent et facturent généralement l’usage en tokens.

[Concurrence (requêtes simultanées)](https://broadrouter.com/fr/glossary/concurrency/)

La concurrence est le nombre de requêtes qu’un client a en cours au même moment. Les API de LLM la plafonnent souvent par clé ou par forfait, indépendamment des requêtes par minute, car chaque requête ouverte occupe de la capacité GPU jusqu’à la fin de sa réponse.

[Paiement à l’usage (pay-as-you-go)](https://broadrouter.com/fr/glossary/pay-as-you-go/)

Le paiement à l’usage (pay-as-you-go) est un modèle tarifaire où vous ne payez que ce que vous consommez, mesuré par unité, comme les tokens, les requêtes ou les minutes d’audio, sans abonnement ni engagement minimal. La plupart des API LLM facturent ainsi, à partir d’un solde prépayé ou d’une facture périodique.

[Limite de débit (rate limit)](https://broadrouter.com/fr/glossary/rate-limit/)

Une limite de débit (rate limit) est un plafond qu’une API impose à l’usage d’un client sur une période, par exemple en requêtes ou en tokens par minute. Les requêtes au-delà sont refusées, généralement avec HTTP 429 Too Many Requests, jusqu’à ce que l’usage repasse sous la limite.

[Sous-agent (subagent)](https://broadrouter.com/fr/glossary/subagent/)

Un sous-agent est un agent distinct que l’agent principal lance pour traiter une tâche ciblée. Il s’exécute avec sa propre fenêtre de contexte, son prompt système et ses accès aux outils, fait le travail et ne renvoie qu’un résultat ou un résumé à l’agent principal, ce qui garde la conversation principale légère.

[Agent de code IA (AI coding agent)](https://broadrouter.com/fr/glossary/coding-agent/)

Un agent de code IA est un outil logiciel dans lequel un modèle de langage travaille en boucle sur une base de code : il lit des fichiers, les modifie, lance des commandes comme les tests, lit la sortie et décide de l’étape suivante jusqu’à ce que la tâche soit terminée ou qu’une limite soit atteinte.

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

L’API Chat Completions est l’endpoint HTTP d’OpenAI, POST /v1/chat/completions, qui reçoit un nom de modèle et une liste de messages associés à un rôle, et renvoie le message suivant du modèle. Sa forme de requête et de réponse est devenue le format commun que reprennent les fournisseurs et SDK compatibles OpenAI.

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

## Guides associés

-   [Utiliser Cline avec BroadNet Inference (fournisseur OpenAI Compatible)](https://broadrouter.com/fr/guides/cline-openai-compatible/)
-   [Comment fonctionnent les forfaits API LLM illimités pour agents](https://broadrouter.com/fr/guides/unlimited-llm-api-sessions/)
-   [Pourquoi un modèle de raisonnement renvoie une réponse vide](https://broadrouter.com/fr/guides/reasoning-tokens-empty-response/)
-   [Utiliser le Vercel AI SDK avec BroadNet Inference](https://broadrouter.com/fr/guides/vercel-ai-sdk-openai-compatible/)
-   [Tous les outils compatibles avec BroadNet Inference (en anglais)](https://broadrouter.com/integrations/) : SDK, agents de code, interfaces de chat et outils d’automatisation, avec les réglages exacts pour chacun

Essayez-le sur votre vraie charge de travail. Les nouveaux comptes démarrent avec USD 5 de crédit pour Gemma et transcription. DeepSeek, GLM et Qwen3.8 nécessitent une recharge.

[Commencer](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-opencode-custom-provider&utm_content=page-cta) ·

**Sources**

-   [Documentation d’opencode, Providers (fournisseur personnalisé) (consultée le 2026-11-14)](https://opencode.ai/docs/providers/)
-   [Documentation d’opencode, Models (alias, capacités, limites) (consultée le 2026-11-14)](https://opencode.ai/docs/models/)
-   [Documentation d’opencode, emplacements de configuration (consultée le 2026-11-14)](https://opencode.ai/docs/config/)
-   [Documentation d’opencode, migration depuis la V1 (consultée le 2026-11-14)](https://opencode.ai/docs/migrate-v1/)
-   [Référence de l’API de BroadNet Inference (en anglais)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=fr-guides-opencode-custom-provider&utm_content=sources)
