建立 API 金鑰

API 請求使用 GetRouter API 金鑰進行驗證。請為每個應用程式或工具建立不同的金鑰,以便個別追蹤用量及撤銷存取權。

建立金鑰

  1. 登入 GetRouter
  2. 開啟 API Keys 頁面
  3. 選取 Create API Key
  4. 輸入可識別應用程式的名稱,例如 CodexOpenClawDevelopment
  5. 您也可以設定到期時間、用量上限或模型限制。
  6. 建立金鑰,並將其複製到安全的位置。

命名方式範例:

開發環境
正式環境 API
Codex 筆記型電腦
OpenClaw 代理工具

驗證請求

將金鑰作為 Bearer token 傳送:

curl https://getrouter.ai/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

除非工具明確要求,否則在工具的 API 金鑰欄位中,請勿於實際金鑰值外加上引號。

安全保存金鑰

本機開發時,請將金鑰存入環境變數:

export GETROUTER_API_KEY="YOUR_API_KEY"

再從應用程式參照該變數:

import os

api_key = os.environ["GETROUTER_API_KEY"]
Danger

切勿將 API 金鑰提交至 Git、公開在瀏覽器端程式碼中,或貼入公開的問題回報。若金鑰外洩,請立即刪除並建立替代金鑰。

使用不同的金鑰

使用不同的金鑰可讓您更容易:

  • 撤銷單一工具的存取權,而不中斷其他應用程式
  • 設定不同的用量上限
  • 將金鑰限制為只能使用所需模型
  • 識別非預期用量

後續步驟