入門

金鑰與安全

#Bearer 認證

每個請求只靠一個 HTTP 標頭完成認證。不需要額外的使用者 ID 標頭，也沒有工作階段 Cookie——Bearer 金鑰本身就能識別你的帳戶並完成路由。只有開啟了請求簽名的金鑰才需要簽名。

auth.sh

curl https://www.aisplice.store/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-luna","messages":[{"role":"user","content":"hi"}]}'

#金鑰管理

在控制台 → API 金鑰裡建立和輪換金鑰。金鑰只在建立時完整顯示一次。

每把金鑰都能單獨設 RPM / RPD 上限、額度上限、模型白名單、IP 白名單和有效期——一個專案一把金鑰，洩漏或失控的指令碼就不會拖垮整個帳號。

開啟金鑰頁

#金鑰安全

不要把金鑰打包進瀏覽器 bundle

瀏覽器可見的金鑰，任何開啟 devtools 的人都能拿到。請透過自己的後端代理呼叫、由伺服器端注入金鑰，或使用短時效的受限金鑰。

金鑰從環境變數或金鑰管理服務載入——絕不要提交進 git。
金鑰一旦出現在日誌、截圖或貼出的堆疊追蹤裡，立即輪換。
給實驗用的金鑰設額度上限，就算出現無窮迴圈也不會耗光錢包。
出口 IP 固定的伺服器端金鑰，配上 IP 白名單。

還是沒解決？

把請求 ID 或錯誤訊息傳給我們，我們來查。