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やGemini CLIなど

利用するSDKの仕様に合わせて該当プロトコルを選択し、リクエストをゲートウェイアドレスへ送信してください。ゲートウェイは仮想キーの権限に応じて要求を各ベンダーのチャネルへルーティングします。

認証方式：仮想キーの利用

すべてのゲートウェイリクエストは仮想キーによる認証が必須で、ベンダーの本物のKeyは不要です。仮想キーページで仮想キーを作成し、平文キーをコピーしてください。

**AIゲートウェイ → エンドポイント（Endpoints）**ページで仮想キーを選択すると、代表的なツールの環境変数設定例をすぐにコピーできます。

環境変数の例

ここでは、すでに仮想キー（<あなたの仮想キー>とする）を取得済みである前提です。

OpenAI互換SDK/ツールの場合

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

Claude Code / Anthropicの場合

# 注意：Anthropicプロトコルではゲートウェイルートアドレス（/v1なし）を指定します
export ANTHROPIC_BASE_URL="http://127.0.0.1:11580"
export ANTHROPIC_AUTH_TOKEN="<あなたの仮想キー>"

Geminiの場合

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

呼び出し例（OpenAI互換）

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：仮想キー（ベンダー本物のKeyではない）を利用しているか、有効期限切れや無効化されていないかご確認ください。
• Q：モデルが利用できないor権限がないと表示される？
  • A：使用するmodelが、どれかのチャネルで設定済みかつ仮想キーの「許可されたモデル／チャネル」に含まれているか確認を。
• Q：どのエンドポイント形式を選べばいい？
  • A：SDKのプロトコルに応じて選択します。OpenAI系は/v1、Anthropic系は/v1/messages（Base URLは/v1なし）、Gemini系は/v1betaを使用してください。
• Q：LAN内の他機器からゲートウェイ利用はできる？
  • A：デフォルトでは127.0.0.1（ローカルホスト）のみListenします。これはセキュリティを考慮した推奨設定です。

まとめ

AIゲートウェイはOpenAI／Anthropic／Geminiの3つの互換プロトコルで統一されたローカルエンドポイントを提供しており、仮想キーによる認証と組み合わせることで、あらゆるアプリやAIツールを接続できます。キー管理や利用統計も一元管理でき、とくにCLIツールならワンクリック引き継ぎを使うのが手軽でおすすめです。