Интерфейсы Relay LLMoxy требуют токен API пользователя. Токены можно создать в разделе Консоль -> Токены, обычно они начинаются с sk-.
Bearer Token
Рекомендуется использовать стандартный заголовок:
Authorization: Bearer <LLMOXY_API_KEY>
Пример:
curl https://llmoxy.com/v1/models \
-H "Authorization: Bearer <LLMOXY_API_KEY>"
Заголовок LLMOXY-API-KEY
Если в запросе отсутствует Authorization, LLMoxy также принимает:
LLMOXY-API-KEY: <LLMOXY_API_KEY>
Предпочтительнее Authorization: Bearer. Пользовательский заголовок в основном используется в сценариях интеграции, где неудобно задавать стандартный заголовок аутентификации.
Запросы, совместимые с Claude
Для /v1/messages и /v1/models клиенты в стиле Anthropic могут использовать:
x-api-key: <LLMOXY_API_KEY>
anthropic-version: 2023-06-01
LLMoxy сопоставляет x-api-key с тем же потоком аутентификации по токену.
Запросы, совместимые с Gemini
Для маршрутов, совместимых с Gemini, например /v1beta/models/{model}:generateContent, LLMoxy принимает:
x-goog-api-key: <LLMOXY_API_KEY>
Также поддерживается ?key=<LLMOXY_API_KEY> для совместимости с клиентами Gemini. При серверной интеграции рекомендуется использовать заголовки, чтобы ключи не попадали в URL или журналы.
Realtime WebSocket
Серверные WebSocket-клиенты могут использовать стандартные заголовки аутентификации при рукопожатии. Браузерные клиенты OpenAI Realtime могут передавать ключ через подпротокол:
realtime, openai-insecure-api-key.<LLMOXY_API_KEY>, openai-beta.realtime-v1
Ограничения токена
Токены могут быть ограничены остатком баланса, сроком действия, доступными моделями, группами и белым списком IP. При истечении срока действия токена, недостатке средств, его отключении или запрещённом IP Relay возвращает ошибку в стиле OpenAI.