建立並保護 GetAPI.ONE API 金鑰

開始前準備

• 登入 GetAPI.ONE，並確認可以進入主控台。
• 確認帳號有可用餘額或適用套餐。
• 確定這個金鑰只供哪個用戶端或專案使用，以及私有環境變數存放位置。

• 登入
• 帳號幫助

建立金鑰

1. 從主控台導覽進入「API 金鑰」，點選「建立 API 金鑰」。
2. 填寫能夠識別用戶端和環境的名稱；名稱中不要放入金鑰本身。
3. 選擇預期模型和端點所需的分組。
4. 設定一個金鑰、明確的過期時間和符合預期用量的額度；僅在用戶端需要時設定高階限制。
5. 儲存更改並返回金鑰清單。

• 開啟 API 金鑰

複製並儲存金鑰

建立後，清單會顯示金鑰名稱、脫敏金鑰、分組、狀態和管理操作。GetAPI.ONE 的金鑰不是只顯示一次：之後仍可從金鑰清單再次複製並繼續管理。

export GETAPI_ONE_API_KEY="replace-with-your-private-key"

$env:GETAPI_ONE_API_KEY = "replace-with-your-private-key"

將金鑰與 ONE 地址配套

在不洩露金鑰的前提下驗證

1. 設定一個用戶端，或使用直接請求指南，並把佔位模型替換為目錄中端點相容的模型。
2. 只發送你確實準備計費的最小請求；製作本指南時未傳送模型請求。
3. 確認收到有效回應，並檢查主控台請求或使用記錄；儲存診斷輸出前遮蓋金鑰。

• 直接 API 請求
• Codex CLI

錯誤、輪換與撤銷

• 401 / Unauthorized：重新複製金鑰，移除意外空格，確認金鑰已啟用並與 ONE 地址配套。
• 模型不存在或無權訪問：確認金鑰分組可見該模型，並且模型宣告支援用戶端所用端點。
• 額度或過期錯誤：擴大限制前先檢查金鑰額度和過期時間，同時核對帳號餘額與速率限制。
• 懷疑洩露：停用或刪除受影響金鑰，建立最小範圍的新金鑰，更新用戶端，並確認舊金鑰不能再用。

• 疑難排解
• 支援