餘額與使用限制問題
排解餘額不足、使用限制、速率限制、意外費用以及相關的 ApiSmart API 錯誤。
當您的帳戶餘額不足,或請求活動達到服務限制時,ApiSmart 請求可能會失敗。
在重試之前,請使用 HTTP 狀態碼與錯誤代碼來判斷原因。
💳 402 — 餘額不足
如果 API 回傳:
402 insufficient_quota您的帳戶沒有足夠的可用餘額來完成此請求。
在重試之前:
檢查您目前的錢包餘額。
查看最近的 API 成本於 使用記錄與成本.
確認最近的儲值或付款已成功完成。
如有需要,請加值。
在有足夠餘額後重新嘗試該請求。
加值不會自動重試先前失敗的 API 請求。
📊 檢查最近使用情況
如果您的餘額低於預期,請開啟:
Console → 使用記錄

檢查:
API 金鑰名稱
模型
計費模式
消耗量
費用
狀態
請求 ID
不同的模型類型使用不同的計費方式,因此 消耗量 不一定代表文字 token。
例如,成本可能取決於:
文字 token 用量
生成的圖片數量
影片長度
影片生成 tokens
解析度
模型專屬參數
有關計費規則,請參閱 模型定價與計費.
🔍 非預期的餘額變動
如果您的餘額變動幅度比預期大:
檢查 使用記錄 中是否有高成本請求。
篩選依據 API 金鑰, 模型,以及 計費模式.
尋找重複或重送的請求。
檢查可能會產生多個輸出的圖片或影片請求。
將該請求與所選模型的定價規則進行比較。
有關帳戶付款與儲值記錄,請參閱 查看您的餘額與交易記錄.
⚠️ 429 — 速率限制超出
如果 API 回傳:
該請求已達到服務速率限制。這與餘額不足不同。
請勿立即連續重試。
改為:
降低請求頻率
在請求之間加入延遲
使用指數退避
限制自動重試次數
例如:
A 429 回應表示 不 表示您需要加值。
🧩 餘額 vs. 速率限制
402 insufficient_quota
可用餘額不足
檢查餘額並加值
429 rate_limit_error
請求速率限制已達上限
降低速度並稍後重試
先檢查狀態碼通常是判斷您遇到哪種問題的最快方式。
🎬 檢查高成本媒體請求
圖片與影片請求的成本行為可能與文字生成不同。
排查非預期用量時,請檢查:
所選模型
生成的圖片數量
連續圖片生成設定
影片長度
影片解析度
請求是否被重複送出
特別是對於影片模型,像是長度與解析度等參數都可能影響計費,因此當 API 指南建議明確指定值時,請避免依賴預設值。
請參閱 圖片生成 API, 影片生成 API,以及 模型定價與計費 了解詳情。
🔎 如果費用看起來不正確
在 使用記錄與成本 中找出對應請求,並記錄其:
請求 ID
請求時間
模型
計費模式
消耗量
費用
狀態
如果費用仍無法解釋,請聯絡 ApiSmart 支援 並提供相關的請求 ID。
請勿向支援人員提供您的完整 API 金鑰。
✅ 快速疑難排解清單
如果請求因餘額或用量限制而失敗:
檢查狀態是否為
402或429檢查您可用的錢包餘額
查看最近的使用記錄
確認所選模型與計費方式
尋找重複或重送的請求
檢查會影響成本的圖片或影片參數
對於
429請在重試前加值
402請求
如需其他 API 失敗情況,請參閱 HTTP 狀態碼與 API 錯誤.
➡️ 下一步
最後更新於
這有幫助嗎?