快速入門
快速上手
使用 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 指南。