---
title: "LibreChat の librechat.yaml でカスタムエンドポイント設定 | BroadRouter"
description: "librechat.yaml で BroadNet Inference を LibreChat の OpenAI 互換カスタムエンドポイントとして追加します。.env のキー、モデル一覧、タイトル用モデル、よくある問題の対処法も解説します。"
url: https://broadrouter.com/ja/guides/librechat-custom-endpoint/
lang: ja
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

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

# LibreChat に BroadNet Inference をカスタムエンドポイントとして追加する

更新日 2026-11-16

librechat.yaml の endpoints.custom に、name を BroadNet、apiKey を BROADNET\_API\_KEY などの環境変数の参照、baseURL を https://inference.broadnet.ai/v1、models.default に broadnet/glm-5.3 などの BroadNet の ID を並べたエントリーを追加します。キーは .env に書き、Docker ではファイルをコンテナにマウントして LibreChat を再起動します。/chat/completions は LibreChat がベース URL に自動で付けます。

LibreChat は、OpenAI 互換のサービスを**カスタムエンドポイント**（custom endpoints）として使えるオープンソースのチャットアプリです。エンドポイントは `librechat.yaml` で定義し、キーは `.env` に置き、Docker の場合は YAML ファイルをコンテナにマウントします。BroadRouter は BroadNet 自身のサイトです。手順は [LibreChat のカスタムエンドポイントガイド](https://www.librechat.ai/docs/quick_start/custom_endpoints)に沿っています。

## 設定手順

1.  **librechat.yaml をマウントします（Docker のみ）。** `docker-compose.override.yml.example` を `docker-compose.override.yml` にコピーし、volume が有効になっていることを確認します。

```yaml
services:
  api:
    volumes:
      - type: bind
        source: ./librechat.yaml
        target: /app/librechat.yaml
```

2.  プロジェクトのルートにある `librechat.yaml` の `endpoints.custom` に、**エンドポイントを追加します。**

```yaml
endpoints:
  custom:
    - name: 'BroadNet'
      apiKey: '${BROADNET_API_KEY}'
      baseURL: 'https://inference.broadnet.ai/v1'
      models:
        default:
          - 'broadnet/glm-5.3'
          - 'broadnet/qwen3.8-27b'
          - 'broadnet/deepseek-v4.1-flash'
          - 'broadnet/gemma-4-26b-a4b'
        fetch: false
      titleConvo: true
      titleModel: 'broadnet/gemma-4-26b-a4b'
      modelDisplayLabel: 'BroadNet'
```

`version` など、ファイルにすでにあるトップレベルのキーは残してください。

3.  **`.env` にキーを設定します。**

```bash
BROADNET_API_KEY=your-broadnet-key
```

4.  **LibreChat を再起動します。** Docker なら `docker compose down && docker compose up -d`、ローカルにインストールした場合は `npm run backend` で再起動します。これで BroadNet がエンドポイントのセレクターに表示されます。

## フィールドの補足

-   **baseURL。** `/chat/completions` は LibreChat が自分で付けるので、上のように `/v1` までのルートを指定します。`directEndpoint: true` は設定しないでください。これは baseURL がすでに completions の完全な URL になっている場合のオプションです。
-   **fetch: false。** これは LibreChat のデフォルト値ですが、選択を明示するために書いています。BroadNet のドキュメントでは `GET /v1/models` は監視ツール向けの公開カタログのメタデータと説明されているため、`default` にモデルを列挙するほうが確実です。
-   **titleModel。** LibreChat は、チャットごとに追加のリクエストを送ってタイトルを付けます。推論をしない小さく安いモデルなら、この呼び出しを短く済ませられます。BroadNet のドキュメントでは Gemma 4 VL 26B に推論は記載されていません。
-   **user\_provided。** 各ユーザーに UI で自分の BroadNet キーを入力させたい場合は、`apiKey: 'user_provided'` を設定します。LibreChat はユーザーごとのキーを暗号化して保存し、初めてそのエンドポイントを選んだときに入力を求めます。
-   **一意な名前。** 大文字小文字を無視して同じ名前のエンドポイントが 2 つあると、2 つ目が 1 つ目を黙って置き換えます。すでに BroadNet という名前のエントリーがある場合は、どちらかの名前を変えてください。
-   **キーを直接書かない。** LibreChat のドキュメントは、キーを `librechat.yaml` に直接書くよりも `${VAR}` 形式の参照を推奨しています。直接書くと、キーが平文のままファイルに残ります。

## モデルの選び方

| 用途 | モデル |
| --- | --- |
| 通常のチャット、ツール、JSON | [GLM 5.3](https://broadrouter.com/ja/models/glm-5.3/) |
| 画像とアラビア語 | [Qwen3.8 27B](https://broadrouter.com/ja/models/qwen3.8-27b/) |
| 長い文書、1M コンテキスト | [DeepSeek V4.1 Flash](https://broadrouter.com/ja/models/deepseek-v4.1-flash/) |
| タイトルと短い返答 | [BroadNet Gemma 4 VL 26B](https://broadrouter.com/ja/models/gemma-4-vl-26b/) |

これらのモデルのうち $5 の初回クレジットで動かせるのは Gemma 4 VL 26B だけです。このクレジットは 2 つの Transcribe モデルにも使えます。料金は[料金ページ](https://broadrouter.com/ja/pricing/)で比較できます。

## トラブルシューティング

-   **エンドポイントが表示されない。** `name`、`baseURL`、`apiKey`、`models.default` の綴りが正しく、`endpoints.custom` の内側にインデントされているか確認してください。LibreChat は不完全なエントリーをログも出さずに無視します。Docker の場合は、`docker-compose.override.yml` の bind mount のコメントが外れているか確認してください。
-   **「Missing API Key for BroadNet」（訳：BroadNet の API キーがありません）。** `BROADNET_API_KEY` が `.env` にないか、LibreChat を再起動していません。エンドポイントは表示されたままで、エラーはメッセージを送ったときにだけ出ます。
-   **プロバイダーから 401 が返る。** キーが間違っている、期限切れ、または従量課金の利用枠を使い切っています。
-   **モデルのエラー。** 各 ID は `broadnet/` プレフィックスを含めて BroadNet の ID と完全に一致させてください。GLM 5.3、Qwen3.8 27B、DeepSeek V4.1 Flash にはチャージが必要です。
-   **返答が空になる。** DeepSeek V4.1 Flash、GLM 5.3、Qwen3.8 27B は先に推論し、推論も `max_tokens` に含まれます。LibreChat のパラメーターで最大出力を小さく設定している場合は上げてください。[回答が空で返ってくる理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)。
-   **ユーザーが多いと 429 になる。** 従量課金のキー 1 つで 1 分あたり 30 リクエスト、同時に 4 個までで、これをエンドポイントの全ユーザーで共有します。タイトル生成のリクエストも数に入ります。`user_provided` のキーにすると負荷を分散できます。[エラーとリトライ](https://broadrouter.com/ja/guides/errors-and-retries/)を参照してください。
-   **プランのキー。** [無制限プランのセッション](https://broadrouter.com/ja/guides/unlimited-llm-api-sessions/)は一度に 1 つのリクエストしか処理せず、共有もできないため、複数ユーザーで使う LibreChat には向きません。

## このガイドの用語

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

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

[ベース URL（base URL）](https://broadrouter.com/ja/glossary/base-url/)

ベース URL とは、https://api.example.com/v1 のような API の固定のルートアドレスで、クライアントが /chat/completions などのエンドポイントパスの前に付けます。OpenAI 互換の SDK では、API キーとモデル ID と一緒にベース URL を変えるだけで、同じコードを別のプロバイダーに向けられます。

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

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

[OpenAI 互換 API（OpenAI-compatible API）](https://broadrouter.com/ja/glossary/openai-compatible-api/)

OpenAI 互換 API とは、POST /v1/chat/completions など OpenAI API と同じリクエスト形式とレスポンス形式を受け付ける HTTP API です。OpenAI の SDK やツールは、ベース URL、API キー、モデル名を変えるだけで利用できます。

[プリペイドクレジット（prepaid credit）](https://broadrouter.com/ja/glossary/prepaid-credit/)

プリペイドクレジットとは、使用前に API アカウントに入金しておくお金です。リクエストごとに費用が残高から差し引かれ、残高がなくなると、チャージするまで従量課金のリクエストは止まります。支出は支払った額までに抑えられます。

[レート制限（rate limit）](https://broadrouter.com/ja/glossary/rate-limit/)

レート制限とは、1 分あたりのリクエスト数やトークン数など、一定時間内にクライアントが API を使える量に API 側が設ける上限です。上限を超えたリクエストは、使用量が下回るまで通常 HTTP 429 Too Many Requests で拒否されます。

[同時実行数（concurrency）](https://broadrouter.com/ja/glossary/concurrency/)

同時実行数（concurrency）とは、クライアントが同時に処理中にしているリクエストの数です。開いているリクエストは応答が終わるまで GPU の容量を占有するため、LLM API は毎分リクエスト数とは別に、キーやプランごとにこれを制限することがよくあります。

## よくある質問

### LibreChat に BroadNet のエンドポイントが表示されないのはなぜですか？

name、baseURL、apiKey、models.default のどれかが欠けているか綴りが間違っていると、LibreChat はエラーもログも出さずにそのカスタムエンドポイントを無視します。Docker の場合は、librechat.yaml が /app/librechat.yaml にマウントされているか、再起動したかも確認してください。

### ユーザーごとに自分の BroadNet キーを使わせられますか？

できます。apiKey を user\_provided にすると、各ユーザーが初めてそのエンドポイントを選んだときに LibreChat がキーの入力を求め、暗号化して保存します。

### LibreChat に「Missing API Key for BroadNet」と表示されるのはなぜですか？

apiKey で参照している変数が .env に設定されていません。エンドポイント自体はセレクターに表示され、エラーはメッセージを送ったときにだけ出ます。変数を追加して LibreChat を再起動してください。

### LibreChat の baseURL に /chat/completions を含めるべきですか？

いいえ。LibreChat はデフォルトで baseURL に /chat/completions を付け足します。https://inference.broadnet.ai/v1 を使ってください。directEndpoint を true にするのは、入力した URL がすでに completions エンドポイントの完全な URL である場合だけです。

## 関連ガイド

-   [Open WebUI を BroadNet Inference に接続する](https://broadrouter.com/ja/guides/open-webui-openai-api/)
-   [推論モデルが空の回答を返す理由](https://broadrouter.com/ja/guides/reasoning-tokens-empty-response/)
-   [BroadNet Inference のエラーコードとリトライすべき場合](https://broadrouter.com/ja/guides/errors-and-retries/)
-   [IP 許可リストで API キーを自社サーバーに限定する](https://broadrouter.com/ja/guides/api-keys-ip-allow-lists/)
-   [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-librechat-custom-endpoint&utm_content=page-cta) ·

**出典**

-   [LibreChat ドキュメント、Custom Endpoints クイックスタート（2026-11-14 確認）](https://www.librechat.ai/docs/quick_start/custom_endpoints)
-   [LibreChat ドキュメント、Custom Endpoint のオブジェクト構造（2026-11-14 確認）](https://www.librechat.ai/docs/configuration/librechat_yaml/object_structure/custom_endpoint)
-   [BroadNet Inference API リファレンス（2026-11-16 確認） （英語）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ja-guides-librechat-custom-endpoint&utm_content=sources)
