> 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).

# 餘額與使用限制問題

當您的帳戶餘額不足、已達到使用限制，或所選模型需要更多可用額度時，API 請求可能會失敗。

在疑難排解之前，請先確認您的 **目前餘額**、API Token 使用狀態，以及近期請求記錄。

如需詳細的帳單資訊，請參閱 [**了解模型定價與計費**](/documentation/zh-tw/mo-xing-yu-ding-jia/mo-xing-ding-jia-yu-ji-fei.md).

***

### 檢查您的目前餘額

在送出付費 API 請求之前，請確認您的錢包有足夠餘額。

檢查：

* 目前餘額
* 近期充值記錄
* 近期 API 使用量
* 所選模型費用

您可以在以下位置查看餘額：

```
控制台 → 錢包
```

<figure><img src="/files/cf9303afffc3f169dc962cb36b4d2858970cfef7" alt=""><figcaption></figcaption></figure>

如需餘額歷史與付款記錄，請參閱：

[**查看您的餘額與交易記錄**](/documentation/zh-tw/zhang-hu-yu-qian-bao/cha-kan-nin-de-yueyu-jiao-yi-ji-lu.md)

***

### 常見餘額錯誤

#### 餘額不足

餘額不足錯誤通常表示錢包沒有足夠的可用額度來完成該請求。

檢查：

1. 目前餘額
2. 所選模型定價
3. 請求大小或生成設定
4. 近期 API 使用量

可能原因：

* 高成本模型
* 大型輸入請求
* 圖片生成請求
* 影片生成請求
* 多個應用程式共用同一錢包餘額

***

#### 餘額可用但請求仍失敗

如果您的錢包有餘額，但請求仍然失敗，請檢查：

* 是否使用了正確的 API Token
* Token 是否已達到使用上限
* 所選模型是否需要額外存取權限
* 請求本身是否有效

錢包成功充值不代表每一筆 API 請求都一定會成功。

請求還必須通過：

* 驗證檢查
* 模型驗證
* 請求驗證
* 使用限制

***

### API Token 使用限制

API 使用量也可能受到 Token 層級限制的影響。

檢查：

* API Token 狀態
* Token 使用額度
* Token 是否已停用
* 您的應用程式是否使用了多個 Token

如果多個 API Token 屬於同一帳戶，使用量可能會從同一錢包餘額中扣除。

如需 Token 管理，請參閱：

[**建立與管理 API Token**](/documentation/zh-tw/api-quan-zhang/jian-li-yu-guan-li-api-quan-zhang.md)

***

### 非預期的餘額變動

如果您的餘額出現非預期變動，請檢查：

#### 1. 近期 API 請求

開啟：

```
控制台 → 使用記錄
```

<figure><img src="/files/032362f2567318ac67465257328b78f6fb66a850" alt=""><figcaption></figcaption></figure>

檢視：

* 請求時間
* 模型
* 用量
* 費用
* Token 名稱

***

#### 2. 執行中的應用程式

非預期的用量可能來自：

* 背景服務
* 自動化腳本
* 排程任務
* 多個環境使用同一個 API Token

請檢查所有使用您 API Token 的應用程式。

***

#### 3. 高成本模型

不同模型可能有不同的計費方式。

例如：

| 模型類型 | 可能的計費因素  |
| ---- | -------- |
| 文字模型 | 輸入/輸出用量  |
| 圖片模型 | 生成的圖片與設定 |
| 影片模型 | 生成時長與設定  |

在執行大量工作負載之前，務必先查看所選模型的定價。

***

### 充值完成但餘額未更新

如果付款已完成，但您的餘額沒有變動：

1. 重新整理錢包頁面。
2. 檢查 **我的訂單**.

<figure><img src="/files/32031331341891c1a82867583120d99490d4f4e6" alt=""><figcaption></figcaption></figure>

3. 確認您已登入正確的帳戶。
4. 驗證付款狀態。
5. 等待處理完成。

請不要立即再次提交相同付款。

如需與付款相關的問題，請參閱：

[**查看您的餘額與交易記錄**](/documentation/zh-tw/zhang-hu-yu-qian-bao/cha-kan-nin-de-yueyu-jiao-yi-ji-lu.md)

***

### 檢查使用記錄

在調查非預期費用或失敗請求時：

1. 開啟 **使用記錄**.

<figure><img src="/files/032362f2567318ac67465257328b78f6fb66a850" alt=""><figcaption></figcaption></figure>

2. 找出相關請求。
3. 檢視：

* 請求 ID
* 模型
* Token 名稱
* 用量
* 費用
* 狀態
* 錯誤訊息

使用記錄提供最準確的 API 用量紀錄。

***

### 何時聯絡支援

在以下情況請聯絡支援：

* 付款完成後，餘額仍未更新。
* 在餘額足夠的情況下，請求仍然失敗。
* 使用記錄看起來不正確。
* 費用無法透過使用記錄解釋。

請提供：

* 請求 ID
* 訂單 ID（如與付款相關）
* 帳戶電子郵件
* 請求時間
* 模型 ID
* 錯誤訊息
* 相關截圖

請勿提供：

* 完整 API Token
* 帳戶密碼
* 付款憑證

> 🔐 絕不要向支援團隊提供您的完整 API Token。

***

### 🚀 下一步

繼續查看：

* [**查看您的餘額與交易記錄**](/documentation/zh-tw/zhang-hu-yu-qian-bao/cha-kan-nin-de-yueyu-jiao-yi-ji-lu.md)
* [**了解模型定價與計費**](/documentation/zh-tw/mo-xing-yu-ding-jia/mo-xing-ding-jia-yu-ji-fei.md)
* [**使用記錄與費用**](/documentation/zh-tw/api-shi-yong/shi-yong-ji-lu-yu-fei-yong.md)
* [**API Token 與驗證問題**](/documentation/zh-tw/yi-nan-pai-jie/api-quan-zhang-yu-yan-zheng-wen-ti.md)
* [**HTTP 狀態碼與 API 錯誤**](/documentation/zh-tw/yi-nan-pai-jie/http-zhuang-tai-ma-yu-api-cuo-wu.md)
