繁中 ▾

如何使用 curl 和 Python 測試 AI API 金鑰

一把鑰匙在鎖中轉動,有三個綠色指示燈,代表 API 金鑰測試成功

以下是測試 AI API 金鑰存取權的方法,無需構建任何內容:三個請求,約兩分鐘,您就能知道金鑰是否有效、是否有資金以及是否允許生成文字。

更新於

重點摘要

  • 首先呼叫 GET /v1/models:這可證明金鑰已被接受且未消耗額度。
  • 向模型 uncensored 發送一個短聊天請求,以確認生成功能正常運作。
  • 讀取 X-Balance-USD 標頭或 GET /v1/balance 以查看剩餘額度。
  • 401 指向金鑰問題,402 指向餘額問題,429 指向請求速率問題。

三次請求測試

要正確測試 AI API 金鑰,你需要證明三件獨立的事:伺服器接受該金鑰、金鑰背後有額度,以及收到實際的聊天完成回應。每個測試項目一次呼叫即可讓診斷保持簡潔。如果有任何失敗,你就知道是哪一層出了問題。

  1. 模型列表。 驗證金鑰且無需費用。
  2. 聊天補全。 確認模型能回答問題,且您的請求格式正確。
  3. 餘額。 確認測試後剩餘多少額度。

以下所有操作均使用基礎 URL https://api.aiapisource.com/v1 和模型 ID uncensored。將你的金鑰放入環境變數中,以免其出現在你的 shell 歷史記錄或儲存庫中。

export AIAPI_KEY="paste-your-key-here"

如果你還沒有金鑰,API 金鑰頁面 會顯示如何建立一個金鑰。新帳戶可以在此一鍵領取 $0.50 的試用額度,這已足夠進行本文中的每項測試。

步驟 1:使用 curl 列出模型

最便宜的檢查是唯讀請求。GET /v1/models 返回模型列表並需要有效的金鑰,因此成功的回應證明已通過驗證。

curl -s https://api.aiapisource.com/v1/models \
  -H "Authorization: Bearer $AIAPI_KEY"

健康的回應是包含 data 陣列的 JSON,其中包含 uncensored。如果您看到 HTML 頁面、連線錯誤或空回應,問題出在 URL 而非金鑰。請確認您保留了 /v1 後綴,且變數中的金鑰後沒有尾隨空格。

在 curl 指令中加入 -i 以查看回應標頭。API 在每次呼叫時都會發送 X-Request-Id。如果你需要聯繫 支援,請保留該值,因為它標識了確切的請求。

步驟 2:發送一個聊天請求

現在檢查生成。保持提示詞極短並限制輸出,以將測試成本控制在幾分之一美分以內。

curl -s https://api.aiapisource.com/v1/chat/completions \
  -H "Authorization: Bearer $AIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Reply with the single word: ready"}],
    "max_tokens": 10
  }'

尋找 choices[0].message.content 以及包含 prompt_tokens 和 completion_tokens 的 usage 物件。大約 20 個輸入 token 和 5 個輸出 token 的請求成本為 20 / 1,000,000 x $0.15 加上 5 / 1,000,000 x $0.50,約為 $0.0000055。您可以運行數百次此類請求,總費用仍低於一美分。

同一個端點也支援串流輸出:添加 "stream": true,token 將以伺服器發送事件的形式到達。在基本請求運作正常後,請單獨測試串流功能。

步驟 3:使用 Python 進行相同測試

如果您的實際程式碼使用 OpenAI SDK,也請透過 SDK 進行測試。它能捕捉 curl 無法發現的問題,例如將 Base URL 傳遞給了錯誤的參數。

import os
from openai import OpenAI

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

print([m.id for m in client.models.list().data])

r = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Reply with the single word: ready"}],
    max_tokens=10,
)
print(r.choices[0].message.content)
print(r.usage)

第一次輸出應顯示包含 uncensored 的列表。第二次顯示模型的回覆。如需更詳細的 SDK 設定指南,請見本站的 OpenAI API Python 指南。

從你匯出金鑰的同一個殼層執行 Python 版本。如果它在 AIAPI_KEY 上引發 KeyError,表示該工作階段未設定該變數,這是測試在連上網路前失敗的最常見原因。

Node.js 的運作方式相同:將 baseURL: "https://api.aiapisource.com/v1" 和金鑰傳遞給 OpenAI 客戶端的建構函式。

檢查餘額

金鑰可能有效但沒有剩餘額度可花費。有兩種方式讀取餘額:

curl -s https://api.aiapisource.com/v1/balance \
  -H "Authorization: Bearer $AIAPI_KEY"

# OpenAI-style alternative
curl -s https://api.aiapisource.com/v1/dashboard/billing/credit_grants \
  -H "Authorization: Bearer $AIAPI_KEY"

每個回應也都帶有 X-Balance-USD 標頭,因此步驟 2 的聊天呼叫已經透過 -i 執行時告知你剩餘額度。在 Python 中,OpenAI SDK 透過 client.chat.completions.with_raw_response.create(...) 提供此功能,你可以在其中讀取 response.headers["X-Balance-USD"]。

失敗或拒絕的請求不會收費,因此出錯的測試不會消耗額度。預付額度永不過期,這意味著未使用的餘額在下週仍然存在。

讀取錯誤代碼

當測試失敗時,HTTP 狀態能快速定位原因。

狀態碼一般意義該怎麼辦
401金鑰遺失、輸入錯誤或已撤銷檢查 Authorization: Bearer 標頭,重新複製金鑰,查找隱藏的空格或引號
402沒有剩餘額度支付請求費用讀取餘額,然後前往 定價頁面 儲值
404路徑錯誤或模型 ID 錯誤使用 /v1/chat/completions 和模型 uncensored
429速率或並行限制,或短暫過載等待並重試;見下文

429 錯誤會帶有錯誤程式碼。rate_limited 表示每分鐘請求過多,concurrency 表示同時請求過多。完整金鑰允許每分鐘 300 個請求和 8 個並行請求;試用金鑰允許每分鐘 60 個請求和 2 個並行請求。在暫時過載時,API 會以 Retry-After: 5 回應 429,因此請等待五秒後再次發送請求。串流請求會佔用其並行槽位直到串流結束,這是試用金鑰在並行測試中觸及限制常見的原因。

401、402 和 404 狀態碼遵循正常的 API 慣例,因此請將此表格視為初步猜測,並讀取 JSON 錯誤主體以獲取確切訊息。

可重複使用的冒煙測試腳本

一旦手動測試通過,請保留一個腳本,以便在旋轉金鑰或更改環境後運行。

import os, sys
import requests

BASE = "https://api.aiapisource.com/v1"
H = {"Authorization": "Bearer " + os.environ["AIAPI_KEY"]}

m = requests.get(BASE + "/models", headers=H, timeout=15)
print("models", m.status_code)

c = requests.post(
    BASE + "/chat/completions",
    headers=H,
    json={"model": "uncensored",
          "messages": [{"role": "user", "content": "ping"}],
          "max_tokens": 5},
    timeout=60,
)
print("chat", c.status_code, "balance", c.headers.get("X-Balance-USD"))
sys.exit(0 if m.ok and c.ok else 1)

退出代碼使其容易整合到部署檢查中。對於超出此最小值的參數,API 文件 列出了該端點接受的所有內容。

問答

測試 API 金鑰會收費嗎?

呼叫模型列表是免費的。一則帶有低 max_tokens 設定的短聊天請求,輸入 token 每 1M 個收費 $0.15,輸出 token 每 1M 個收費 $0.50,成本僅為數百萬分之一美元。失敗的請求不會收費。

我如何在不綁定信用卡的情況下測試金鑰?

註冊後,前往 API 金鑰頁面領取 $0.50 的免費試用額度。該額度無需信用卡即可領取,有效期為 7 天,每人限領一次。

為什麼有效的金鑰會立即返回 429 錯誤?

你可能觸發了並行或每分鐘請求限制。試用金鑰允許 2 個並行請求和每分鐘 60 個請求;完整金鑰允許 8 個並行請求和每分鐘 300 個請求。檢查錯誤程式碼,然後減慢速度或等待幾秒後重試。

我可以在 Postman 或應用程式中測試金鑰,而不使用 curl 嗎?

可以。任何 OpenAI 相容的客戶端均可使用:將 Base URL 設定為 https://api.aiapisource.com/v1,將金鑰作為 Bearer token 貼上,並使用模型 uncensored。

你的金鑰只差一個表單即可取得

建立帳號、複製金鑰、更改基礎 URL。這就是整個設定過程。

取得 API 金鑰