AI API 金鑰測試器：30 秒內檢查金鑰

為什麼要在本地測試而不是在網頁上

搜尋 AI API 金鑰測試器會跳出許多網頁，讓你貼上金鑰然後按按鈕。避開它們。金鑰是一種會花錢的密碼，而你無法知道那些網頁會用它做什麼。以下的測試只需半分鐘，在你自己的機器上執行，且只會將金鑰發送到你想使用的 API。

你需要三樣東西：金鑰、Base URL https://api.getaiapikey.com/v1 和模型 ID uncensored。將金鑰放入環境變數中，以免它出現在你的 shell 歷史記錄或你可能提交的檔案中。

Copyexport API_KEY="paste-your-key-here"

金鑰來自 API 金鑰頁面。如果你還沒有金鑰，新用戶在註冊後可以點擊一次領取 $0.50 的試用額度，這足以讓你多次執行本文中的所有測試。

檢查 1：使用 curl 列出模型

最便宜的測試是模型列表。它需要有效的金鑰和正確的 Base URL，且不會生成任何文本。

Copycurl -i https://api.getaiapikey.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

-i 旗標會列印回應標頭。健康的回覆以 HTTP/2 200 開頭，且 JSON 主體包含模型 ID uncensored。如果你看到的是驗證錯誤（通常是狀態 401），表示金鑰有誤、複製時帶有尾隨空白，或是標頭遺漏了字 Bearer。404 表示 URL 有誤，最常見的是缺少 /v1 或重複了。

檢查 2：執行一次真正的補全

金鑰可能有效，但在實際請求時仍會失敗，例如餘額已空。因此發送一個小型聊天請求，並將輸出限制在接近零的成本：

Copycurl -i https://api.getaiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"Say ok."}]}'

請在讀取主體前先讀取標頭。X-Request-Id用於識別該次呼叫，這也是支援團隊會要求提供的資訊。X-Balance-USD顯示剩餘的額度。X-RateLimit-Limit-Requests與X-RateLimit-Limit-Concurrency顯示你金鑰的速率限制：完整金鑰為 300 與 8，試用金鑰為 60 與 2。因此，這一次呼叫就能同時檢查驗證、模型、餘額與金鑰類型。

測試的價格可以忽略不計。約 10 個 token 的提示詞和 5 個 token 的回覆成本為 10 x $0.15 / 1M + 5 x $0.50 / 1M，約為 $0.000004。失敗或被拒絕的請求完全不收費。

檢查 3：Python 中的相同測試

如果你的程式碼使用 Python，請以程式碼實際執行的方式進行測試。此腳本使用了官方的openai套件，因此若此處測試通過，代表你的應用程式設定也能運作：

Copyimport os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.getaiapikey.com/v1",
    api_key=os.environ["API_KEY"],
)

raw = client.chat.completions.with_raw_response.create(
    model="uncensored",
    max_tokens=5,
    messages=[{"role": "user", "content": "Say ok."}],
)
print("status:", raw.status_code)
print("balance:", raw.headers.get("X-Balance-USD"))
print("req/min limit:", raw.headers.get("X-RateLimit-Limit-Requests"))
print("concurrency limit:", raw.headers.get("X-RateLimit-Limit-Concurrency"))
print("reply:", raw.parse().choices[0].message.content)

with_raw_response封裝器可讓你存取標頭，而parse()則會回傳一般的回應物件。如果匯入失敗，Python 環境的設定可參考如何在 Python 中安裝 LLM 客戶端。

在不進行補全的情況下檢查餘額

要在不生成文本的情況下讀取餘額，請呼叫其中一個餘額端點。有一個 OpenAI 風格的端點和一個短端點：

Copycurl https://api.getaiapikey.com/v1/balance \
  -H "Authorization: Bearer $API_KEY"

curl https://api.getaiapikey.com/v1/dashboard/billing/credit_grants \
  -H "Authorization: Bearer $API_KEY"

已經預期 OpenAI 額度授予格式的程式庫可以直接使用第二條路徑。將類似這樣的呼叫加入監控腳本，當生產環境的機器人額度耗盡前，你會收到警告。儲值最低金額為 $20，且額度永不失效，因此保留充足的餘額沒有任何損失。金額與獎金請見 定價頁面。

將測試變成健康檢查

一旦金鑰運作正常，請保留該測試。一個定期執行的小型腳本可以提前告知你部署失敗、憑證過期或餘額不足，以免使用者先發現問題。以下是使用內建fetch的 Node 版本（Node 18 或更新版本）：

Copyconst base = "https://api.getaiapikey.com/v1";

async function check() {
  const res = await fetch(`${base}/chat/completions`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "uncensored",
      max_tokens: 5,
      messages: [{ role: "user", content: "Say ok." }],
    }),
  });
  const balance = Number(res.headers.get("X-Balance-USD"));
  console.log(res.status, "balance:", balance);
  if (res.status >= 400 || balance < 5) process.exitCode = 1;
}

check();

當請求失敗或餘額低於 $5 時，腳本會以非零的退出碼結束，因此 cron 工作排程器或 CI 步驟可以向你發出警告。根據你自己的消耗率選擇閾值：以每天 $2 的速度消耗，$5 會給你兩日多的警告時間。

通過的測試不能證明什麼

綠色勾號顯示在該時刻、低負載下身份驗證、路由和模型運作正常。它不會顯示你的應用程式在同時有 20 個用戶時的行為。為此，請記住限制：完整金鑰同時運行 8 個請求，串流請求會保留其槽位直到串流結束。在發布前，使用並行呼叫限制對你自己的程式碼進行負載測試。

讀取失敗

您會看到的內容	最可能的原因	該怎麼辦
身份驗證錯誤，通常是 401	金鑰錯誤、額外空白、無 Bearer 前綴	重新複製金鑰，檢查標頭字串
404 或 HTML 而非 JSON	Base URL 錯誤	請精確使用https://api.getaiapikey.com/v1
找不到模型	請求中的模型 ID 不同	將 model 設定為 uncensored
狀態碼 429 搭配rate_limited或concurrency	每分鐘請求過多或同時請求過多	等待，然後帶延遲重試
429 帶有 Retry-After: 5	暫時過載	等待 5 秒後重試
連接或超時錯誤	網路、代理或防火牆	從其他網路測試，檢查代理變數

超過 8 MB 的請求會被拒絕，因此如果只有大型請求失敗，請檢查請求大小。文件列出了所有錯誤代碼與標頭。

處理金鑰的良好習慣

• 將金鑰保存在環境變數或秘密儲存庫中，不要保存在客戶端程式碼、公共儲存庫或截圖中。
• 盡可能為每個應用程式使用一個金鑰，以便輕鬆追蹤和替換洩露的金鑰。
• 如果金鑰可能已洩露，請替換它，然後查看餘額以查看意外支出。
• 不要在多個程式之間共享試用金鑰：若有 2 個並行請求，它會很快達到限制。

如果你只想在註冊前確認是否有免費方案，關於免費 LLM API 金鑰的文章說明了可用的選項。否則，上述三項檢查就是金鑰測試所需的全部內容。

更多指南

• AI API 金鑰定價：一個金鑰實際成本
• AI API 檢查清單