> For the complete documentation index, see [llms.txt](https://docs.apismart.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apismart.ai/documentation/zh-tw/yi-nan-pai-jie/yueyu-shi-yong-xian-zhi-wen-ti.md).

# 餘額與使用限制問題

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

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

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

### 💳 402 — 餘額不足

如果 API 回傳：

```
402 insufficient_quota
```

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

在重試之前：

1. 檢查您目前的錢包餘額。
2. 查看最近的 API 成本於 [**使用記錄與成本**](https://docs.apismart.ai/documentation/zh-tw/api-shi-yong-liang/shi-yong-ji-lu-yu-cheng-ben.md).
3. 確認最近的儲值或付款已成功完成。
4. 如有需要，請加值。
5. 在有足夠餘額後重新嘗試該請求。

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

### 📊 檢查最近使用情況

如果您的餘額低於預期，請開啟：

**Console → 使用記錄**

<figure><img src="https://3482803098-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9rNjqyBvjfy7u1IjU03v%2Fuploads%2FwOQkyYYrOUx09fnk34Il%2F%E5%B1%80%E9%83%A8%E6%88%AA%E5%8F%96_20260822_200442.png?alt=media&amp;token=bf4a6e0a-799e-40a6-8896-0b34bdcfec5f" alt=""><figcaption></figcaption></figure>

檢查：

* API 金鑰名稱
* 模型
* 計費模式
* 消耗量
* 費用
* 狀態
* 請求 ID

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

例如，成本可能取決於：

* 文字 token 用量
* 生成的圖片數量
* 影片長度
* 影片生成 tokens
* 解析度
* 模型專屬參數

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

### 🔍 非預期的餘額變動

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

1. 檢查 **使用記錄** 中是否有高成本請求。
2. 篩選依據 **API 金鑰**, **模型**，以及 **計費模式**.
3. 尋找重複或重送的請求。
4. 檢查可能會產生多個輸出的圖片或影片請求。
5. 將該請求與所選模型的定價規則進行比較。

有關帳戶付款與儲值記錄，請參閱 [**查看您的餘額與交易記錄**](https://docs.apismart.ai/documentation/zh-tw/zhang-hu-yu-qian-bao/cha-kan-nin-de-yueyu-jiao-yi-ji-lu.md).

### ⚠️ 429 — 速率限制超出

如果 API 回傳：

```
429 rate_limit_error
```

該請求已達到服務速率限制。這與餘額不足不同。

請勿立即連續重試。

改為：

* 降低請求頻率
* 在請求之間加入延遲
* 使用指數退避
* 限制自動重試次數

例如：

```
1 秒 → 2 秒 → 4 秒 → 8 秒
```

A `429` 回應表示 **不** 表示您需要加值。

### 🧩 餘額 vs. 速率限制

| 錯誤                       | 含義         | 建議操作      |
| ------------------------ | ---------- | --------- |
| `402 insufficient_quota` | 可用餘額不足     | 檢查餘額並加值   |
| `429 rate_limit_error`   | 請求速率限制已達上限 | 降低速度並稍後重試 |

先檢查狀態碼通常是判斷您遇到哪種問題的最快方式。

### 🎬 檢查高成本媒體請求

圖片與影片請求的成本行為可能與文字生成不同。

排查非預期用量時，請檢查：

* 所選模型
* 生成的圖片數量
* 連續圖片生成設定
* 影片長度
* 影片解析度
* 請求是否被重複送出

特別是對於影片模型，像是長度與解析度等參數都可能影響計費，因此當 API 指南建議明確指定值時，請避免依賴預設值。

請參閱 [**圖片生成 API**](https://docs.apismart.ai/documentation/zh-tw/api-zhi-nan/tu-pian-sheng-cheng-api.md), [**影片生成 API**](https://docs.apismart.ai/documentation/zh-tw/api-zhi-nan/ying-pian-sheng-cheng-api.md)，以及 [**模型定價與計費**](https://docs.apismart.ai/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-jia-ge-yu-ji-fei.md) 了解詳情。

### 🔎 如果費用看起來不正確

在 [**使用記錄與成本**](https://docs.apismart.ai/documentation/zh-tw/api-shi-yong-liang/shi-yong-ji-lu-yu-cheng-ben.md) 中找出對應請求，並記錄其：

* 請求 ID
* 請求時間
* 模型
* 計費模式
* 消耗量
* 費用
* 狀態

如果費用仍無法解釋，請聯絡 [**ApiSmart 支援**](https://docs.apismart.ai/documentation/zh-tw/shuo-ming-yu-zi-yuan/lian-luo-zhi-yuan.md) 並提供相關的請求 ID。

請勿向支援人員提供您的完整 API 金鑰。

### ✅ 快速疑難排解清單

如果請求因餘額或用量限制而失敗：

* 檢查狀態是否為 `402` 或 `429`
* 檢查您可用的錢包餘額
* 查看最近的使用記錄
* 確認所選模型與計費方式
* 尋找重複或重送的請求
* 檢查會影響成本的圖片或影片參數
* 對於 `429`
* 請在重試前加值 `402` 請求

如需其他 API 失敗情況，請參閱 [**HTTP 狀態碼與 API 錯誤**](https://docs.apismart.ai/documentation/zh-tw/yi-nan-pai-jie/http-zhuang-tai-ma-yu-api-cuo-wu.md).

### ➡️ 下一步

* [**模型定價與計費**](https://docs.apismart.ai/documentation/zh-tw/mo-xing-yu-jia-ge/mo-xing-jia-ge-yu-ji-fei.md)
* [**使用記錄與成本**](https://docs.apismart.ai/documentation/zh-tw/api-shi-yong-liang/shi-yong-ji-lu-yu-cheng-ben.md)
* [**查看您的餘額與交易記錄**](https://docs.apismart.ai/documentation/zh-tw/zhang-hu-yu-qian-bao/cha-kan-nin-de-yueyu-jiao-yi-ji-lu.md)
* [**加值並了解錢包點數**](https://docs.apismart.ai/documentation/zh-tw/zhang-hu-yu-qian-bao/jia-zhi-yu-liao-jie-qian-baoedu.md)
* [**HTTP 狀態碼與 API 錯誤**](https://docs.apismart.ai/documentation/zh-tw/yi-nan-pai-jie/http-zhuang-tai-ma-yu-api-cuo-wu.md)
