AI ゲートウェイのエンドポイントと環境変数

既製の AI ツールをワンクリックで引き継ぐだけでなく、自分のアプリ、スクリプト、あるいは任意の AI ツールから AI ゲートウェイを直接呼び出すこともできます。本記事では、ゲートウェイが公開するエンドポイント形式と、仮想キーを使って接続する方法を紹介します。

プロキシエンドポイント

AI ゲートウェイのプロキシサービスは http://127.0.0.1:11580 をリッスンします。さまざまなプロバイダーの SDK やツールと互換性を持たせるため、ゲートウェイは同一ポート上で複数のプロトコル形式のエンドポイントを提供しています。

プロトコル形式	エンドポイントパス	用途
OpenAI 互換	`http://127.0.0.1:11580/v1`	OpenAI API 形式を使うあらゆる SDK / ツール（例：`/v1/chat/completions`）
Anthropic 互換	`http://127.0.0.1:11580/v1/messages`	Anthropic SDK や Claude Code など
Gemini 互換	`http://127.0.0.1:11580/v1beta`	Google Gemini SDK など

使用する SDK のプロトコルに合わせて対応する形式を選び、リクエストをゲートウェイのアドレスに向けるだけで、ゲートウェイが仮想キーの権限に基づいてリクエストを該当プロバイダーのチャネルへルーティングします。

認証：仮想キーを使う

ゲートウェイへのすべてのリクエストは、プロバイダーの実際のキーではなく仮想キーで認証します。まずキーページで仮想キーを作成し、その平文をコピーしてください。

AI ゲートウェイ → エンドポイント（Endpoints） ページでは仮想キーを選択でき、よく使われるツール向けのコピー可能な環境変数スニペットをゲートウェイが直接生成します。

環境変数の例

以下の例では、仮想キーをすでに取得していることを前提とします（これを <あなたの仮想キー> と表記します）。

OpenAI 互換の SDK / ツール

bash

export OPENAI_BASE_URL="http://127.0.0.1:11580/v1"
export OPENAI_API_KEY="<あなたの仮想キー>"

Claude Code / Anthropic

bash

# 注意：Anthropic プロトコルはゲートウェイのルートアドレスを使用し、/v1 は付けません
export ANTHROPIC_BASE_URL="http://127.0.0.1:11580"
export ANTHROPIC_AUTH_TOKEN="<あなたの仮想キー>"

Gemini

bash

export GOOGLE_GEMINI_BASE_URL="http://127.0.0.1:11580"
export GEMINI_API_KEY="<あなたの仮想キー>"

呼び出し例（OpenAI 互換）

bash

curl http://127.0.0.1:11580/v1/chat/completions \
  -H "Authorization: Bearer <あなたの仮想キー>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "こんにちは"}]
  }'

ここで model は、チャネルで設定済みであり、かつその仮想キーで呼び出しが許可されているモデルである必要があります。

前提条件

AI ゲートウェイのプロキシサービスが稼働していること。
少なくとも 1 つの正常なチャネルが設定され、対応するモデル / チャネルの権限を持つ仮想キーが作成されていること。

よくある質問（FAQ）

Q：リクエストが認証失敗を返す場合は？
- A：仮想キー（プロバイダーの実際のキーではない）を使用していること、およびそのキーが有効期限切れや失効になっていないことを確認してください。
Q：モデルが利用できない、または権限がないと表示される場合は？
- A：その model がどこかのチャネルで設定されており、現在の仮想キーの「許可されたモデル / チャネル」にそれが含まれていることを確認してください。
Q：どのエンドポイント形式を使えばよいですか？
- A：使用する SDK のプロトコルに合わせて選びます。OpenAI 形式なら /v1、Anthropic 形式なら /v1/messages（Base URL には /v1 を付けません）、Gemini 形式なら /v1beta を使用します。
Q：LAN 内の他のデバイスからゲートウェイにアクセスできますか？
- A：ゲートウェイはデフォルトで 127.0.0.1（ローカルホストのみ）をリッスンします。これはセキュリティを考慮した推奨設定です。

まとめ

AI ゲートウェイは OpenAI / Anthropic / Gemini の 3 種類の互換形式で統一されたローカルエンドポイントを提供しており、仮想キーによる認証と組み合わせることで、あらゆるアプリや AI ツールをゲートウェイに接続し、統一されたキー管理と使用量の統計を利用できます。一般的な CLI ツールであれば、ワンクリックで引き継ぐほうが手間がかかりません。

AI ゲートウェイのエンドポイントと環境変数 ​

プロキシエンドポイント ​

認証：仮想キーを使う ​

環境変数の例 ​

OpenAI 互換の SDK / ツール ​

Claude Code / Anthropic ​

Gemini ​

呼び出し例（OpenAI 互換） ​

前提条件 ​

よくある質問（FAQ） ​

まとめ ​

AI ゲートウェイのエンドポイントと環境変数

プロキシエンドポイント

認証：仮想キーを使う

環境変数の例

OpenAI 互換の SDK / ツール

Claude Code / Anthropic

Gemini

呼び出し例（OpenAI 互換）

前提条件

よくある質問（FAQ）

まとめ