BroadRouter
始める

opencode に BroadNet Inference をカスタムプロバイダーとして追加する

更新日

opencode.jsonc の providers の下に broadnet のエントリーを追加し、package を @opencode/ai/providers/openai-compatible、settings.baseURL を https://inference.broadnet.ai/v1、env を BROADNET_API_KEY にします。短いモデルキーを modelID で broadnet/glm-5.3 などの BroadNet の ID に対応づけ、/models でモデルを選びます。npm @ai-sdk/openai-compatible と options.baseURL を使う古い V1 の設定もそのまま動きます。

opencode は、ターミナルで動くオープンソースのコーディングエージェントです。組み込みのカタログにないプロバイダーは、opencode.jsonc でカスタムプロバイダーとして追加します。BroadNet Inference は OpenAI のチャット補完形式で通信するので、opencode の OpenAI 互換ランタイムパッケージを使います。このガイドは opencode の現行(V2)のドキュメントに従っています。

セットアップ

  1. opencode を起動するシェルでキーを export します。
export BROADNET_API_KEY='your-broadnet-key'
  1. 設定ファイルを作成します。 プロジェクト内に opencode.jsonc として置くか、どこでも使えるように ~/.config/opencode/opencode.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 }
        }
      }
    }
  }
}
  1. opencode を起動し、/models でモデルを選びます。 参照の形式は broadnet/<マップのキー> で、たとえば broadnet/glm-5.3 です。opencode は modelID の値を BroadNet に送ります。

設定ファイルはマージされます。opencode はまずグローバルのファイルを適用し、次にカレントディレクトリから上にたどって見つかったプロジェクトのファイルを(遠いものから順に)適用し、最後に .opencode/ の設定を適用します。そのため、プロジェクトのファイルでグローバルのプロバイダー設定を上書きできます。会社で管理されたシステム設定を使っている場合は、それが両方より優先されます。キーはファイルではなく環境変数に置けば、設定ファイルをバージョン管理に入れられます。

エイリアスを使う理由

BroadNet の ID にはもともとスラッシュが含まれています(broadnet/glm-5.3)。models のマップのキーは opencode が表示・選択に使う名前で、modelID は実際に送る値です。短いキーにしておくと参照が読みやすくなります。

capabilities と limit は自分で設定してください。カタログにないモデルについて、opencode は JSON のツール対応、テキストと画像の入力、200,000 トークンのコンテキスト、32,000 の出力トークンを仮定します。ドキュメントではこれらを検出した値ではなく、フォールバックの仮定と説明しています。上の output の 16000 は BroadNet の上限ではなく私たちの提案で、推論の余地を残すための値です。

古い V1 の設定

opencode V2 は V1 の形式も読めるので、次のような既存のブロックはそのまま動きます。

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

ネイティブの V2 形式では、provider が providers に、npm が package に変わり(AI SDK のパッケージを使い続けるなら aisdk:@ai-sdk/openai-compatible)、options.baseURL と options.apiKey は settings の下に移ります。各フィールドの対応は opencode の V1 移行ガイドにあります。

どのモデルを選ぶか

タスク モデル 備考
ツールを使うエージェント型コーディング GLM 5.3 ツールと構造化出力の記載あり。100 万トークンのコンテキスト
スクリーンショット、アラビア語 Qwen3.8 27B ツールと画像。262K コンテキスト
一日中のセッション、定額 DeepSeek V4.1 Flash 無制限プラン。BroadNet はツールを記載していない

opencode はツール呼び出しに頼っています。BroadNet のドキュメントには DeepSeek V4.1 Flash のツール呼び出しの記載がないため、設定ではテストが必要な仮定として扱っています。Full Moon の 1 か月($60)を買う前に、Meteor の 1 時間($1)で実際のタスクを試してください。

トラブルシューティング

  • 401。 BROADNET_API_KEY のキーが間違っている、期限切れ、または従量課金の利用枠を使い切っています。opencode を動かすプロセスでこの変数が設定されているか確認してください。
  • モデルが見つからない、または拒否される。 マップのキー(broadnet/glm-5.3)を選び、modelID が BroadNet の ID と完全に一致しているか確認してください。参照は大文字と小文字を区別します。有料モデルにはチャージが必要です。$5 のクレジットで使えるのは broadnet/gemma-4-26b-a4b と 2 つの Transcribe モデルだけです。
  • 回答が空。 limit.output を上げてください。回答が空になる理由。
  • 429。 従量課金のキーは毎分 30 リクエスト、同時 4 リクエストまでです。リトライもカウントされます。エラーとリトライを参照してください。
  • プランでサブエージェントを使う場合。 プランのセッションは 1 つにつき一度に 1 リクエストしか処理しないので、並列のサブエージェントは、それぞれに専用のセッションがない限り順番待ちになります。

よくある質問

opencode で BroadNet のモデルが見つからないのはなぜですか?

opencode はモデルの参照を「プロバイダー/マップのキー」として解決し、ID は大文字と小文字を区別します。下の設定なら broadnet/glm-5.3 を選びます。このうち glm-5.3 がマップのキーです。modelID の値は BroadNet に送られる内容にすぎません。

設定で provider と npm(@ai-sdk/openai-compatible)を使っていますが、間違いですか?

いいえ。それは V1 の形式で、opencode の移行ガイドによれば引き続きサポートされています。ネイティブの V2 形式では、provider が providers に、npm が package(aisdk:@ai-sdk/openai-compatible)に、options.baseURL が settings.baseURL に変わります。

opencode の返答が空になるのはなぜですか?

モデルが出力の上限を推論(reasoning)に使い切っています。そのモデルの limit.output を上げてください。BroadNet では推論は max_tokens に含まれます。

Markdown で読むChatGPT に聞くClaude に聞くPerplexity に聞く