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 Studio | http://localhost:1234/v1 |
| vLLM | http://localhost:8000/v1 |
| llama.cpp server | http://localhost:8080/v1 |
| LiteLLM proxy | http://localhost:4000 |
atbridge.ai に追加する
Section titled “atbridge.ai に追加する”-
Thunderbird で atbridge 設定 を開きます: 歯車、または ツール → アドオンとテーマ → atbridge.ai → オプション( atbridge 拡張機能の設定を開く を参照)。 AI プロバイダー タブへ移動します。
-
プロバイダー ドロップダウンで OpenAI 互換(カスタム URL) を選びます。
-
Base URL を入力し、API キー にキーを貼り付けます。キーは このデバイス上で暗号化 され、atbridge.ai のサーバーに届くことはありません。
-
接続 をクリックします。atbridge.ai はモデル一覧を要求して、アドレスと キーをすぐに確認します。確認に成功するとステータスが緑の ✓ に変わります。 失敗した場合は何も保存されず、理由が表示されます。
モデルを選んでチャットする
Section titled “モデルを選んでチャットする”atbridge AIチャット(Thunderbird の @b ボタン)を開き、モデル ドロップダウンからモデルを選びます。ここにはサービスが報告するモデルが表示 されます。ゲートウェイでは数百のモデルが並ぶこともあります。正確な名前で モデルを指定したい場合は、設定 → 優先する AI プロバイダーとモデル の カスタムモデル ID に入力してください。
データを見るのは誰か
Section titled “データを見るのは誰か”OpenAI 互換プロバイダーでは、プロンプトと、AIチャットに渡したメール本文や 添付ファイルは、入力した Base URL に 送信されます。atbridge.ai はそれらを 中継も保存もしません。サービスを接続する前に、その運営者を信頼できるか確認し、 プライバシーとデータ保持の規約を読んでください。パソコンの外に出してはいけない メールには、ローカルサーバー(上の表)または Ollama を使ってください。
コマンドラインから設定する
Section titled “コマンドラインから設定する”同じ接続をターミナルから行います。キーは標準入力から読み込まれるため、 シェルの履歴に残りません:
echo "$MY_API_KEY" | atbridge connect activate --provider openai-compatible \ --base-url https://llm.example.com/v1 --key-stdin接続できない場合
Section titled “接続できない場合”- 404 または “not found”: Base URL が間違っています。プロバイダーの
ドキュメントからもう一度コピーしてください。通常は
/v1で終わるアドレスです。 - 401 または 403: キーが間違っている、期限切れである、またはそのモデルへの アクセス権がありません。
- URL は正しいのに接続が失敗する: サービスがモデル一覧(
/v1/models)を 提供していない可能性があります。atbridge.ai は接続の確認にこれを必要とします。 対応しているかプロバイダーに問い合わせてください。 - チャットは応答するがメールを一切調べない: モデルがツール呼び出しに 対応していません。別のモデルを選んでください。
Was this page helpful?
Thanks for the feedback!