BroadRouter

Ajouter BroadNet Inference à goose comme fournisseur personnalisé

Mis à jour

Dans goose, ajoutez un fournisseur personnalisé de type OpenAI Compatible, avec l’API URL https://inference.broadnet.ai/v1/chat/completions, votre clé BroadNet et des modèles comme broadnet/glm-5.3. Passez par le bouton Add Custom Provider de goose Desktop, par goose configure dans le terminal ou par un fichier JSON dans ~/.config/goose/custom_providers/. goose s’appuie sur l’appel d’outils : commencez avec GLM 5.3 ou Qwen3.8 27B.

goose est un agent IA open source doté d’une application de bureau et d’une CLI. Les services non intégrés s’ajoutent comme fournisseurs personnalisés, et goose prend en charge ceux qui sont compatibles OpenAI. BroadNet Inference sert des chat completions standard et fonctionne donc ainsi. BroadRouter est le site de BroadNet ; les étapes suivent la documentation des fournisseurs de goose dans sa version pour goose 1.59.

La documentation de goose prévient qu’il « extensively uses tool calling » (traduction : fait un usage intensif de l’appel d’outils) et qu’un modèle qui en est dépourvu peut seulement discuter, toutes extensions désactivées. BroadNet indique l’appel d’outils pour GLM 5.3 et Qwen3.8 27B : prenez l’un des deux pour le travail d’agent.

Option 1 : goose Desktop

  1. Ouvrez la barre latérale, cliquez sur Settings, puis sur l’onglet Models.

  2. Cliquez sur Configure providers, puis sur Add Custom Provider en bas.

  3. Renseignez les champs :

    Champ Valeur
    Provider Type OpenAI Compatible
    Display Name BroadNet Inference
    API URL https://inference.broadnet.ai/v1/chat/completions
    API Key votre clé BroadNet
    Available Models broadnet/glm-5.3, broadnet/qwen3.8-27b
    Streaming Support activé
  4. Cliquez sur Create Provider, puis sélectionnez ce fournisseur et un modèle.

Option 2 : goose CLI

Lancez goose configure, choisissez Custom Providers, puis Add A Custom Provider, et répondez aux questions avec les mêmes valeurs : type d’API OpenAI Compatible, l’API URL ci-dessus, authentification Yes avec une clé d’API statique, la liste des modèles séparés par des virgules, et le streaming activé.

Option 3 : un fichier JSON

Créez ~/.config/goose/custom_providers/broadnet.json (sous Windows, %APPDATA%\Block\goose\config\custom_providers\) :

{
  "name": "broadnet",
  "engine": "openai",
  "display_name": "BroadNet Inference",
  "description": "BroadNet Inference, OpenAI-compatible",
  "api_key_env": "BROADNET_API_KEY",
  "base_url": "https://inference.broadnet.ai/v1/chat/completions",
  "models": [
    { "name": "broadnet/glm-5.3", "context_limit": 1048576 },
    { "name": "broadnet/qwen3.8-27b", "context_limit": 262144 },
    { "name": "broadnet/deepseek-v4.1-flash", "context_limit": 1048576 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

Puis démarrez une session avec ce fournisseur :

export BROADNET_API_KEY='your-broadnet-key'
goose session start --provider broadnet

Le fichier peut aller dans un dépôt partagé avec votre équipe, puisque la clé reste dans l’environnement.

Tester

Commencez par une question simple, comme « what can you do? » (traduction : « que sais-tu faire ? »). Une réponse signifie que la connexion fonctionne. Demandez ensuite quelque chose qui nécessite l’une de vos extensions activées. Si goose appelle l’outil, l’appel d’outils fonctionne aussi. S’il se contente de répondre en texte sans jamais appeler d’outil, passez à broadnet/glm-5.3.

Les prix dans goose

goose peut estimer le coût si chaque modèle du fichier JSON comporte input_token_cost et output_token_cost en USD par token. Prenez les chiffres sur la page des prix de BroadNet et divisez le prix par million par 1 000 000. Sans ces deux champs, goose se rabat sur les prix de son propre catalogue, qui peuvent différer de ceux de BroadNet.

Dépannage

  • 401. La clé est erronée, a expiré ou a épuisé son allocation, ou BROADNET_API_KEY n’est pas défini dans le shell qui lance goose.
  • 404. Vérifiez l’API URL : elle doit être https://inference.broadnet.ai/v1/chat/completions. Vérifiez que l’ID de modèle correspond exactement à celui de BroadNet. 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, et le contexte de 32 768 tokens de Gemma est juste pour du travail d’agent.
  • Réponses vides. Sur DeepSeek V4.1 Flash, GLM 5.3 et Qwen3.8 27B, le raisonnement est décompté de la limite de sortie. Pourquoi les réponses reviennent vides.
  • 429. Une clé à l’usage autorise 30 requêtes par minute et 4 requêtes en cours. Voir codes d’erreur et nouvelles tentatives.
  • Requêtes en attente ou en échec avec deux sessions goose sur une même clé de forfait. Une session de forfait traite une seule requête à la fois : donnez à chaque session goose la sienne.

Questions fréquentes

L’API URL de goose doit-elle se terminer par /v1 ou par /v1/chat/completions ?

L’exemple de fournisseur personnalisé de goose utilise l’URL complète de chat completions : utilisez donc https://inference.broadnet.ai/v1/chat/completions. Cela maintient aussi goose sur chat completions, le format que sert BroadNet.

Quel modèle BroadNet fonctionne le mieux avec goose ?

GLM 5.3 (broadnet/glm-5.3). Selon sa documentation, goose fait un usage intensif de l’appel d’outils, et BroadNet n’indique les outils que pour GLM 5.3 et Qwen3.8 27B.

Puis-je utiliser goose avec le forfait illimité de BroadNet ?

Les forfaits ne couvrent que DeepSeek V4.1 Flash, et la documentation de BroadNet n’indique pas l’appel d’outils pour ce modèle. Selon goose, un modèle sans appel d’outils peut seulement discuter, extensions désactivées : testez donc avant d’acheter un mois.

Où goose conserve-t-il la clé d’API ?

Dans le trousseau du système, ou dans secrets.yaml si le keyring est désactivé. Avec un fichier JSON, goose lit plutôt la variable nommée dans api_key_env.

Lire en MarkdownDemander à ChatGPTDemander à ClaudeDemander à Perplexity