# GLM Coding Plan 429 报错：1302、1308、1113 等错误码怎么处理

> GLM Coding Plan 的限流、额度用完和策略拦截都返回 429，看响应体错误码：1308/1310 等重置，1302 减少并发，1113 查 Key 类型和 Base URL。

- Source: https://www.aifreeapi.com/zh/posts/glm-coding-plan-429
- Language: zh
- Published: 2026-10-22
- Updated: 2026-10-22
- Publisher: AI Free API (https://www.aifreeapi.com)

GLM Coding Plan 的额度用完、请求太频繁、模型繁忙、套餐到期、Key 用错、触发公平使用限制，返回的 HTTP 状态码都是 429，所以光看 "429" 判断不了原因。要看的是响应体里的业务错误码和报错原文：`1308`、`1310` 表示额度窗口用完，报错里直接写了重置时间，只能等或换路；`1302`「您的账户已达到速率限制，请您控制请求频率」是并发或频率太高，减少并行任务就能缓解；`1113` 在已订阅套餐的账号上出现，多半是 Key 类型或 Base URL 让请求走了按量计费，而不是套餐真的没额度；`1305` 先退避重试，长时间不恢复再查请求内容；`1313` 要去控制台申请解除限制，反复重试没有用。

下面按国内版智谱 BigModel（`open.bigmodel.cn`，控制台在 bigmodel.cn）来讲，国际版 Z.ai（`api.z.ai`）地址或规则不同的地方单独标出。两个平台的账号、控制台、API Key 和 Base URL 互不通用，先确认你订阅的是哪一个。

## 先在 429 响应体里找到错误码和报错原文

智谱开放平台的错误由两层组成：外层是 HTTP 状态码，内层是响应体里的业务错误码和说明，比如：

```json
{"error":{"code":"1302","message":"您的账户已达到速率限制，请您控制请求频率"}}
```

[智谱错误码文档](https://docs.bigmodel.cn/cn/faq/api-code)里，套餐相关的拒绝全部挂在 HTTP 429 下面，区分原因只能靠 `code` 和 `message`。有些工具收到 429 会自动重试或换备用模型，表面上只是变慢、卡住。看原始报错有两个办法，都不离开官方支持的工具：

1. **看工具自己的报错输出和日志**：界面里只显示 429 或 "rate limit"、看不到这段 JSON 时，打开工具的日志，或者开启它的详细输出、调试模式再复现一次，通常能看到完整的响应体。
2. **在官方支持的工具里开一个最小的新会话**：用同一把套餐 Key 和同一个套餐地址，比如新开一个 Claude Code 会话，只发一句"hi"。能正常回复，说明 Key、地址和套餐本身是通的，问题出在原来那个工具发出的请求上（并发、请求内容或它实际用的地址）；同样报 429，就拿到了这次的错误码，按下面的对照处理。

不要为了排查拿套餐 Key 写 curl、脚本或 SDK 直接调接口。套餐额度只能在官方支持的工具里用，[使用须知](https://docs.bigmodel.cn/cn/coding-plan/usage-notes)写明用于非支持工具会被限制权益，Z.ai 的订阅协议也点名了通过 SDK 接入的情况；违规还可能触发限流、冻结等风控处置。

还有两点会影响判断：

- 流式输出（SSE）在推理中途异常结束时，不会返回这些错误码，原因写在响应的 `finish_reason` 里。任务做到一半断掉、却找不到 429 的，先看这个字段。
- 额度剩多少，在控制台 [用量统计](https://www.bigmodel.cn/coding-plan/personal/usage) 看；每次调用扣的是套餐还是余额，在 [费用明细](https://bigmodel.cn/finance/expensebill/list) 的抵扣资源包一列看。

## GLM Coding Plan 429 错误码对照：原因、处理与要不要重试

报错原文取自智谱国内版错误码文档，`${}` 里的内容会替换成实际数值。

| 错误码 | 报错原文（国内版） | 实际原因 | 怎么处理 | 重试有没有用 |
| --- | --- | --- | --- | --- |
| 1302 | 您的账户已达到速率限制，请您控制请求频率 | 并发或请求频率超过当前档位的动态上限 | 减少同时运行的代理和子任务，避开高峰时段 | 退避后重试有用，原样高并发重试没用 |
| 1305 | 该模型当前访问量过大，请您稍后再试 | 模型繁忙；也有用户报告由请求内容触发 | 等几分钟再试；一直不恢复就查请求内容 | 真繁忙时有用，内容触发时没用 |
| 1308 | 已达到 `${number} ${unit}` 的使用上限。您的限额将在 `${next_flush_time}` 重置 | 5 小时额度用完 | 等到报错里的重置时间，或改用按量付费 | 没用 |
| 1310 | 您已达到每周/每月使用上限，您的限额将在 `${next_flush_time}` 重置 | 周（或月）额度用完 | 同上 | 没用 |
| 1316 / 1317 | 已达到 5 小时 / 7 天使用上限。主账号余额不足，无法使用超额按量付费… | 额度用完，超额按量付费因余额不足没能接上 | 充值主账号余额，或等重置 | 没用 |
| 1318–1321 | 已达到 5 小时 / 7 天使用上限，且已达子账号（或企业级）月消费上限… | 额度用完，超额付费撞上月消费上限 | 联系管理员调整上限，或等重置 | 没用 |
| 1113 | 您的账户已欠费，请充值后重试 | 请求按标准 API 计费而余额不足：Key 类型、Base URL、工具或模型不在套餐范围 | 换成套餐 Key，改对 Base URL | 没用 |
| 1309 | 您的 GLM Coding Plan 套餐已到期，暂无法使用… | 套餐到期 | 续订，或新建标准 API Key 按量付费 | 没用 |
| 1311 | 当前订阅套餐暂未开放 `${model_name}` 权限 | 请求的模型不在套餐内 | 改用 GLM-5.3 或 GLM-5.3-Flash | 没用 |
| 1313 | 您的账户当前使用模式不符合公平使用策略，请求频率已受到限制… | 触发公平使用风控 | 在控制台申请解除限制 | 没用 |
| 1314 | 您的企业套餐已失效，请联系企业管理员。 | 企业套餐失效 | 找企业管理员 | 没用 |
| 1315 | 该 API Key 仅限企业编程套餐场景使用，请到官网更换对应产品类型的 API Key | Key 属于企业编程套餐，用错了场景 | 换成对应产品类型的 Key | 没用 |

官方中文表里 1113 写的是「您的账户已欠费，请充值后重试」，也有用户贴出的原文是「余额不足或无可用资源包,请充值」，处理方法一样。用 Z.ai 国际版时报错是英文，常见几条对应关系：1302 是 "Rate limit reached for requests"，1305 是 "The service may be temporarily overloaded, please try again later"，1308 是 "Usage limit reached for … Your limit will reset at …"，1113 是 "Insufficient balance or no resource package. Please recharge."，1313 以 "Your account's current usage pattern does not comply with the Fair Usage Policy" 开头（[Z.ai 错误码文档](https://docs.z.ai/api-reference/api-code)）。

![GLM Coding Plan 429 错误码分四类：1302、1305 退避后重试；1308、1310、1316–1321 等到 next_flush_time；1113、1311、1309 改 Key 或配置；1313、1314/1315 申请解除或找管理员](https://www.aifreeapi.com/posts/zh/glm-coding-plan-429/img/error-code-actions.webp)

## 1308、1310 额度用完：按 next_flush_time 等重置

这两个码说明套餐额度窗口确实用完了。报错原文里的 `next_flush_time` 就是这一档额度恢复的时间点，比自己推算准；在它之前反复重试只会继续收到 429。

截至 2026 年 10 月 22 日，国内版个人套餐（按积分计量的新套餐）的额度如下（[套餐概览](https://docs.bigmodel.cn/cn/coding-plan/overview)）：

| 套餐 | 5 小时积分 | 每周积分 |
| --- | --- | --- |
| Lite | 2,000 | 10,000 |
| Pro | 12,000 | 60,000 |
| Max | 28,000 | 140,000 |

两个窗口的重置方式不同，"5 小时额度几点重置"没有统一答案：

- **5 小时积分是滚动恢复的**：官方写的是"积分额度在请求消耗 5 小时后刷新重置"，哪一刻用掉的积分，5 小时后回来，不是每天固定几个整点。连续高强度用了一下午，额度会在接下来的几个小时里陆续恢复。
- **周积分从下单那一刻算起**，每 7 天刷新一次，和自然周无关。
- 套餐额度用完后，系统不会转去扣你的账户余额或其他资源包，只能等恢复。

### 积分为什么用得这么快

每次调用扣多少积分，官方给的算法是：

> 积分 =（未命中缓存的输入 token × 输入系数 + 缓存命中 token × 缓存系数 + 输出 token × 输出系数）÷ 10,000

GLM-5.3 的系数是 6.9 / 1.7 / 24，GLM-5.3-Flash 是 2.3 / 0.56 / 8，同样的 token 量，GLM-5.3 扣的积分是 Flash 的 3 倍。另外，非高峰时段模型调用按 50% 扣，高峰时段是北京时间周一至周五 14:00–18:00，按全价扣。

拿一个假设的编程代理请求算一下：上下文 80,000 token，其中 70,000 命中缓存、10,000 未命中，输出 2,000 token。

- GLM-5.3，高峰时段：(10,000×6.9 + 70,000×1.7 + 2,000×24) ÷ 10,000 = 23.6 积分。Lite 的 2,000 积分够这样的请求大约 84 次。
- 同一请求放到非高峰：11.8 积分，大约 169 次。
- 换成 GLM-5.3-Flash、高峰时段：7.82 积分，大约 255 次。

代理工具完成一个任务要连续发很多次请求，缓存命中率一掉、输出一长，积分消耗就上去了。实际每次扣了多少，以费用明细里的 token 数为准。

2026 年 7 月 30 日之前订阅、还没到期的老套餐不按积分计，按 prompt 次数估算。Z.ai 国际版公布的老套餐 V2 参考值是 Lite 每 5 小时约 80 次、每周约 400 次，Pro 约 400 / 2,000 次，Max 约 1,600 / 8,000 次，GLM-5.3 在高峰时段按 3 倍计（[Z.ai 套餐调整公告](https://docs.z.ai/devpack/notice/usage-revision)）。自己是哪一版，看控制台套餐页面的标识。

### 等不到重置时能做什么

- **把不需要强推理的步骤换成 GLM-5.3-Flash**：同样的 token 消耗约三分之一的积分。
- **把长任务挪到非高峰**：避开北京时间工作日 14:00–18:00，扣减减半。
- **用额度重置卡**：只在活动期间发放，有的话在用量统计页面能看到；用完后这一档额度回满，重置周期从使用时刻重新算。
- **升级套餐**：国内版升级后积分按新档位立即刷新；续费不会重置积分，也不改变刷新周期。升级要付差价，只在你确实长期不够用时考虑。
- **临时改用按量付费**：见后文"等不了额度重置"一节。

### 1316–1321：超额按量付费也被拦下

这一组码同样是额度用完，报错同时说明"超额按量付费"这条后路也没接上：1316/1317 是主账号余额不足，充值后才能继续按量计费；1318/1319 是子账号月消费上限，1320/1321 是企业级月消费上限，这两类要找管理员调额度。团队套餐的超额付费按团队设置执行；个人套餐如何开通超额按量付费，公开文档里没有说明。

## 1302「您的账户已达到速率限制」：减少并发，不是额度问题

1302 和额度无关，用量统计里还剩很多积分时也会出现。它表示同一时间发出的请求太多，超过了你这一档的速率（并发）上限。

官方对并发的说明只有几条原则（[使用须知](https://docs.bigmodel.cn/cn/coding-plan/usage-notes)）：并发上限与套餐档位相关，Max > Pro > Lite，平台按资源情况动态调整；推荐 Lite 同时只开发一个项目，Pro 1–2 个，Max 2 个以上；低峰期并发会动态提高。具体的并发数和每分钟请求数没有公开，网上流传的数字都没有官方出处。

能做的事：

1. **减少同时跑的代理**：多个终端同时开 Claude Code、开了大量 Subagent、Cline 和 OpenCode 共用一个 Key 同时跑，都会把请求叠在一起。Lite 用户按"一次一个项目"来排。
2. **避开工作日下午**：北京时间周一至周五 14:00–18:00 是高峰，低峰期的并发更宽松。
3. **让工具退避重试**：间隔逐步拉长的重试能等到并发空出来；原样立刻重试只会继续撞上限。
4. **OpenClaw 用户另外注意**：官方说明 OpenClaw 走次级调度，编程代理任务优先抢占资源，高负载时 OpenClaw 任务会被动态排队和限流。

V2EX 上有用户说 Z.ai 的 Lite 套餐几乎没法用，LINUX DO 上也有帖子吐槽智谱套餐日常 429 限流，帖子里提到的是 NewAPI 日志里的大量限流报错，也就是把套餐 Key 接进了中转系统。中转、共享、多人共用本身就违反套餐使用规则，可能直接触发 1313 风控甚至冻结，不能拿来"扩并发"；轮换多个账号或 Key 也一样。并发确实不够用，正路只有降低并行、换时段、升级档位，或者把超出的部分放到按量付费的标准 API 上。

## 1305「该模型当前访问量过大」：不一定是真繁忙

官方对 1305 的说明是模型当前访问量过大，请稍后再试。先按这个处理：等几分钟，让工具拉长间隔重试。

但如果 1305 持续出现，而同一时间别的请求正常，就要怀疑请求内容。GitHub 上有 Hermes Agent 用户报告，在 Z.ai 国际版套餐上，系统提示里只要出现 "Hermes Agent" 这个短语，请求就稳定返回 1305（OpenAI 兼容端点是 HTTP 429，Anthropic 端点是 HTTP 529），把这几个字改掉，同一个 Key、同一个端点立即返回 200（[issue #89278](https://github.com/NousResearch/hermes-agent/issues/89278)）；另一位用户发现对话里以纯文本出现的 `skill_view(...)` 调用写法也会稳定触发（[issue #56816](https://github.com/NousResearch/hermes-agent/issues/56816)）。这些是用户的二分实验结果，Z.ai 没有确认，过滤现在是否还生效、国内版有没有同样的行为，公开资料里都没有说明。Hermes Agent 本身在官方支持的工具列表里，这不是用错工具的问题。

判断方法：

1. 在同一个工具里开一个新会话，不带自定义系统提示、技能和插件，只发一句"hi"。成功而原任务一直 1305，基本可以排除真繁忙。
2. 把系统提示、AGENTS.md / CLAUDE.md 一类的项目说明、技能定义分段去掉再试，缩小到触发的那一段，改写它。
3. 换个时段仍然稳定复现的，带着请求 ID 和报错原文找官方技术支持。

## 有套餐却报 1113 余额不足：查 Key 类型和 Base URL

已订阅套餐、用量统计里也还有积分，却收到 1113「余额不足」，通常不是套餐出了问题，而是这次请求根本没有走套餐，被当成标准 API 按量计费，账户余额又是 0。官方 FAQ 列的原因有三类：工具不在支持列表里、Base URL 不对、调用了套餐外的模型；另外，官网体验中心也不能用套餐额度。

2026 年 10 月 16 日之后，还要加上第一条：**Key 的类型**。

### 10 月 16 日起，Key 类型决定扣哪里的钱

从 2026 年 10 月 16 日起，标准 API、个人套餐、团队套餐的 API Key 分开管理，三类 Key 互不通用（[API Key 分类管理说明](https://docs.bigmodel.cn/cn/coding-plan/notice/api-key-management)）：

- **10 月 16 日及之后新建的 Key**，扣哪类额度只看 Key 类型，和填什么地址无关。在 API Key 页面新建的"标准 API Key"，填进编程工具后永远不用套餐额度，按标准 API 计费扣余额；余额不够，就报 1113。
- **套餐 Key 要从套餐入口建**：个人版在「个人编程套餐 → 套餐概览」，团队版在「团队编程套餐 → 我的套餐」。个人套餐 Key 的入口只在已开通个人套餐的账号、默认组织的默认项目下显示，切到别的组织或项目会找不到。
- **10 月 16 日之前建的 Key** 不用换，系统已自动分类。账号曾经有过套餐的，旧 Key 会标成"兼容"，沿用老规则：扣哪类额度取决于调用的端点。配在 `https://open.bigmodel.cn/api/paas/v4` 上按标准 API 计费，**即使套餐还有剩余额度，也会扣余额**；配在套餐端点上才用套餐额度。

![智谱 API Key 计费路径示意：套餐 Key 扣套餐额度，标准 API Key 扣账户余额，兼容 Key 配在 /api/coding/paas/v4 等套餐端点扣套餐额度、配在 /api/paas/v4 扣余额，余额为 0 时报 1113](https://www.aifreeapi.com/posts/zh/glm-coding-plan-429/img/key-billing-map.webp)

所以排查 1113 的第一步，是去控制台确认工具里填的那把 Key 属于哪一类。最近新建过 Key、又刚好是在"API Key"页面建的，多半就是这个原因。

### 套餐对应的 Base URL

| 用途 | 国内版 BigModel | 国际版 Z.ai |
| --- | --- | --- |
| Claude Code（Anthropic 协议） | `https://open.bigmodel.cn/api/anthropic` | `https://api.z.ai/api/anthropic` |
| Cline、Roo Code、OpenCode、Kilo Code 等（OpenAI Chat Completions） | `https://open.bigmodel.cn/api/coding/paas/v4` | `https://api.z.ai/api/coding/paas/v4` |
| Cherry Studio | `https://open.bigmodel.cn/api/coding/paas/v4/`（末尾带 `/`） | — |
| Codex（OpenAI Responses） | `https://open.bigmodel.cn/api/v1` | `https://api.z.ai/api/v1` |
| 标准 API，不走套餐 | `https://open.bigmodel.cn/api/paas/v4` | `https://api.z.ai/api/paas/v4` |

最常见的错误是把 `/api/coding/paas/v4` 写成 `/api/paas/v4`，少了 `coding` 这一段。用兼容 Key 时，这一处就决定了扣套餐还是扣余额。

### 地址填对了还是 1113

- **工具可能没用你填的地址**：有 Hermes Agent 用户报告，工具某些代码路径把 `/api/paas/v4` 写死了，主对话改对地址后正常，其他功能仍然报 1113（[issue #18302](https://github.com/NousResearch/hermes-agent/issues/18302)）。看工具日志里实际请求的 URL，而不是配置文件里写的。Claude Code 用户可以用 `/status` 核对实际生效的地址，具体步骤见 [Claude Code ANTHROPIC_BASE_URL 不生效：先看 /status 再按报错修复](/zh/posts/claude-code-anthropic-base-url-not-working)。
- **平台串了**：国内版的 Key 填到 `api.z.ai`，或者反过来，都不会走套餐。
- **工具不在支持列表**：套餐只能在官方支持的工具里用，包括 Claude Code、Codex、OpenCode、Cline、Roo Code、Kilo Code、Cursor、TRAE、Hermes Agent、OpenClaw 等，完整列表以[官方工具页](https://docs.bigmodel.cn/cn/coding-plan/tool/others)为准。
- **最后用费用明细验证**：改完后在工具里正常发一次请求，到费用明细的抵扣资源包一列看是不是套餐抵扣的。

## 1309、1311、1314、1315：套餐到期或模型、Key 不对应

这几个码都说明请求不在当前套餐的覆盖范围内，等待和重试都没用，要改的是订阅或配置。

- **1309 套餐已到期**：到 [bigmodel.cn/claude-code](https://bigmodel.cn/claude-code) 续订后恢复。注意，兼容 Key 在套餐到期后不会自动转成按量计费，在套餐端点上会直接中断；想先按量用着，要新建一把标准 API Key 替换进工具，官方说明原调用地址可以不变，账户里要有余额。
- **1311 套餐未开放该模型**：所有套餐支持 GLM-5.3 和 GLM-5.3-Flash。请求 GLM-5.2、GLM-5.1 会自动切到 GLM-5.3，GLM-5-Turbo、GLM-4.7 会自动切到 GLM-5.3-Flash；报 1311 说明工具里配了这些之外的模型名，改回套餐支持的模型。
- **1314 企业套餐已失效**、**1315 Key 仅限企业编程套餐场景**：这是企业账号的问题，前者找企业管理员，后者换成对应产品类型的 Key。

## 1313 公平使用限制：在控制台申请解除，别换号硬刷

1313 的完整原文是「您的账户当前使用模式不符合公平使用策略，请求频率已受到限制。详情请参阅《条款与协议-订阅及自动续费协议》，如需恢复请前往个人中心-编程套餐总览-顶部申请解除限制」。它是风控处置，不会因为等一会儿或重试就消失。

处理步骤：

1. 打开控制台的 [套餐概览](https://www.bigmodel.cn/coding-plan/personal/overview)，查看风控提示，按页面顶部的入口申请解除限制或发起申诉。
2. 对照使用规范自查：套餐只限订阅人本人、只限官方支持的工具；接进自建应用、网站、机器人或 SaaS，共享账号，转售或中转，都属于违规。
3. 有异议的，通过官方客服渠道申诉，附上报错原文和请求 ID，不要发送完整 API Key。

触发 1313 的具体阈值和判定逻辑，官方明确表示不公开。违规会被限流、冻结，3 次以上可能封号；用小号、轮换 Key 或中转池绕开，只会让后果更重。

## 等不了额度重置：改用标准 API Key 按量付费

额度窗口用完、任务又不能停，官方路线是临时改用标准 API 按量付费：

1. 在控制台的 [标准 API Key 页面](https://bigmodel.cn/usercenter/proj-mgmt/apikeys) 新建一把标准 API Key，确认账户有余额或可用的普通资源包。
2. 把工具里的套餐 Key 换成这把标准 Key。按 10 月 16 日的新规则，标准 Key 在支持的端点上一律按标准 API 计费，不消耗也不会恢复套餐额度。
3. 额度恢复后换回套餐 Key，避免继续扣余额。

国内版标准 API 的人民币价格以控制台当日显示为准。Z.ai 国际版按量价格是 GLM-5.3 每百万 token 输入 $1.4、缓存命中输入 $0.26、输出 $4.4（[Z.ai 价格页](https://docs.z.ai/guides/overview/pricing)）。GLM-5.3-Flash 的 API 接入和成本，可以参考 [GLM-5.3-Flash：Ox Alpha 迁移、API 成本与本地部署条件](/zh/posts/glm-5-3)。

如果你需要一个不依赖智谱账户的按 token 付费备选，[laozhang.ai](https://api.laozhang.ai/) 提供 `glm-5.2`，输入每百万 token $1.142、输出 $3.997，支持 Anthropic Messages 和 OpenAI 兼容两种接口，Claude Code 里把 `ANTHROPIC_BASE_URL` 设为 `https://api.laozhang.ai` 即可（[模型列表](https://docs.laozhang.ai/models)）。需要清楚它的边界：模型是 GLM-5.2 而不是套餐里的 GLM-5.3，单独计费、有自己的限额，和你的 Coding Plan 额度没有关系，既不会消耗、也不能恢复套餐额度，解决不了套餐本身的 429。

如果频繁 1302 或额度不够已经影响工作，换模型也是一个选项，两条路线的接入、成本和代理能力对比见 [GLM-5.3 与 DeepSeek V4 Pro 怎么选：接入、成本与 Agent 能力](/zh/posts/glm-5-3-vs-deepseek-v4-pro)。

## GLM Coding Plan 429 常见问题

### GLM Coding Plan 的 5 小时额度几点重置？

没有固定时间点。5 小时积分在每次消耗 5 小时后滚动恢复，周积分从下单时起每 7 天刷新。最准的时间是 1308、1310 报错原文里的 `next_flush_time`，或者控制台用量统计页面显示的进度。

### 明明还有额度，为什么还是 429？

额度只对应 1308、1310 这类错误。用量统计还有积分时收到 429，常见的是 1302（并发太高）、1305（模型繁忙或请求内容触发）、1113（Key 或 Base URL 让请求走了按量计费）和 1313（公平使用限制），先看错误码再处理。

### 套餐额度用完会不会扣账户余额？

不会。套餐额度耗尽后只能等恢复，系统不会转去扣余额或其他资源包。真正会扣余额的是两种配置：在编程工具里用了标准 API Key，或者兼容 Key 配在了 `/api/paas/v4` 标准端点上，这两种从第一次请求起就按量计费。

### 智谱国内版的 Key 能在 Z.ai 上用吗？

不能。国内版（`open.bigmodel.cn`）和国际版 Z.ai（`api.z.ai`）是两套账号和控制台，Key、套餐、Base URL 都不通用。

### NVIDIA 上调用 GLM 报 429，和 Coding Plan 有关系吗？

没有关系。NVIDIA 托管的 GLM 端点有自己的速率限制，开发者论坛上也有人反映容易触发 429，但它不消耗也不受 GLM Coding Plan 额度影响，按 NVIDIA 那边的规则处理。