TokenLab

快速入門

快速上手

使用 cURL、Python、JavaScript、Go 或 PHP 發出第一個 TokenLab API 請求:設定 API 金鑰與端點,執行 Chat Completions 範例並驗證回應。

第 1 步:建立帳戶並儲值

建立帳戶

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

確認工作區餘額

在帳單查看可用餘額。此請求按所選模型目前價格計費,必要時先儲值。

建立並保存 API 金鑰

開啟目前工作區的 API 金鑰,建立金鑰後立即保存完整值;完整金鑰只顯示一次。如果已保存完整金鑰,請使用保存的值。清單中顯示或複製的前綴不能用於請求驗證。

請妥善保管您的 API 金鑰。切勿在客戶端程式碼或公開的儲存庫中暴露它。

為目前終端機設定金鑰

以下命令不會把金鑰寫入命令本身,僅對目前終端機及其子程序生效。部署應用程式時請使用秘密管理工具。

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

第 2 步:安裝客戶端

pip install openai

第 3 步:送出您的第一個請求

對於大多數新的整合,請從 Chat Completions(聊天補全) 與 POST /v1/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 用戶端,需要 PHP 8.2+。

只有在明確需要 Responses(回應) 特定行為時才使用 POST /v1/responses。某些僅限 Responses(回應) 的欄位依賴於所選模型與路由路徑。

核對結果

成功請求應回傳非空回答。在同一工作區的請求記錄核對模型、狀態及用量。錯誤處理見疑難排解;切換模型及串流回應見 SDK 指南。

接下來要做什麼?

本頁內容