TokenLab Management API 新增組織餘額查詢功能

TokenLab 的管理 API 現已支援直接查詢餘額，讓團隊能透過管理 Token 查詢組織目前的總餘額，無需再手動查看儀表板。這解決了團隊在執行自動化預算檢查、充值提醒或受使用量限制的工作流程時常見的痛點。

重點摘要

• 管理 API 現已開放餘額端點，可回傳您組織目前的總餘額。
• 此功能與用於呼叫 Claude Sonnet 5、GPT-5.5、Gemini 3.5 Flash 及其他模型的模型推論 API 金鑰分開。
• 餘額查詢旨在用於預算檢查、充值提醒、暫停或恢復自動化工作流程，以及為財務儀表板提供數據。
• 該端點可與現有的 API 金鑰使用量端點搭配使用，以建立完整的支出概覽。

為何需要此功能

在此更新之前，若要查看組織餘額，必須登入 TokenLab 儀表板並從帳單頁面讀取。對於每天查看一次的人來說這沒問題，但一旦您想要進行任何自動化操作，這種方式就無法運作。

在 DeepSeek V4 Pro、Qwen3.7 Plus 或 Kimi K2.7 Code 等模型上執行生產工作負載的團隊，通常需要一個能在啟動大型作業前檢查餘額的指令碼，或是當餘額低於門檻時發出警報的監控程式。若沒有可查詢的餘額端點，唯一的選擇就是手動檢查或抓取儀表板數據，這兩者都不適合在生產環境中執行。

透過管理 API 進行餘額查詢解決了這個問題。現在，觸發 Kling 3.0 或 Seedance 影片生成作業批次的自動化程式，可以先檢查可用餘額，再決定是否繼續執行。

管理 Token 與模型推論 API 金鑰的區別

這點非常重要，因為這兩種類型的憑證用途不同，混淆它們會導致令人困惑的錯誤。

模型推論 API 金鑰是用於直接呼叫模型的憑證。如果您要發送聊天完成請求給 GPT-5.5、使用 GPT Image 2 或 Nano Banana Pro 生成影像，或是使用 Veo 3 或 PixVerse V6 渲染影片，您使用的是推論金鑰進行驗證。這些金鑰的權限範圍僅限於進行模型呼叫並回傳模型輸出，無法存取帳戶層級的數據，如餘額或使用量摘要。

管理 Token 是一種專為帳戶操作而設計的獨立憑證類型。它們讓您可以查詢組織整體的資訊：餘額、各 API 金鑰的使用量以及其他帳戶層級的數據。管理 Token 不會直接呼叫任何模型。它是您在 TokenLab 上進行帳戶管理（而非生成作業）時使用的憑證。

將兩者分開有實際的考量：這讓您可以將管理 Token 交給財務或營運流程，而不會讓該流程擁有消耗模型預算的權限。相反地，僅需呼叫 GLM-5.2 或 DeepSeek V4 Flash 的服務不需要查看您的餘額或支出歷史，因此它應該只持有推論金鑰。

餘額查詢的運作方式

新的端點會以簡單明瞭的回應回傳您組織目前的總餘額。您只需使用管理 Token 呼叫它，即可得知目前的狀態。

以下是一個使用佔位符數值的最小範例：

curl -s https://api.tokenlab.sh/v1/management/balance \
  -H "Authorization: Bearer YOUR_MANAGEMENT_TOKEN"

回應會提供您組織目前的餘額數值。通常的作業模式如下：

1. 按排程或在昂貴的作業開始前呼叫餘額端點。
2. 將回傳的數值與您定義的門檻進行比較。
3. 觸發適當的動作：發送警報、暫停佇列、封鎖新的作業提交，或僅記錄以供後續使用。

由於這是一個簡單的讀取操作，頻繁呼叫的成本很低。針對 DeepSeek V4 Pro 或 Claude Sonnet 5 等模型執行高流量管線的團隊，可以在每次大批次作業前檢查餘額，而不會增加顯著的負擔。

完整的端點詳細資訊請參閱 管理 API 餘額參考文件。

適用場景：預算檢查、警報與儀表板

團隊最常要求的用途對應到以下四種場景：

用途	運作方式
作業前預算檢查	指令碼在提交大型批次作業給 Kling 3.0 或 Veo 3 等模型前檢查餘額，若餘額過低則跳過作業
充值提醒	排程檢查將餘額與最低門檻值進行比較，當低於門檻時發送 Slack 或電子郵件警報
工作流程暫停與恢復	當餘額下降時，自動化程式會暫停呼叫 Qwen3.7 Plus 或 GLM-5.2 的管線，充值後再恢復
財務儀表板	按排程提取餘額數值，並與使用量數據一同顯示以供報告使用

如果您是第一次設定此功能，以下檢查清單有助於保持實作的整潔：

• 建立或確認您的管理 Token 具有餘額存取的正確權限範圍
• 將管理 Token 與任何推論 API 金鑰分開儲存
• 設定合理的輪詢間隔（根據您的用途，可以是每次作業、每小時或每天）
• 事先決定您的警報門檻，不要等到餘額不足時才設定
• 若希望在餘額數值之外獲得完整的支出明細，請將餘額查詢與 API 金鑰使用量端點搭配使用

對於除了即時餘額數字外，還需要歷史支出數據的團隊，儀表板使用量匯出文章介紹了如何提取這些數據以供報告使用。

開始使用

如果您已經在使用管理 API 進行使用量報告，新增餘額檢查非常簡單：相同的驗證模式，只需呼叫一個新端點。如果您尚未設定管理 Token，請從您的帳戶設定中產生一個，並將其與您用於呼叫模型的任何推論 API 金鑰分開。

常見問題

餘額查詢是否需要特殊的 API 金鑰？ 不需要，標準的管理 Token 即可。它與用於呼叫模型的推論 API 金鑰是不同的憑證，除了擁有有效的管理 Token 外，無需額外的設定。

我可以使用此功能在餘額用完時自動停止作業嗎？ 可以。這是主要用途之一。在作業前或作業中檢查餘額，如果低於您的門檻，請暫停工作流程、停止佇列或封鎖新的提交，直到餘額恢復為止。

這與使用量端點相同嗎？ 不相同。餘額查詢回傳的是您目前的總餘額。API 金鑰使用量端點回傳的是按金鑰細分的使用量數據。大多數財務儀表板會同時使用這兩者。

來源與時效性

本文反映了截至 2026-07-07 觀察到的管理 API 餘額端點資訊。端點行為和回應格式可能會有所變動；請查看 官方餘額端點文件以獲取最新參考。

---

準備好將餘額檢查整合到您的工作流程中了嗎？登入 TokenLab，產生一個管理 Token，立即開始查詢您組織的餘額。

相關閱讀與下一步

組織餘額查詢功能與 TokenLab 管理 API 中現有的其他報告工具相輔相成。若要深入了解如何定期提取並審核支出數據，請參閱 TokenLab 使用量匯出功能讓 AI API 支出審核更輕鬆。如果您正在規劃發布前的支出，AI API 成本計算器指南：在發布前估算支出將引導您在請求發出前估算成本。此外，若想了解各供應商的比較，2026 年 AI API 定價比較：GPT-5.5、Claude Sonnet 5 與 Gemini 3.5 Flash 的真實成本一文詳細分析了各大模型目前的費率。

一如既往，模型可用性和定價變動頻繁，因此在將其用於高流量生產環境前，請務必確認最新資訊。準備好親自嘗試餘額查詢了嗎？建立 API 金鑰並立即開始測試。