GetAPIGetAPI.ONE API 入門：取得金鑰與首次呼叫
從註冊帳號、選擇模型到建立限定範圍的 API 金鑰、設定客戶端並完成首次連線的完整流程。
從這裡開始
首次使用 GetAPI.ONE，請先註冊帳號，選擇模型及其支援的端點，再建立 API 金鑰。已有金鑰？可直接查看下方的 Python 或 Node.js 範例。傳送請求前請確認目前價格。
開始前準備
- 只使用官方網域名稱 https://www.getapi.one，並準備一個可以接收驗證碼的電子郵件信箱。
- 先確定要連接 Codex CLI、透過 CCSwitch 連接相容的 Codex 目標，還是使用自己的 API 客戶端。
- 準備好私有密碼管理器或環境變數儲存位置。不要把真實金鑰放進公開工單、螢幕截圖或程式碼儲存庫。
1. 建立並進入帳號
- 開啟註冊頁，設定使用者名稱和 8–20 個字元的密碼，再填寫電子郵件信箱。
- 傳送並填寫電子郵件驗證碼，閱讀並同意頁面連結的使用者協議與隱私政策，然後建立帳戶。
- 以使用者名稱或電子郵件信箱和密碼登入。成功後應進入概覽頁。
2. 核對餘額、端點與模型
- 在傳送可能計費的請求前，確認帳號有可用餘額或適用套餐。
- 開啟模型目錄。選擇明確列出用戶端所需端點的模型；不要僅憑模型名稱推斷協議支援。
- 使用前立即查看即時價格，並核對目前模型、分組、計價模式與計費單位，因為可用性與價格可能變動。
3. 建立受限 API 金鑰
- 進入「API 金鑰」，選擇「建立 API 金鑰」，並以用戶端或專案名稱為金鑰命名。
- 選擇所需分組，並設定適合本次串接的明確過期時間和額度。只有確實需要時再設定高階訪問限制。
- 儲存後從金鑰清單複製到私有儲存。GetAPI.ONE 會保留可管理的清單項，之後仍可再次複製金鑰。
4. 連線一個用戶端
只選擇與你的用戶端匹配的路徑。Codex 自定義 Provider 使用 Responses 協議和 ONE Base URL https://www.getapi.one/v1。直接呼叫 API 時必須使用明確宣告的端點，不能盲目拼接路徑。
5. 驗證並繼續
- 成功是指所選用戶端收到有效回應，並且 GetAPI.ONE 主控台記錄到該請求；僅完成本地語法檢查不等於真實呼叫成功。
- 遇到 401 時重新複製 ONE 金鑰，確認金鑰已啟用且與 ONE 地址配套；遇到 404 時核對用戶端要求的準確端點或 /v1 Base URL。
- 遇到模型不存在時，選擇金鑰分組可見且端點相容的模型；遇到額度、限速、網路或上游錯誤時，先儲存時間和請求識別碼再疑難排解。