> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 为什么还有余额但调用失败？

> 账户还有余额，请求却报 insufficient_user_quota 或调用失败？先看预扣费是否超过余额，再按调用日志、令牌额度、分组、模型价格、输入规模和上游状态逐项排查。

“还有余额”只说明账户显示了可用额度，不代表本次请求一定满足预扣费、令牌额度、分组和权限要求。最常见的原因是输入太大，请求前预估的费用超过了余额；其次是令牌自己的授权额度用完。

价格、计费单位、可用模型和额度规则可能变化，以控制台和当前日志为准。本页最后核对日期为 **2026 年 10 月 5 日**。

## 最常见的原因：预扣费超过余额

每次请求执行前，系统先按模型价格、输入长度和预计输出长度估算一笔最大可能费用，从余额中临时冻结。请求完成后按实际用量结算，多冻结的部分退回。

* 余额不少于预扣费：请求正常发出。
* 余额少于预扣费：请求在执行前被拒绝，返回 `insufficient_user_quota`，不会调用模型，也不扣费。

报错正文类似：

```text theme={null}
user [12345] quota [50000000] preConsumedQuota [150000000] is not enough
```

* `quota`：账户当前可用余额；
* `preConsumedQuota`：这次请求要预扣的额度；
* 两个数字都是内部额度单位，500,000 约等于 1 美元。上例余额约 \$100，预扣约 \$300，所以被拒绝。

预扣只是按最坏情况预留，不是最终账单。处理办法：

1. 精简输入，只传与任务相关的代码、文档或对话历史；
2. 显式设置输出上限，降低预计输出，见 [max\_tokens 说明](/faq/max-tokens)；
3. 确实需要大输入时，充值到余额高于预扣金额，见[支付方式](/faq/payment-methods)。

<Note>
  **令牌也有自己的授权额度。**

  * 创建令牌时如果关闭了无限额度，令牌的授权额度用完后，即使账户还有余额，这个令牌的请求也会被拒绝。
  * 到[令牌管理](https://api.laozhang.ai/token)编辑该令牌，调高授权额度即可继续使用，不需要更换密钥。
</Note>

## 排查顺序

### 1. 记录实际错误

不要只根据“余额不足”或客户端提示猜测原因。错误正文含 `insufficient_user_quota` 时先按上一节处理。记录：

* 请求时间和时区；
* 模型 ID 与端点；
* API Key 分组；
* HTTP 状态码和平台错误；
* 本次请求是否产生用量或扣费。

### 2. 核对当前价格和计费单位

打开[控制台价格页](https://api.laozhang.ai/account/pricing)，确认目标模型当前按 Token、请求、图片、视频时长或其他单位计费。不要使用上游官网价格或旧文档静态价格推算本次账单。

### 3. 检查输入规模

长上下文、多图片、大文件、PDF、视频或较大的输出上限可能增加预计用量。使用最小输入重试：

* 保留一条短消息；
* 暂时移除图片、文件和工具调用；
* 使用明确且较小的输出限制；
* 不改变其他变量，以便定位原因。

### 4. 检查分组、权限和端点

同一模型名称可能因 API Key 分组、计费类型或端点使用不同线路。确认：

* API Key 是否允许当前模型和计费方式；
* 请求端点是否与文档一致；
* 模型 ID 是否准确；
* 当前账户是否需要站长或支持团队调整权限。

### 5. 区分平台和上游错误

如果最小请求仍失败，检查是否为速率限制、内容安全、上游不可用、超时或临时路由问题。不要无限重试；对非重试类错误先修正参数、权限或余额，对临时错误使用有限次数和退避策略。

## 联系支持时提供什么

* 账户邮箱或用户名；
* 请求时间和时区；
* 模型 ID、端点和 API Key 分组；
* 脱敏后的错误信息和请求标识；
* 控制台余额与价格页截图；
* 最小请求的复现结果。

不要发送完整 API Key、完整 prompt/response 或无关客户资料。

## 退款和余额调整

退款与余额调整按用户协议第 6 节处理，适用条件和申请方式见[支付方式、企业采购与退款说明](/faq/payment-methods)。

## 相关文档

* [如何查看调用日志](/faq/call-logs)
* [如何确认模型是否可用](/faq/model-availability)
* [支付方式、企业采购与退款说明](/faq/payment-methods)
* [余额查询 API](/api-capabilities/balance-query)
* [max\_tokens 是什么？不设置会怎样](/faq/max-tokens)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.