---
title: "goose で OpenAI 互換のカスタムプロバイダーを設定 | BroadRouter"
description: "AI エージェント goose を、OpenAI Compatible のカスタムプロバイダーとして BroadNet Inference に接続します。goose Desktop、goose configure、JSON ファイルのどれでも設定できます。"
url: https://broadrouter.com/ja/guides/goose-custom-provider/
lang: ja
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

このページは英語の原文を AI の支援を受けて翻訳したものです。[英語の原文を読む](https://broadrouter.com/guides/goose-custom-provider/)（2026-11-16 更新）。

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

更新日 2026-11-16

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 のプロバイダーのドキュメント](https://goose-docs.ai/docs/getting-started/providers/)に従っています。

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\`）。

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

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

```bash
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 の[料金ページ](https://broadrouter.com/ja/pricing/)から取り、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 では、推論が出力の上限に含まれます。[回答が空で返ってくる理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)。
-   **429。** 従量課金のキーでは 1 分あたり 30 リクエスト、処理中のリクエストは同時に 4 個までです。[エラーとリトライ](https://broadrouter.com/ja/guides/errors-and-retries/)を参照してください。
-   **1 つのプランのキーで 2 つの goose セッションを使うと、リクエストが待たされるか失敗する。** [プランのセッション](https://broadrouter.com/ja/guides/unlimited-llm-api-sessions/)は同時に 1 リクエストしか処理しないので、goose セッションごとに別のセッションを用意してください。

## このガイドの用語

[AI エージェント（AI agent）](https://broadrouter.com/ja/glossary/agent/)

AI エージェントとは、言語モデルが目標に向けて自分で手順を決めるシステムです。どのツールを呼ぶかを決め、結果を読み、最終回答を出すか上限に達するまで繰り返します。決まった箇所でモデルを呼ぶ固定のスクリプトは、ふつうワークフローと呼ばれます。

[トークン（token）](https://broadrouter.com/ja/glossary/token/)

トークンとは、言語モデルが読み書きするテキストの単位です。モデルのトークナイザーが作る単語、単語の一部、句読点、バイト列のいずれかにあたります。LLM API は利用量をトークンで数え、上限を設け、通常はトークン単位で課金します。

[API キー（API key）](https://broadrouter.com/ja/glossary/api-key/)

API キーとは、API を呼び出すクライアントを識別し、認可するための秘密の文字列です。LLM API では通常 Authorization: Bearer ヘッダーで送り、キーを持つ人は誰でも、そのキーの所有アカウントに課金されるリクエストを送れます。

[ストリーミング（streaming）](https://broadrouter.com/ja/glossary/streaming/)

ストリーミングとは、言語モデルの応答を最後にまとめて返すのではなく、生成中に小さなチャンクに分けて返す方式です。OpenAI 互換 API では、リクエストで stream を true にすると Server-Sent Events（SSE）でストリーミングされます。

[ツール呼び出し（Function Calling、tool calling）](https://broadrouter.com/ja/glossary/tool-calling/)

ツール呼び出し（Function Calling とも呼ばれます）とは、開発者が定義した関数の実行を求める構造化されたリクエストを、モデルが JSON の引数付きで返す LLM API の機能です。関数を実行して結果を返すのはアプリケーションで、モデル自身がコードを実行することはありません。

[従量課金（pay-as-you-go）](https://broadrouter.com/ja/glossary/pay-as-you-go/)

従量課金とは、使った分だけを支払う料金体系です。トークン、リクエスト、音声の分数などの単位で計測され、サブスクリプションや最低利用額はありません。多くの LLM API はこの方式で、前払いの残高か定期的な請求書から支払います。

[Chat Completions API（チャット補完 API）](https://broadrouter.com/ja/glossary/chat-completions-api/)

Chat Completions API とは、OpenAI の HTTP エンドポイント POST /v1/chat/completions で、モデル名とロール付きメッセージのリストを受け取り、モデルの次のメッセージを返します。そのリクエストと応答の形は、OpenAI 互換のプロバイダーや SDK が使う共通形式になりました。

[max\_tokens（最大出力トークン数）](https://broadrouter.com/ja/glossary/max-tokens/)

max\_tokens とは、モデルが 1 回の応答で生成できるトークン数の上限を決める LLM API のパラメーターです。生成が上限に達すると止まり、応答は途中で打ち切られたものとして、たとえば finish\_reason が "length" になります。

## よくある質問

### 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 で指定した環境変数を読み込みます。

## 関連ガイド

-   [Kilo Code で BroadNet Inference を使う（OpenAI Compatible プロバイダー）](https://broadrouter.com/ja/guides/kilo-code-openai-compatible/)
-   [opencode に BroadNet Inference をカスタムプロバイダーとして追加する](https://broadrouter.com/ja/guides/opencode-custom-provider/)
-   [エージェント向け無制限 LLM API プランのしくみ](https://broadrouter.com/ja/guides/unlimited-llm-api-sessions/)
-   [BroadNet Inference のエラーコードとリトライすべき場合](https://broadrouter.com/ja/guides/errors-and-retries/)
-   [BroadNet Inference で使えるすべてのツール（英語）](https://broadrouter.com/integrations/)：SDK、コーディングエージェント、チャット UI、自動化ツールと、それぞれの正確な設定

実際のワークロードで試してください。新規アカウントには US$5 の初回クレジットがあり、Gemma、文字起こし に使えます。DeepSeek、GLM、Qwen3.8 はチャージが必要です。

[始める](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-goose-custom-provider&utm_content=page-cta) ·

**出典**

-   [goose ドキュメント：Model providers と Configure Custom Provider（2026-11-15 確認）](https://goose-docs.ai/docs/getting-started/providers/)
-   [GitHub の goose（aaif-goose/goose）、最新は v1.59.1（2026-11-15 確認）](https://github.com/aaif-goose/goose)
-   [BroadNet Inference API リファレンス（2026-11-15 確認）（英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-goose-custom-provider&utm_content=sources)
