AI API Credit 自動儲值：TokenLab Auto Recharge 如何防止餘額不足導致的中斷

TokenLab 自動儲值（Auto Recharge）是一項組織層級的帳單設定，當您的餘額低於您設定的門檻時，系統會自動購買更多額度。若設定得當，代理程式迴圈（agent loop）、批次作業或流量激增將永遠不會因為餘額歸零而被迫中斷。本文將詳細說明觸發邏輯的運作方式、信用卡在儲值過程中被拒絕時會發生什麼事、實際的最低與最高金額，以及如何從帳單儀表板開啟此功能。

重點摘要

• 自動儲值功能需由管理員或擁有者從帳單儀表板手動啟用，並針對每個組織進行設定。預設為關閉狀態。
• 預設設定為：觸發金額 $5、恢復金額 $30、每月儲值上限 $300。與儲值相關的最低金額為 $1，每月最高上限為 $10,000。
• 若付款失敗，TokenLab 不會進行靜默重試。系統會停用自動儲值，將交易標記為 payment_failed 或 requires_action，並發送失敗通知郵件。
• 目前沒有公開的 API 或 Webhook 可用於設定或監控自動儲值。設定需透過儀表板進行；監控則透過儀表板狀態、電子郵件及交易紀錄來完成。
• 在啟用自動儲值之前，必須先儲存 Stripe 付款方式。

如何開啟 TokenLab 自動儲值

1. 以組織管理員或擁有者身分登入，並開啟帳單儀表板。
2. 若尚未新增付款方式，請先新增。若未儲存 Stripe 付款方式，則無法啟用自動儲值。
3. 設定「當餘額低於」（觸發金額）。這是會觸發自動儲值的餘額水平。
4. 設定「將餘額恢復至」（恢復金額）。此金額必須大於觸發金額；這是儲值後您的帳戶餘額。
5. 設定每月儲值上限，或保持啟用狀態並確保有足夠的額度以涵蓋至少一個儲值週期。
6. 儲存並確認自動儲值已啟用。儀表板將顯示其目前狀態（啟用中、暫停或已停用）。

如果您未自訂這些欄位，TokenLab 將套用預設值：觸發金額 $5、恢復金額 $30、每月上限 $300。這些預設值適合測試 API 的低流量工作空間。對於生產環境的代理程式或客戶導向的聊天機器人來說，這些數值幾乎肯定太低；請根據您實際使用的模型組合來調整，詳情如下。

模型定價快照：為何儲值金額很重要

正確的觸發與恢復金額取決於您呼叫的模型，因為 TokenLab 目錄中各模型的每 Token 成本差異巨大。若您的恢復金額相對於消耗率設定得太低，您可能會在上次儲值尚未結算完成前，再次觸發儲值。

模型	供應商	輸入 ($/MTok)	輸出 ($/MTok)	Context window	來源	觀察日期
Claude Sonnet 5	Anthropic	$2.00	$10.00	1,000,000	TokenLab 即時定價快照	2026-07-09
GPT-5.5	OpenAI	$5.00	$30.00	1,050,000	TokenLab 即時定價快照	2026-07-09
Gemini 3.5 Flash	Google	$1.50	$9.00	1,048,576	TokenLab 即時定價快照	2026-07-09
DeepSeek V4 Flash	DeepSeek	$0.09	$0.18	1,048,576	TokenLab 即時定價快照	2026-07-09
GLM-5.2	Z.ai	$0.70	$2.20	1,048,576	TokenLab 即時定價快照	2026-07-09

一個主要使用 DeepSeek V4 Flash 進行草稿撰寫，並以 GPT-5.5 進行最終輸出的管線，其消耗額度的速度與完全運行 GPT-5.5 的管線截然不同。如果您的恢復金額是針對低成本模型週設定的，那麼在 GPT-5.5 使用量大的週，將會更頻繁地觸發儲值，且每次儲值都會計入您的每月上限。在鎖定門檻前，請檢查您的實際使用組合。如需查看目錄中的完整費率比較，請參閱定價比較頁面。

準備好為您的工作空間進行設定了嗎？ 請開啟帳單儀表板，根據上述模型組合設定觸發與恢復金額，並在下次生產環境部署前確認您的付款方式。

觸發邏輯的實際運作方式

自動儲值並非以固定計時器輪詢您的餘額。TokenLab 會在每次結算後檢查餘額，並將其與您設定的觸發金額進行比較。如果結算後的餘額低於觸發金額，就會啟動儲值程序。

當符合以下任一條件時，觸發將會被跳過（不執行）：

• 目前餘額已高於觸發金額。
• 該組織已有另一筆自動儲值正在處理中。
• 觸發鎖定（trigger lock）處於啟用狀態（防止在快速連續結算時觸發重複儲值）。
• 帳戶中未儲存付款方式。
• 執行此儲值將超過每月儲值上限。

如果即將超過每月上限，TokenLab 會暫停自動儲值並記錄 lastFailureCode: "monthly_limit_reached"。這是有意的停止而非錯誤：如果您的每月上限設定得低於實際使用量，此機制可保護您免於每月支出失控。若您看到此狀態，請提高每月上限（最高可達 $10,000），或在檢視為何達到上限後手動重新啟用。

當儲值執行時，TokenLab 會建立一張美元計價的 Stripe 發票，並自動從您儲存的付款方式中扣款。

當自動儲值期間信用卡被拒絕時會發生什麼事？

這是決定您是否信任自動儲值以維持生產環境正常運作的關鍵問題，而帳單實作直接回答了這個問題。

付款成功時： TokenLab 會為您的組織餘額儲值一次，將交易標記為完成，在可用時儲存發票或收據 URL，增加您的每月支出總額，保持自動儲值功能為下次啟用，並發送付款成功郵件。

付款失敗或需要客戶操作時（例如 3D Secure 驗證）：TokenLab 會將交易標記為失敗，停用自動儲值，將狀態設為 payment_failed 或 requires_action，記錄失敗詳細資訊，並發送付款失敗郵件。

最後一點比重試次數更重要。TokenLab 不會嘗試對被拒絕的信用卡進行靜默重試，也不會在背景失敗時讓自動儲值悄悄保持啟用。它採取「失敗即關閉」的策略：該功能會自動關閉，並且您會收到一封說明原因的郵件。當餘額歸零時，您的請求仍會停止運作，但您不會在自動儲值無法運作時還誤以為它在保護您。

這對您的營運設定意味著：

• 將付款失敗郵件視為可執行的警報，而非僅是通知。這意味著在您修復付款方式並從儀表板重新啟用之前，自動儲值功能已關閉。
• 保持您儲存的付款方式為最新狀態。過期的信用卡是導致 payment_failed 狀態最可能的原因，且此實作中沒有自動切換至次要信用卡的功能。
• 如果正常運作時間至關重要，請勿僅依賴電子郵件。請建立獨立的餘額檢查機制（如下所述），以免錯過或被過濾的郵件導致未察覺的服務中斷。

是否有自動儲值的 API 或 Webhook？

目前沒有。自動儲值設定（觸發金額、恢復金額、每月上限、付款方式）僅限組織管理員和擁有者透過儀表板進行。目前沒有記錄在案的公開 API 端點可用於以程式設計方式設定這些門檻，也沒有在觸發、成功或失敗事件時觸發的公開 Webhook。

目前存在的客戶端監控介面包括：

• 儀表板狀態： 顯示自動儲值是啟用、暫停還是已停用，並在適用時顯示最後的失敗代碼。
• 電子郵件通知： 低餘額警告以及付款成功/失敗郵件。
• 交易紀錄： 每次儲值嘗試的紀錄、結果，以及在可用時的相關發票/收據連結。

如果您需要為生產系統進行程式化監控，目前的實務替代方案是建立一個排程作業，透過您的儀表板工作階段所提供的任何已驗證讀取權限來檢查組織餘額，並在餘額低於比自動儲值觸發門檻更低的第二門檻時向您的團隊發出警報。即使自動儲值在信用卡失敗後被停用，這也能為您提供獨立的訊號。請勿針對假設的端點或負載格式編寫整合程式碼；如果 TokenLab 記錄了帳單 API 或 Webhook，請在將其納入警報管線之前，先在 API 參考文件中驗證確切的合約。

最低、最高與預設金額

欄位	最低	最高	預設	備註
觸發金額（「當餘額低於」）	$1	低於恢復金額	$5	必須低於恢復金額
恢復金額（「將餘額恢復至」）	$1	受每月上限限制	$30	必須大於觸發金額
每月儲值上限	必須涵蓋一個儲值週期	$10,000	$300	達到此上限後，儲值會以 monthly_limit_reached 狀態暫停

來源：TokenLab 帳單儀表板與自動儲值實作，https://tokenlab.sh/en/dashboard/billing，觀察日期 2026-07-09。

如果您正在執行具有實際爆發風險的生產工作負載，$300 的預設每月上限通常過於保守。單一下午的圖像或影片生成，或代理程式工具呼叫繁忙的一天，很快就會接近該上限。請在評估您的模型組合與典型每日支出後謹慎提高上限，而不是等到工作負載中途被暫停時才處理。

誰應該開啟此功能

自動儲值並非對每個工作空間都是必要的。如果使用量小且可預測，手動儲值即可。若符合以下任一情況，則值得進行設定：

• 自主或半自主代理程式： 在 Claude Sonnet 5 或 Kimi K2.7 Code 等模型上運行的代理程式迴圈可能會不均勻地消耗額度，卡住的迴圈消耗餘額的速度比人類可能注意到的速度更快。
• 客戶導向的聊天機器人： 支援與產品聊天機器人的流量會隨著您產品的使用量而擴展。週末的流量激增不應演變成週一的服務中斷。
• 爆發式生成工作負載： 圖像與影片作業（Nano Banana Pro、Seedance、Veo 3）通常集中在發布或內容批次處理時，單次渲染工作階段的支出可能超過典型的一週。
• 排程批次作業： 過夜或每週的管線正是中途餘額不足導致診斷與重新執行成本高昂的地方。

設定檢查清單

步驟	檢查項目	重要性
確認付款方式為最新	信用卡未過期，已在儀表板驗證	沒有有效的儲存付款方式，儲值無法執行
將觸發金額設為高於每日高峰消耗	基於最繁忙的一天，而非平均值	設定太低，流量激增可能在儲值到帳前耗盡餘額
將恢復金額設為高於每週支出	使用上述模型定價表進行估算	GPT-5.5 密集的一週成本遠高於 DeepSeek V4 Flash 密集的一週
設定具有實際空間的每月上限	預設 $300 對生產環境通常太低	達到上限會以 monthly_limit_reached 狀態暫停自動儲值
將失敗郵件視為警報	將付款失敗郵件路由至值班頻道	自動儲值失敗時會自行停用；沒有其他機制會通知您
新增獨立的餘額監控	在自動儲值觸發門檻之外排程輪詢餘額	目前沒有公開 Webhook；不要僅依賴儀表板的可見性
每週檢視使用量	按模型與專案檢查消耗量	自動儲值消除了中斷風險，而非成本可見性

如需模型成本比較以協助設定門檻，請參閱定價比較頁面；若要將非關鍵呼叫轉移至 DeepSeek V4 Flash 或 Gemini 3.5 Flash 等更便宜的模型，請參閱模型排名頁面。

自動儲值是安全網，而非空白支票

自動儲值解決了一個特定的失敗模式：工作負載中途額度耗盡。它不管理您的預算，而每月上限的存在正是為了確保它不會這樣做。最能從中獲益的團隊會將實際的恢復金額與反映實際使用量的每月上限進行配對，並將失敗郵件路由至人類真正會看到的地方，而不是被忽略的共享收件匣。

限制與考量

• 費用結構： TokenLab 公布的帳單文件中，並未確認自動儲值發票是否包含額度金額以外的任何處理費。請直接檢查您的 Stripe 發票明細項目或帳單條款。
• 處理延遲： 此處未對觸發儲值與新餘額反映在您的帳戶之間的時間進行基準測試。如果工作負載有嚴格的截止期限，請先進行手動儲值並觀察儀表板時間，再依賴自動儲值來應對時間敏感的流量激增。
• 程式化存取： 目前沒有記錄在案的自動儲值設定或事件的公開 API 或 Webhook。如果 TokenLab 新增了此功能，請在進行開發前，在官方 API 參考文件中驗證確切的端點與負載。

常見問題 (FAQ)

是否有 API 可以設定 TokenLab 自動儲值門檻？ 目前沒有。自動儲值由組織管理員或擁有者透過帳單儀表板進行設定。目前沒有記錄在案的公開 API 端點可用於以程式設計方式設定觸發、恢復或每月上限值。

自動儲值的最低與最高金額是多少？ 觸發、恢復及相關金額的最低值為 $1。每月儲值上限最高為 $10,000。預設值為觸發 $5、恢復 $30、每月上限 $300。

如果我的信用卡在自動儲值扣款時被拒絕會怎樣？ TokenLab 會將交易標記為失敗，停用自動儲值，將狀態設為 payment_failed 或 requires_action，記錄失敗詳細資訊，並發送付款失敗郵件。它不會進行靜默重試。

付款失敗後，自動儲值會自動重試嗎？ 目前的實作中沒有內建自動重試功能。相反地，該功能會自行停用並透過電子郵件通知您，以便您修復付款方式並手動重新啟用。

自動儲值預設是開啟的嗎？ 不是。它是每個組織選擇性加入的功能，且在啟用前必須先儲存付款方式。

自動儲值會取代每月支出上限嗎？ 不會。每月儲值上限限制了自動儲值本身在一個月內可以花費的金額，但它是為了維持正常運作的安全網，而非預算工具。請分開檢視使用量。

請從帳單儀表板設定自動儲值，或先在模型頁面比較模型定價，以正確設定您的門檻。