For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
跳至內容

餘額與使用限制問題

排解餘額不足、使用限制、速率限制、意外費用以及相關的 ApiSmart API 錯誤。

當您的帳戶餘額不足,或請求活動達到服務限制時,ApiSmart 請求可能會失敗。

在重試之前,請使用 HTTP 狀態碼與錯誤代碼來判斷原因。

💳 402 — 餘額不足

如果 API 回傳:

402 insufficient_quota

您的帳戶沒有足夠的可用餘額來完成此請求。

在重試之前:

  1. 檢查您目前的錢包餘額。

  2. 查看最近的 API 成本於 使用記錄與成本.

  3. 確認最近的儲值或付款已成功完成。

  4. 如有需要,請加值。

  5. 在有足夠餘額後重新嘗試該請求。

加值不會自動重試先前失敗的 API 請求。

📊 檢查最近使用情況

如果您的餘額低於預期,請開啟:

Console → 使用記錄

檢查:

  • API 金鑰名稱

  • 模型

  • 計費模式

  • 消耗量

  • 費用

  • 狀態

  • 請求 ID

不同的模型類型使用不同的計費方式,因此 消耗量 不一定代表文字 token。

例如,成本可能取決於:

  • 文字 token 用量

  • 生成的圖片數量

  • 影片長度

  • 影片生成 tokens

  • 解析度

  • 模型專屬參數

有關計費規則,請參閱 模型定價與計費.

🔍 非預期的餘額變動

如果您的餘額變動幅度比預期大:

  1. 檢查 使用記錄 中是否有高成本請求。

  2. 篩選依據 API 金鑰, 模型,以及 計費模式.

  3. 尋找重複或重送的請求。

  4. 檢查可能會產生多個輸出的圖片或影片請求。

  5. 將該請求與所選模型的定價規則進行比較。

有關帳戶付款與儲值記錄,請參閱 查看您的餘額與交易記錄.

⚠️ 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 錯誤.

➡️ 下一步

最後更新於

這有幫助嗎?