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 风格错误响应。
