TokenLab

快速入門

快速入門

使用 cURL、Python、JavaScript、Go 或 PHP 發送您的第一個 TokenLab API 請求。設定您的 API 金鑰、配置端點,並驗證 Chat Completions 的回應。

取得 API 金鑰

建立帳戶

使用您的電子郵件、Google 或 GitHub 帳戶在 tokenlab.sh 註冊。

建立並儲存 API 金鑰

在您的工作區中開啟 API Keys。建立一個金鑰並立即儲存完整數值;它只會顯示一次。如果您已經儲存了完整金鑰,請使用該數值。從列表中顯示或複製的前綴無法用於驗證請求。

檢查工作區餘額

在 Billing 中檢查您的餘額。新帳戶可能會獲得一次性的試用額度;否則,餘額將從 $0 開始,並需要在首次請求前進行儲值(最低 $5)。請求將根據所選模型的當前價格進行計費。

請妥善保管 API 金鑰。請勿將其放入客戶端程式碼或公開儲存庫中。

為當前終端設定金鑰

下方的指令可避免將金鑰直接寫入指令中。它們僅針對當前終端及其子處理程序進行設定。對於已部署的應用程式,請使用祕密管理工具(secret manager)。

printf 'TokenLab API key: '
read -r -s TOKENLAB_API_KEY
printf '\n'
export TOKENLAB_API_KEY

安裝客戶端

pip install openai

發送您的第一個請求

對於大多數新的整合,請從 POST /v1/chat/completions 的 Chat Completions 開始。

curl https://api.tokenlab.sh/v1/chat/completions \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-terra","messages":[{"role":"user","content":"Reply only with OK."}]}'

將其中一個 SDK 範例儲存為 quickstart.py、quickstart.mjs、main.go 或 quickstart.php,然後執行 python quickstart.py、node quickstart.mjs、go run . 或 php quickstart.php。Python、JavaScript 和 Go 使用官方的 OpenAI SDK;PHP 使用社群維護的 OpenAI PHP client (PHP 8.2+)。

僅在需要 Responses 特定行為時才使用 POST /v1/responses。對 Responses 專用欄位的支援取決於所選模型。

確認結果

成功的請求會回傳非空的答案。在同一個工作區中開啟 Runs 以檢查其模型、狀態和使用量。若遇到錯誤,請參考 疑難排解。更改模型或新增串流(streaming)是 SDK 指南 中的後續步驟。

為什麼我的第一次呼叫回傳 402?

您的第一次呼叫是否成功取決於 Billing 中顯示的餘額。在試用額度優惠期間,符合資格的新帳戶可獲得一次 $0.25 的額度,用於 7 天內的最多 10 次呼叫;第 11 次呼叫會回傳 402 並提示免費試用次數已用盡,即使仍有少量額度剩餘。餘額為 $0 的帳戶會收到 HTTP 402 並帶有錯誤代碼 insufficient_balance。請在 Billing 中儲值至少 $5(最低儲值金額為 $5)。然後再次發送相同的請求。您不需要新的 API 金鑰:一旦餘額足以支付請求,您建立的金鑰將繼續運作。

第一次測試呼叫的成本非常低。一個對 deepseek-v4.1-flash 的範例請求成本遠低於 $0.01。

如果您已經有餘額,402 訊息會說明請求所需的金額以及您的當前餘額。TokenLab 會在呼叫開始前預扣 max_tokens 的全部成本,因此輸入過長或 max_tokens 設定過大可能會導致所需金額超過您的餘額。在 /v1/chat/completions 和 /v1/messages 中,當較小的 max_tokens 適用時,訊息也會提供建議的調低數值。當僅輸入內容的成本就超過您的餘額時,訊息會建議縮短輸入內容。

達到自身支出限制的金鑰也會回傳 402,錯誤代碼為 quota_exceeded。您可以在 API Keys 下提高或移除限制。若要在程式碼中處理 402,請參閱 錯誤處理。

繼續開發

本頁內容