logo

认证

LLMoxy Relay 接口需要用户 API Token。Token 可在 控制台 -> 令牌 创建,通常以 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 映射到同一套 Token 认证流程。

Gemini 兼容请求

对于 /v1beta/models/{model}:generateContent 等 Gemini 兼容路由,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

Token 控制

Token 可能受剩余额度、过期时间、可用模型、分组和 IP 白名单限制。Token 过期、额度不足、被禁用或 IP 不允许时,Relay 会返回 OpenAI 风格错误响应。