# 認證

> 使用 Token 和相容請求頭認證 LLMoxy API 呼叫。

LLMoxy Relay 介面需要使用者 API Token。Token 可在 **控制台 -> 令牌** 建立，通常以 `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` 對應到同一套 Token 認證流程。

## 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
```

## Token 控制

Token 可能受剩餘額度、過期時間、可用模型、分組和 IP 白名單限制。Token 過期、額度不足、被停用或 IP 不允許時，Relay 會返回 OpenAI 風格錯誤響應。

本文是 https://tw.llmoxy.com/docs/api-reference/authentication 的 markdown 版本。
