# 认证

> 使用 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://llmoxy.com/docs/api-reference/authentication 的 markdown 版本。
