# 認証

> トークンおよび互換性のあるリクエストヘッダーを使用して LLMoxy API 呼び出しを認証します。

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

## Bearer Token

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

```http
Authorization: Bearer <LLMOXY_API_KEY>
```

例：

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

## LLMOXY-API-KEY ヘッダー

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

```http
LLMOXY-API-KEY: <LLMOXY_API_KEY>
```

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

## Claude 互換リクエスト

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

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

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

## Gemini 互換リクエスト

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

```http
x-goog-api-key: <LLMOXY_API_KEY>
```

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

## Realtime WebSocket

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

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

## トークン制御

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

これは https://jp.llmoxy.com/docs/api-reference/authentication の markdown 版です。
