logo

認証

LLMoxy Relay インターフェースにはユーザー API トークンが必要です。トークンは コンソール -> トークン で作成でき、通常 sk- で始まります。

Bearer Token

標準リクエストヘッダーの使用を推奨します:

Authorization: Bearer <LLMOXY_API_KEY>

例:

curl https://llmoxy.com/v1/models \
  -H "Authorization: Bearer <LLMOXY_API_KEY>"

LLMOXY-API-KEY ヘッダー

リクエストに Authorization がない場合、LLMoxy は以下も受け入れます:

LLMOXY-API-KEY: <LLMOXY_API_KEY>

Authorization: Bearer を優先してください。カスタムリクエストヘッダーは、標準認証ヘッダーを設定しにくい統合シナリオで主に使用されます。

Claude 互換リクエスト

/v1/messages および /v1/models に対して、Anthropic スタイルのクライアントは以下を使用できます:

x-api-key: <LLMOXY_API_KEY>
anthropic-version: 2023-06-01

LLMoxy は x-api-key を同じトークン認証フローにマッピングします。

Gemini 互換リクエスト

/v1beta/models/{model}:generateContent などの Gemini 互換ルートでは、LLMoxy は以下を受け入れます:

x-goog-api-key: <LLMOXY_API_KEY>

?key=<LLMOXY_API_KEY> も Gemini クライアント互換のためにサポートされています。サーバーサイド統合では、キーが URL やログに残らないようリクエストヘッダーの使用を推奨します。

Realtime WebSocket

サーバーサイド WebSocket クライアントはハンドシェイク時に標準認証ヘッダーを使用できます。ブラウザスタイルの OpenAI Realtime クライアントはサブプロトコルを介してキーを渡せます:

realtime, openai-insecure-api-key.<LLMOXY_API_KEY>, openai-beta.realtime-v1

トークン制御

トークンは残高、有効期限、利用可能モデル、グループ、IP ホワイトリストによって制限される場合があります。トークンの有効期限切れ、残高不足、無効化、または許可されていない IP の場合、Relay は OpenAI スタイルのエラーレスポンスを返します。