AI API 金鑰安全與成本控制

以獨立金鑰、額度、到期時間、模型限制、IP 允許清單、路由政策、金鑰輪替與可稽核的成本歸因,保護 AI 工作負載。

AI API 金鑰安全與成本控制

一把 AI API 金鑰應該對應一個工作負載邊界,而不是永久代表整個組織。分開使用金鑰,能讓存取權、額度、路由、輪替與用量記錄更容易控管,也不會讓同一組憑證暴露在互不相關的應用程式之間。

Modelflare API 金鑰可以同時設定到期日、有限或無限額度、模型限制、IP 允許清單與路由政策。這些控制措施在一開始就一併規劃時效果最好,而不是等到發生事件後才補上。

從一個工作負載一把金鑰開始

需要獨立存取權或獨立計算費用的邊界,請分別建立金鑰,例如:

  • 正式環境 API 與背景處理作業;
  • 開發與 CI;
  • 程式開發 Agent 或本機工具;
  • 面向客戶的應用程式;
  • 臨時外包人員或遷移作業;
  • 高成本的批次工作負載。

請使用能說明環境與用途的名稱,例如 prod-support-agent 或 dev-evaluation。清楚的名稱能讓請求記錄與輪替決策一目了然,又不會洩漏金鑰本身。

不要讓金鑰出現在用戶端可見的程式碼中

請將完整的金鑰存放在伺服器端的機密管理服務或受保護的環境變數中。不要把它放在:

  • 使用者可以檢視的瀏覽器 JavaScript 或行動應用程式套件中;
  • 版本控制、容器映像檔、螢幕截圖或工單中;
  • 分析事件、錯誤追蹤工具、Shell 歷史記錄或應用程式日誌中;
  • 網址、查詢字串,或含有真實值的複製用指令範例中。

若是瀏覽器應用程式,請透過後端傳送請求,由後端驗證使用者身分並持有 Modelflare 金鑰。如果金鑰可能已經外洩,請建立替代金鑰、將工作負載轉移過去、確認新金鑰的流量正常,再撤銷舊金鑰。

將額度與到期時間視為兩道獨立的邊界

有限的金鑰額度會為該金鑰設下嚴格的用量上限;到期日則限制憑證的有效期間。兩者處理的是不同的風險:

控制措施 主要用途
有限額度 限制可歸屬於該金鑰的用量
無限額度 不設金鑰層級的上限;帳戶額度與其他政策仍然適用
到期時間 在指定時間後終止存取
停用或撤銷 立即停止新的存取

開發、外包與評估用的金鑰,通常應同時設定有限額度與到期時間。正式環境的金鑰可能需要較高或無限的金鑰額度,但依工作負載分開歸屬用量並規劃輪替,對它們仍然有益。

額度無法取代並行數限制或用戶端的重試控制。一波突發流量可能很快耗盡剩餘額度,而反覆失敗也可能產生額外的請求。

工作負載範圍明確時,限制可用模型

模型限制可防止金鑰請求預定範圍以外的模型。這能減少誤用不相容或意外昂貴的模型,並在用戶端請求不該存取的內容時,提供更明確的 403 邊界。

允許的模型範圍應與端點保持一致。即使金鑰能列出某個模型,用戶端與協定仍必須支援該模型的請求格式。請到模型與定價查看即時的契約,而不是把模型 ID 複製到長期使用的政策文件中。

只有在網路路徑穩定時才加上 IP 規則

IP 允許清單會比對 Modelflare 觀察到的用戶端 IP,與金鑰上設定的個別位址或 CIDR 範圍。它適用於對外出口固定的伺服器,但在下列情況可能會中斷流量:

  • 雲端工作負載變更了對外 NAT 位址;
  • 請求改經新的代理或閘道;
  • IPv4 與 IPv6 的路徑不同;
  • 開發人員切換了網路;
  • 設定的 CIDR 比預期更寬或更窄。

啟用這項限制之前,請先確認實際的對外出口路徑,並保留緊急輪替的途徑;也不要把 IP 允許清單當成保護金鑰的替代方案。

審慎選擇一般路由或智慧路由

金鑰類型 路由行為 最適合的情境
一般 API 金鑰 一個明確的主要群組,加上可選的依序備援群組 需要已知路由順序與群組政策的工作負載
智慧 API 金鑰(Smart API Key) 以均衡、穩定優先或低價優先策略,評估帳號可用的群組 希望更廣泛自動選擇路由的工作負載

兩種金鑰送出的都是所請求的模型與協定。路由政策負責選擇符合條件的群組,但不保證每個群組都支援所有模型或功能。一般金鑰的備援清單應依序測試;智慧 API 金鑰則應在正式上線前,依實際的延遲、價格與相容性需求進行評估。

詳細行為請參閱可靠的 AI API 路由。

輪替金鑰時避免不必要的中斷

請採用新舊重疊的輪替方式:

  1. 建立一把新金鑰,並套用相同的預定限制。
  2. 將它存入應用程式的機密管理系統。
  3. 部署新憑證,但先不要刪除舊憑證。
  4. 確認模型存取權,並送出一次實際請求。
  5. 確認新的用量記錄出現在新金鑰底下。
  6. 從每個部署與自動化作業中移除舊金鑰。
  7. 停用或刪除舊金鑰。
  8. 監控是否仍有使用已淘汰憑證的意外請求。

如果金鑰正遭到濫用,請先撤銷,並接受可控範圍內的中斷。重疊輪替的流程適用於計畫性輪替,而不是讓外洩的金鑰繼續暴露。

將金鑰政策與成本檢視連結起來

金鑰層級的隔離,讓成本檢視能夠落實為具體行動。請依金鑰篩選使用日誌,再比較模型、群組、輸入與輸出用量、狀態、重試與費用。有限額度可以阻止後續使用,但請求記錄才能說明額度被什麼消耗。

可重複執行的檢查流程,請參閱 AI API 成本追蹤。

API 金鑰檢查清單

  • 每個應用程式、環境或需要負責的工作負載各用一把金鑰。
  • 不要在瀏覽器程式碼、程式碼存放庫、日誌、網址或螢幕截圖中出現機密資訊。
  • 臨時或實驗用途的金鑰應設定有限額度與到期時間。
  • 範圍明確的工作負載應設定模型限制。
  • 只在已確認且穩定的對外出口路徑上使用 IP 規則。
  • 明確設定一般金鑰的備援順序,或審慎選擇智慧路由策略。
  • 移除舊金鑰之前,先測試輪替流程。
  • 每次變更政策後,依金鑰檢視用量與費用。

常見問題

無限額度的金鑰會移除所有支出限制嗎?

不會。它只是移除金鑰層級的額度上限。帳戶額度、模型價格、群組政策、請求限制與其他服務控制仍然適用。

使用多把金鑰可以繞過速率限制嗎?

不一定。限制可能套用在帳號、模型群組或路由層級。建立金鑰是為了管理存取權與歸屬用量,而不是作為未經驗證的速率限制規避手段。

金鑰外洩時,只靠 IP 允許清單就夠了嗎?

不夠。網路規則能縮小金鑰可被使用的範圍,但網路路徑會變動,設定也可能出錯。請輪替已外洩的憑證,並確保金鑰在儲存與部署時都受到保護。