BroadRouter

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

更新日

goose でタイプ OpenAI Compatible のカスタムプロバイダーを追加し、API URL に https://inference.broadnet.ai/v1/chat/completions、BroadNet のキー、broadnet/glm-5.3 などの利用可能なモデルを設定します。goose Desktop の Add Custom Provider ボタン、ターミナルの goose configure、~/.config/goose/custom_providers/ の JSON ファイルのいずれかを使います。goose はツール呼び出しに頼るので、まず GLM 5.3 か Qwen3.8 27B を使ってください。

goose は、デスクトップアプリと CLI を備えたオープンソースの AI エージェントです。組み込まれていないサービスはカスタムプロバイダーとして追加でき、OpenAI 互換のプロバイダーにも対応しています。BroadNet Inference は標準的な chat completions を提供しているので、この方法で使えます。BroadRouter は BroadNet 自身のサイトです。手順は goose 1.59 時点の goose のプロバイダーのドキュメントに従っています。

goose のドキュメントは、goose が「extensively uses tool calling」(訳:ツール呼び出しを多用する)こと、そしてツール呼び出しのないモデルはすべての拡張機能を無効にした状態でしかチャットできないことを注意しています。BroadNet がツール呼び出しを掲載しているのは GLM 5.3 と Qwen3.8 27B なので、エージェント作業にはどちらかを使ってください。

方法 1:goose Desktop

  1. サイドバーを開いて Settings をクリックし、Models タブを開きます。

  2. Configure providers をクリックし、下部の Add Custom Provider をクリックします。

  3. 詳細を入力します。

    フィールド 値
    Provider Type OpenAI Compatible
    Display Name BroadNet Inference
    API URL https://inference.broadnet.ai/v1/chat/completions
    API Key BroadNet のキー
    Available Models broadnet/glm-5.3, broadnet/qwen3.8-27b
    Streaming Support オン
  4. Create Provider をクリックし、作成したプロバイダーとモデルを選びます。

方法 2:goose CLI

goose configure を実行し、Custom Providers、続いて Add A Custom Provider を選んで、プロンプトに同じ値を答えます。API タイプは OpenAI Compatible、API URL は上記のもの、認証は Yes で静的な API キー、モデルはカンマ区切りの一覧、ストリーミングはオンです。

方法 3:JSON ファイル

~/.config/goose/custom_providers/broadnet.json を作成します(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
}

次に、このプロバイダーでセッションを開始します。

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

キーは環境変数に置かれるので、このファイルはリポジトリに入れてチームで共有できます。

テストする

まず「what can you do?」(何ができる?)のような簡単な質問をします。答えが返れば接続は正常です。次に、有効にしている拡張機能が必要な作業を頼みます。goose がツールを呼び出せば、ツール呼び出しも動いています。テキストで答えるだけでツールを一度も呼ばない場合は、broadnet/glm-5.3 に切り替えてください。

goose での料金表示

JSON ファイルの各モデルに、トークンあたりの USD 単価として input_token_cost と output_token_cost を書いておくと、goose がコストを見積もれます。数値は BroadNet の料金ページから取り、100 万トークンあたりの価格を 1,000,000 で割ってください。両方のフィールドがないと、goose は自前のカタログの料金を使います。これは BroadNet の料金と一致しない場合があります。

トラブルシューティング

  • 401。 キーが間違っている、期限切れ、利用枠を使い切っている、または goose を起動するシェルで BROADNET_API_KEY が設定されていません。
  • 404。 API URL を確認してください。https://inference.broadnet.ai/v1/chat/completions になっている必要があります。モデル ID が BroadNet のものと完全に一致しているかも確認してください。有料モデルにはチャージが必要です。$5 のクレジットで使えるのは broadnet/gemma-4-26b-a4b と 2 つの Transcribe モデルだけで、Gemma のコンテキスト 32,768 トークンはエージェント作業には小さめです。
  • 回答が空になる。 DeepSeek V4.1 Flash、GLM 5.3、Qwen3.8 27B では、推論が出力の上限に含まれます。回答が空で返ってくる理由。
  • 429。 従量課金のキーでは 1 分あたり 30 リクエスト、処理中のリクエストは同時に 4 個までです。エラーとリトライを参照してください。
  • 1 つのプランのキーで 2 つの goose セッションを使うと、リクエストが待たされるか失敗する。 プランのセッションは同時に 1 リクエストしか処理しないので、goose セッションごとに別のセッションを用意してください。

よくある質問

goose の API URL は /v1 と /v1/chat/completions のどちらで終わるべきですか?

goose 自身のカスタムプロバイダーの例では chat completions の完全な URL を使っているので、https://inference.broadnet.ai/v1/chat/completions にしてください。こうすると goose が常に chat completions を使うことにもなり、BroadNet が提供しているのはまさにそれです。

goose に最も合う BroadNet のモデルはどれですか?

GLM 5.3(broadnet/glm-5.3)です。goose のドキュメントにはツール呼び出しを多用すると書かれており、BroadNet がツール対応として掲載しているのは GLM 5.3 と Qwen3.8 27B だけです。

goose で BroadNet の無制限プランを使えますか?

プランの対象は DeepSeek V4.1 Flash だけで、BroadNet のドキュメントにはこのモデルのツール呼び出しの記載がありません。goose によると、ツール呼び出しのないモデルは拡張機能をすべて無効にした状態でのチャットしかできないので、1 か月分を購入する前にテストしてください。

goose は API キーをどこに保存しますか?

システムのキーチェーンに保存します。keyring がオフの場合は secrets.yaml です。JSON ファイルで設定した場合は、代わりに api_key_env で指定した環境変数を読み込みます。

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