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 スタイルのエラーレスポンスを返します。
