カスタムエンドポイント

LibreChatは、OpenAI API互換サービスをカスタムendpointとしてサポートしています。また、provider: "anthropic" を指定することで、Anthropic互換のカスタムendpointもサポートしています。endpointの設定は librechat.yaml で行い、APIキーは .env に保存し、Dockerデプロイメントの場合は docker-compose.override.yml を介して設定をマウントします。

Step 1. librechat.yaml をマウントする (Docker のみ)

Dockerユーザーは、コンテナが読み取れるように librechat.yaml をボリュームとしてマウントする必要があります。Dockerを使用せずにLibreChatをローカルで実行している場合は、この手順をスキップしてください。

cp docker-compose.override.yml.example docker-compose.override.yml

docker-compose.override.yml を編集し、ボリュームマウントのコメントアウトが解除されていることを確認してください：

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

詳細はこちら: Docker Override Guide

ステップ 2. librechat.yaml の設定

プロジェクトのルートディレクトリに librechat.yaml ファイルを作成し（存在しない場合）、endpoint の設定を追加してください。詳細なセットアップ手順については、librechat.yaml ガイド を参照してください。

以下は、OpenRouter、Ollama、および Anthropic 互換ゲートウェイを使用した例です：

version: 1.3.13
cache: true
endpoints:
  custom:
    - name: 'OpenRouter'
      apiKey: '${OPENROUTER_KEY}'
      baseURL: 'https://openrouter.ai/api/v1'
      models:
        default: ['meta-llama/llama-3-70b-instruct']
        fetch: true
      titleConvo: true
      titleModel: 'meta-llama/llama-3-70b-instruct'
      dropParams: ['stop']
      modelDisplayLabel: 'OpenRouter'
    - name: 'Ollama'
      apiKey: 'ollama'
      baseURL: 'http://host.docker.internal:11434/v1/'
      models:
        default: ['llama3:latest', 'command-r', 'mixtral', 'phi3']
        fetch: true
      titleConvo: true
      titleModel: 'current_model'
    - name: 'Claude-Compatible'
      provider: 'anthropic'
      apiKey: '${ANTHROPIC_API_KEY}'
      baseURL: 'https://api.anthropic.com'
      headers:
        anthropic-version: '2023-06-01'
      models:
        default: ['claude-sonnet-4-5']
        fetch: false
      titleConvo: true
      titleModel: 'claude-sonnet-4-5'

互換性のあるすべてのプロバイダーについては、AI Endpoints セクションを参照してください。フィールドの完全なリファレンスについては、Custom Endpoint Object Structure を参照してください。

Step 3. 環境変数の設定

librechat.yaml で参照されている API キーを .env ファイルに追加します：

OPENROUTER_KEY=your_openrouter_api_key

librechat.yaml 内の各 ${VARIABLE_NAME} には、.env 内に対応するエントリが必要です。

Step 4. 再起動と確認

設定ファイルを編集した後は、変更を反映させるためにLibreChatを再起動する必要があります。

docker compose down && docker compose up -d

ブラウザでLibreChatを開きます。カスタムendpointがendpointセレクターのドロップダウンに表示されるはずです。

docker compose logs api

OpenRouter が表示されない場合

OpenRouterに関しては、特に以下の3つのファイルのチェーンを確認してください：

1. .env には OPENROUTER_KEY=... が含まれています。
2. librechat.yaml の OpenRouter カスタム endpoint 配下には apiKey: "${OPENROUTER_KEY}" が設定されています
3. Dockerユーザーは docker-compose.override.yml で librechat.yaml をマウントしました。

次に以下で再起動します：

docker compose down && docker compose up -d

endpointが表示されているにもかかわらず 402 Payment Required が返される場合、リクエストはOpenRouterに正常に到達しています。この問題は通常、OpenRouter上のアカウントクレジット、請求、またはモデルの利用可能性に関連しています。

次のステップ