コンテンツにスキップ

OpenAI 互換 API を接続する

多くの AI サービスやサーバーは OpenAI と同じ API 形式 に対応しています。 atbridge.ai は、OpenAI 互換(カスタム URL) という 1 つのプロバイダー オプションでそのすべてに対応します。何かをインストールしたり、連携の対応を 待ったりする必要はありません。サービスの Base URL と API キー を入力 すれば、atbridge AIチャットはほかのプロバイダーと同じように使えます。

よくあるケース:

  • 自分のパソコンやサーバーで動かしているモデル: LM Studio、vLLM、 llama.cpp サーバー、LocalAI。
  • 会社が運用しているプロキシ: たとえば複数のプロバイダーの前段に置いた LiteLLM。
  • API ゲートウェイや再販業者: OpenAI 互換のエンドポイント経由でモデルを 利用できるもの。
  • Base URL: プロバイダーのドキュメントに記載された API のアドレス。OpenAI SDK が base_url と呼ぶ値と同じで、たとえば https://llm.example.com/v1 です。ドキュメントのとおりに貼り付けてください。atbridge.ai は末尾の /v1 が あってもなくても 受け付けます。
  • API キー: プロバイダーのダッシュボードで作成します。キーを確認しない ローカルサーバーなら、local のような任意の仮の値で構いません。

サービスは、Authorization: Bearer 認証に対応した 2 つの標準 OpenAI エンドポイントをサポートしている必要があります: /v1/chat/completions (チャット本体)と /v1/models(モデル一覧。atbridge.ai は接続の確認にも 使います)。ほぼすべての OpenAI 互換サービスとローカルサーバーが両方を 提供しています。

主なローカルサーバーと通常の Base URL(ご自身の環境で確認してください):

サーバー通常の Base URL
LM Studiohttp://localhost:1234/v1
vLLMhttp://localhost:8000/v1
llama.cpp serverhttp://localhost:8080/v1
LiteLLM proxyhttp://localhost:4000
  1. Thunderbird で atbridge 設定 を開きます: 歯車、または ツール → アドオンとテーマ → atbridge.ai → オプション( atbridge 拡張機能の設定を開く を参照)。 AI プロバイダー タブへ移動します。

  2. プロバイダー ドロップダウンで OpenAI 互換(カスタム URL) を選びます。

  3. Base URL を入力し、API キー にキーを貼り付けます。キーは このデバイス上で暗号化 され、atbridge.ai のサーバーに届くことはありません。

  4. 接続 をクリックします。atbridge.ai はモデル一覧を要求して、アドレスと キーをすぐに確認します。確認に成功するとステータスが緑の ✓ に変わります。 失敗した場合は何も保存されず、理由が表示されます。

atbridge AIチャット(Thunderbird の @b ボタン)を開き、モデル ドロップダウンからモデルを選びます。ここにはサービスが報告するモデルが表示 されます。ゲートウェイでは数百のモデルが並ぶこともあります。正確な名前で モデルを指定したい場合は、設定 → 優先する AI プロバイダーとモデル の カスタムモデル ID に入力してください。

OpenAI 互換プロバイダーでは、プロンプトと、AIチャットに渡したメール本文や 添付ファイルは、入力した Base URL に 送信されます。atbridge.ai はそれらを 中継も保存もしません。サービスを接続する前に、その運営者を信頼できるか確認し、 プライバシーとデータ保持の規約を読んでください。パソコンの外に出してはいけない メールには、ローカルサーバー(上の表)または Ollama を使ってください。

同じ接続をターミナルから行います。キーは標準入力から読み込まれるため、 シェルの履歴に残りません:

Terminal window
echo "$MY_API_KEY" | atbridge connect activate --provider openai-compatible \
--base-url https://llm.example.com/v1 --key-stdin
  • 404 または “not found”: Base URL が間違っています。プロバイダーの ドキュメントからもう一度コピーしてください。通常は /v1 で終わるアドレスです。
  • 401 または 403: キーが間違っている、期限切れである、またはそのモデルへの アクセス権がありません。
  • URL は正しいのに接続が失敗する: サービスがモデル一覧(/v1/models)を 提供していない可能性があります。atbridge.ai は接続の確認にこれを必要とします。 対応しているかプロバイダーに問い合わせてください。
  • チャットは応答するがメールを一切調べない: モデルがツール呼び出しに 対応していません。別のモデルを選んでください。

Was this page helpful?