面板教學
API Key 管理
建立專用 API Key，選擇可用分組，並安全地配置到你的工具。
API Key 是客戶端呼叫 AIXHUB API 的憑證。它不是控制台登入密碼，也不能代替上游服務的帳戶登入。建議每個工具或設備建立獨立金鑰，出現問題時只撤銷受影響的那一把。
前置條件
- 已登入 AIXHUB 控制台。
- 準備好密碼管理器或客戶端的安全憑證儲存位置。
- 已決定金鑰用途，例如「Claude Code」、 「Codex」或「本機測試」。
操作步驟
-
從側邊導覽進入 API 金鑰頁面。
-
點擊建立或新增，使用能辨識設備和用途的名稱。若頁面要求選擇分組，先回到可用渠道確認該分組包含目標模型。
-
如果頁面提供配額、有效期或速率限制，按你的用途設定；不清楚含義時不要隨意填寫。
-
建立後立即複製完整金鑰並存入安全位置。很多介面只在建立時顯示完整值。
-
需要配置工具時，優先使用金鑰旁的「使用密鑰」或設定提示，按工具類型複製 Base URL 和環境變數。
export AIXHUB_API_KEY="sk-your-key" -
金鑰遺失、曾經貼到聊天或公開倉庫、或出現陌生用量時，立即撤銷舊金鑰，再建立替代金鑰。
驗證結果
金鑰清單出現新項目，使用該金鑰的最小 API 請求成功，撤銷後同一金鑰會收到認證錯誤。
不要為了測試撤銷日常使用中的唯一金鑰。驗證撤銷流程時，請建立一把短期測試金鑰。
常見問題
- 建立後找不到完整值：不要猜測或修改舊值，撤銷後重新建立。
- 401 認證錯誤：確認金鑰沒有多餘空格、沒有被撤銷，且客戶端讀取的是這一把金鑰。
- 金鑰出現在 Git 或截圖：立即撤銷，清除公開位置，再建立替代金鑰。
- 不知道 Base URL 怎麼填：先看客戶端教學或「使用密鑰」提示，不要自行追加
/v1。
下一步
先完成快速開始，再依工具選擇 Claude Code、Codex CLI 或通用 OpenAI 相容用戶端。