BroadRouter
Loslegen

BroadNet Inference als eigenen Provider in opencode einrichten

Aktualisiert

Legen Sie in opencode.jsonc unter providers einen Eintrag broadnet an, mit package @opencode/ai/providers/openai-compatible, settings.baseURL = https://inference.broadnet.ai/v1 und env = BROADNET_API_KEY. Ordnen Sie kurze Modell-Keys per modelID BroadNet-IDs wie broadnet/glm-5.3 zu und wählen Sie das Modell mit /models. Ältere V1-Konfigurationen mit npm @ai-sdk/openai-compatible und options.baseURL funktionieren weiterhin.

opencode ist ein Open-Source-Coding-Agent für das Terminal. Provider, die nicht in seinem eingebauten Katalog stehen, werden als eigene Provider (custom providers) in opencode.jsonc hinzugefügt. BroadNet Inference spricht das Chat-Completions-Format von OpenAI und nutzt daher das OpenAI-kompatible Runtime-Paket von opencode. Diese Anleitung folgt der aktuellen Dokumentation von opencode (V2).

Einrichtung

  1. Exportieren Sie Ihren Schlüssel in der Shell, aus der Sie opencode starten:
export BROADNET_API_KEY='your-broadnet-key'
  1. Konfiguration anlegen. Legen Sie sie als opencode.jsonc in Ihr Projekt oder nach ~/.config/opencode/opencode.jsonc, um sie überall zu nutzen.
{
  "$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. opencode starten und das Modell wählen mit /models. Die Referenz lautet broadnet/<map key>, zum Beispiel broadnet/glm-5.3. opencode sendet den Wert von modelID an BroadNet.

Konfigurationsdateien werden zusammengeführt. opencode wendet zuerst die globale Datei an, dann Projektdateien, die es vom aktuellen Verzeichnis aufwärts findet (die entfernteste zuerst), dann eine eventuelle .opencode/-Konfiguration. Eine Projektdatei kann also den globalen Provider überschreiben. Eine verwaltete Systemkonfiguration, falls Ihr Unternehmen eine nutzt, hat Vorrang vor beiden. Halten Sie den Schlüssel in der Umgebung, nicht in der Datei, damit die Konfiguration in die Versionsverwaltung darf.

Warum Aliase

BroadNet-IDs enthalten bereits einen Schrägstrich (broadnet/glm-5.3). Der Key in der Map models ist das, was opencode anzeigt und auswählt, und modelID ist das, was es sendet. Kurze Keys halten die Referenzen lesbar.

Setzen Sie capabilities und limit selbst. Für ein Modell außerhalb seines Katalogs nimmt opencode JSON-Tool-Unterstützung, Text- und Bildeingabe, 200.000 Token Kontext und 32.000 Ausgabe-Token an. Seine Dokumentation nennt das Fallback-Annahmen, keine erkannten Werte. Der output-Wert 16000 oben ist unser Vorschlag, kein Limit von BroadNet; er lässt Raum für Reasoning.

Ältere V1-Konfigurationen

opencode V2 liest das V1-Format weiterhin, ein bestehender Block wie dieser funktioniert also weiter:

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

In der nativen V2-Form wird provider zu providers, npm zu package (aisdk:@ai-sdk/openai-compatible, wenn Sie das AI-SDK-Paket behalten wollen), und options.baseURL und options.apiKey wandern unter settings. Die Migrationsanleitung von opencode für V1 ordnet jedes Feld zu.

Welches Modell passt

Aufgabe Modell Hinweise
Agentisches Coding mit Tools GLM 5.3 Tools und strukturierte Ausgabe gelistet; 1M Kontext
Screenshots, Arabisch Qwen3.8 27B Tools und Bilder; 262K Kontext
Ganztägige Sessions, Festpreis DeepSeek V4.1 Flash Unbegrenzte Pläne; Tools von BroadNet nicht gelistet

opencode ist auf Tool Calls angewiesen. Die Dokumentation von BroadNet listet Tool Calling für DeepSeek V4.1 Flash nicht, daher markiert die Konfiguration es als zu testende Annahme. Testen Sie eine echte Aufgabe mit einer Meteor-Stunde ($1), bevor Sie einen Full-Moon-Monat ($60) kaufen.

Fehlerbehebung

  • 401. Der Schlüssel in BROADNET_API_KEY ist falsch, abgelaufen oder das Pay-as-you-go-Kontingent ist aufgebraucht. Stellen Sie sicher, dass die Variable in dem Prozess gesetzt ist, der opencode ausführt.
  • Modell nicht gefunden oder abgelehnt. Wählen Sie den Map-Key (broadnet/glm-5.3) und prüfen Sie, ob modelID exakt der ID von BroadNet entspricht. Referenzen unterscheiden Groß- und Kleinschreibung. Kostenpflichtige Modelle erfordern eine Aufladung; das Guthaben von $5 deckt nur broadnet/gemma-4-26b-a4b und die beiden Transcribe-Modelle ab.
  • Leere Antworten. Erhöhen Sie limit.output. Warum Antworten leer zurückkommen.
  • 429. Pay-as-you-go-Schlüssel erlauben 30 Anfragen pro Minute und 4 gleichzeitig laufende. Retries zählen mit. Siehe Fehler und Retries.
  • Subagents in einem Plan. Jede Plan-Session verarbeitet jeweils eine Anfrage, parallele Subagents stehen also in der Warteschlange, sofern nicht jeder eine eigene Session hat.

Häufige Fragen

Warum findet opencode mein BroadNet-Modell nicht?

opencode löst die Referenz als Provider/Map-Key auf, und IDs unterscheiden Groß- und Kleinschreibung. Mit der Konfiguration unten wählen Sie broadnet/glm-5.3, wobei glm-5.3 der Map-Key ist. Der Wert von modelID ist nur das, was an BroadNet gesendet wird.

Meine Konfiguration nutzt provider und npm mit @ai-sdk/openai-compatible. Ist das falsch?

Nein. Das ist das V1-Format, und laut Migrationsanleitung von opencode wird es weiter unterstützt. Die native V2-Form benennt provider in providers um, npm in package (aisdk:@ai-sdk/openai-compatible) und options.baseURL in settings.baseURL.

Warum sind die Antworten in opencode leer?

Das Modell hat sein Ausgabebudget für Reasoning verbraucht. Erhöhen Sie limit.output für das Modell. Bei BroadNet zählt Reasoning zu max_tokens.

Als Markdown lesenChatGPT fragenClaude fragenPerplexity fragen