# Xác thực

> Xác thực lệnh gọi API LLMoxy bằng token và tiêu đề yêu cầu tương thích.

Giao diện LLMoxy Relay cần Token API người dùng. Token có thể được tạo trong **Bảng điều khiển -> Token**, thường bắt đầu bằng `sk-`.

## Bearer Token

Khuyến nghị sử dụng tiêu đề chuẩn：

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

Ví dụ：

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

## Tiêu đề LLMOXY-API-KEY

Khi yêu cầu không có `Authorization`, LLMoxy cũng chấp nhận：

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

Ưu tiên sử dụng `Authorization: Bearer`. Tiêu đề tùy chỉnh chủ yếu dùng cho các tình huống tích hợp không thể thuận tiện đặt tiêu đề xác thực chuẩn.

## Yêu cầu tương thích Claude

Đối với `/v1/messages` và `/v1/models`, khách hàng kiểu Anthropic có thể sử dụng：

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

LLMoxy sẽ ánh xạ `x-api-key` vào cùng một quy trình xác thực token.

## Yêu cầu tương thích Gemini

Đối với các tuyến tương thích Gemini như `/v1beta/models/{model}:generateContent`, LLMoxy chấp nhận：

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

Cũng hỗ trợ `?key=<LLMOXY_API_KEY>` để tương thích với khách hàng Gemini. Tích hợp phía máy chủ nên sử dụng tiêu đề yêu cầu, tránh để khóa xuất hiện trong URL hoặc nhật ký.

## Realtime WebSocket

Khách hàng WebSocket phía máy chủ có thể sử dụng tiêu đề xác thực chuẩn khi bắt tay. Khách hàng OpenAI Realtime kiểu trình duyệt có thể truyền khóa qua giao thức con：

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

## Kiểm soát Token

Token có thể bị giới hạn bởi số dư còn lại, thời hạn hết hạn, mô hình khả dụng, nhóm và danh sách trắng IP. Khi token hết hạn, thiếu số dư, bị vô hiệu hóa hoặc IP không được phép, Relay sẽ trả về phản hồi lỗi kiểu OpenAI.

Đây là bản markdown của https://vi.llmoxy.com/docs/api-reference/authentication.
