BYOK 金鑰保管庫

使用你自己的供應商金鑰。閘道會用你的憑證去呼叫該供應商,因此用量記在你的供應商帳戶上,而不是 Synthorai 餘額上,同時路由、記錄與統一 API 都維持不變。

在控制台側邊欄(該功能適用於你的帳戶時才會出現): BYOK Keys 開啟 ↗

操作步驟

1. 打開 BYOK Keys,為你已持有帳戶的供應商新增金鑰。
2. 貼上供應商金鑰。它會加密儲存,儲存後不會再回傳給瀏覽器。
3. 可選:以逗號分隔列出模型 id,把它限定在特定模型。留空則涵蓋該供應商提供的所有模型。
4. 發送一次請求,並在供應商自己的控制台確認用量確實記到了那邊。

限制與注意事項

• 金鑰儲存後就不會再顯示,保管庫會加密存放,只在呼叫供應商的傳輸過程中解密。
• 供應商端的配額變成你自己的。有兩點要注意:閘道在得知某個請求是 BYOK 之前,就會先套用自己的單一模型速率限制;而且在擁有者設定了成員每日限額的情況下,BYOK 用量仍會計入該限額。
• 只有工作區擁有者可以新增、輪替或移除 BYOK 金鑰。移除後,受影響的模型會在下一次請求就退回使用共用憑證。
• 自訂端點可以接入你自己執行的服務或服務商的方案，只要它相容 OpenAI Chat Completions、OpenAI Responses 或 Anthropic Messages API。在自訂端點中填寫名稱、API 類型、Base URL、金鑰和要接管的模型；不列模型就接管所有模型。請求中的模型名稱不用改，會原樣送往端點。這些請求不扣額度，會和其他請求一樣出現在日誌中。端點出錯時，由自動回退到 Synthorai 額度決定是否改由 Synthorai 回應。位址必須是 https，且能從公網存取。如果端點不提供模型清單，測試連線會用你填的第一個模型送出一次簡短請求，費用記在你自己的帳戶上；這次請求會在日誌中顯示為連線測試。