# Аутентификация

> Аутентификация вызовов API LLMoxy с помощью токенов и совместимых заголовков запросов.

Интерфейсы Relay LLMoxy требуют токен 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

Для маршрутов, совместимых с Gemini, например `/v1beta/models/{model}:generateContent`, 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.

Это markdown-версия страницы https://ru.llmoxy.com/docs/api-reference/authentication.
