GetAPIGetAPI.ONE
GetAPI.ONE 快速入門
從註冊帳號、選擇模型到建立受限 API 金鑰、設定用戶端並完成可驗證首次連線的完整路徑。
開始前準備
- 只使用官方網域名稱 https://www.getapi.one，並準備一個可以接收驗證碼的電子郵件信箱。
- 先確定要串接 Codex CLI、來源文件描述的 CCSwitch 工作流程，還是自己的 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。
- 遇到模型不存在時，選擇金鑰分組可見且端點相容的模型；遇到額度、限速、網路或上游錯誤時，先儲存時間和請求識別碼再疑難排解。