Get API

GET API · 開發者整合

如何安全地建立和使用 Get API 金鑰

註冊或登入Get API後,在API金鑰頁面建立金鑰,為其指定一個可識別的名稱,然後選擇與目標工具或模型相符的群組。完整的金鑰可能只會顯示一次,因此請立即將其儲存在伺服器端秘密管理器或受控的本機環境變數中;切勿將生產金鑰放入瀏覽器程式碼、螢幕截圖、公用儲存庫或日誌中。

名稱組織鍵;群組範圍訪問

關鍵名稱將開發、測試和生產使用分開。它的組決定了密鑰可以到達的模型或工具。團體不是社會團體,其標籤不應被視為永久的模範承諾;在創建密鑰之前查看即時目錄和當前 UI。

  • 對不同的環境使用不同的密鑰
  • 選擇與目標工具或模型相符的群組
  • 將目前控制台視為具有存取權限的控制台

將憑證保存在受控環境中

瀏覽器捆綁包、公共儲存庫、螢幕截圖和普通日誌都可能會暴露憑證。伺服器應用程式應從秘密儲存或環境變數中讀取密鑰;桌面工具應使用其受保護的配置表面。

  • 不要在客戶端公開的建置變數中使用生產金鑰
  • 僅記錄經過編輯的標識符
  • 在建立替換項目之前停用可疑的金鑰

從一個最低要求開始

對於第一次檢查,請使用即時目錄中的一個目前模型識別碼和最小的 messages 請求。在身份驗證和路由工作完成後,一次新增串流媒體、工具、映像或結構化輸出一項功能。

  • 使用 https://relay-api.getapi.pro/v1 作為基本 URL
  • 發送聊天請求至 /chat/completions
  • 從即時目錄複製模型標識符

在控制台中建立並驗證金鑰

此流程不需要發布真正的密鑰;螢幕截圖僅顯示導航和空白欄位。

  1. 註冊或登入Get API

    在主站點上完成帳戶存取。新用戶可以使用/註冊;現有用戶可以直接進入控制台。

  2. 開啟 API 金鑰頁面

    在控制台導覽中選擇 API Keys 以到達管理金鑰的清單。

    API Get API 控制台中的按鍵導覽條目
    從控制台導覽開啟 API 金鑰頁面。參考 UI 以中文顯示。
  3. 輸入名稱並選擇群組

    選擇“建立金鑰”,輸入可識別的名稱,然後選擇與目標工具或模型相符的群組。

    用於建立 Get API 金鑰的名稱和群組字段
    名稱和群組是核心欄位。目前控制台中的選項仍然具有權威性;參考 UI 以中文顯示。
  4. 複製並安全存儲

    立即複製完整的金鑰並將其放置在伺服器端秘密儲存或受控的本機環境變數中。不要假設完整的值稍後仍然可見。

  5. 發送至少一個驗證請求

    從即時目錄複製目前可用的型號識別碼並驗證 Bearer 身份驗證、Base URL 和最小聊天請求。

避免將金鑰寫入 shell 歷史記錄的請求

讀取環境變數而不回顯它,然後使用佔位符模型發送最小請求。 Windows可以在受控環境中設定相同的變數。

read -s GETAPI_API_KEY
export GETAPI_API_KEY
curl https://relay-api.getapi.pro/v1/chat/completions \
  -H "Authorization: Bearer $GETAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-model-name","messages":[{"role":"user","content":"Hello"}]}'

API密鑰故障排除

首先觀察 HTTP 或控制台狀態,更改一個變量,然後再次測試。

症狀可能的原因行動成功檢查
401或認證失敗密鑰不完整、過期或停用;授權標頭格式錯誤從安全儲存中讀取金鑰,並在 Bearer 和金鑰之間保留一個空格最小請求不再傳回身份驗證錯誤
按鍵已停用行政行為、風險控製或有意輪換停止重試舊密鑰並在獲得授權後建立替換密鑰可以在控制台中進行替換
模特兒不在群組中關鍵組不包含目標型號查看即時目錄和目前群組選項所選模型對按鍵可見
餘額或配額訊息當前餘額、計劃或使用狀態阻止請求在控制台中查看即時餘額、計劃和使用情況,無需假設固定閾值控制台狀態允許測試請求
404或路由不匹配缺少 /v1、重複的路徑或錯誤的端點將 Base URL 設定為 https://relay-api.getapi.pro/v1 並附加聊天路徑一次請求到達協定端點

常見問題

建立 Get API 金鑰需要哪些欄位?

輸入可識別的名稱並選擇與目標工具或模型相符的群組。目前控制台對於可用群組和存取權限仍然具有權威性。

Get API 金鑰可以儲存在瀏覽器程式碼中嗎?

不要將生產密鑰存放在那裡。瀏覽器程式碼和用戶端暴露的環境變數可供使用者讀取;使用伺服器端儲存或受保護的桌面工具設定。

為什麼請求返回401?

常見原因是金鑰不完整、過期或停用,或 Authorization 標頭不使用 Bearer 格式。以最少的請求進行診斷,並且永遠不會在日誌中列印完整的密鑰。

可以一鍵調用所有型號嗎?

不要這樣認為。金鑰群組、帳戶權限、即時目錄和目前服務狀態決定其可存取模型。

商務合作: business@honeykid.cn