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 風格錯誤響應。
