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