API 金鑰管理

建立和儲存

在控制台建立金鑰，將其儲存到可信密碼管理器或服務端環境變數。根據金鑰編輯頁實際提供的選項，設定有效期、可用模型或額度限制。

export NEON_API_KEY="YOUR_API_KEY"

OpenAI 相容請求使用 Authorization: Bearer YOUR_API_KEY。Anthropic 相容客戶端可透過其認證令牌配置使用本站金鑰；具體請求頭見對應協議參考。

保護金鑰

不要把金鑰放進瀏覽器 JavaScript、公開倉庫、截圖或共享日誌。本文件僅展示佔位符，不需要輸入真實金鑰。網頁應用應透過自己的服務端轉發請求，避免將金鑰暴露給訪客。

輪換或撤銷

先建立替代金鑰，更新應用，驗證一次請求，再撤銷舊金鑰。發現洩漏時應立即撤銷，並檢查用量日誌。刪除或過期後，也要更新每個客戶端中的配置。

排查認證失敗

確認使用的是本站金鑰，去掉多餘空格，並保留 Bearer 字首。隨後在控制台檢查有效期、金鑰限制、帳戶狀態和餘額。