GLM Coding Plan 还有额度,为什么扣余额?密钥、端点与 429 排查
分清 Standard、Coding Plan 与旧版 Compatible 密钥,定位 GLM 请求的实际计费来源,区分额度、限流、套餐到期与模型权限问题。
订阅了 GLM Coding Plan,不代表账号中的每把密钥都会消耗套餐额度。 对于 2026 年 10 月 16 日起创建的 Standard 和 Coding Plan 密钥,Z.ai 规定在支持的端点上由密钥类型决定计费。旧版 Compatible 密钥则有另一套与端点相关的规则。
因此,“套餐还有额度”与扣余额或请求失败可以同时发生。本文提供路由与密钥核对表、错误分类器和可控的验证流程,依据 2026 年 11 月 17 日核对的官方文档编写。我们没有进行付费账号计费实验,也没有查看你的账号。
本文扩充 GLM 使用主题,不是 GLM 5.5 发布公告:当天核对的官方公开索引仍列出 GLM-5.3 系列。关于版本状态,请看 GLM 5.5 发布与可用性核查。不要在正常配置中填入猜测的 glm-5.5 ID。
在控制台识别密钥类别
按 Z.ai 的 API Key 管理指南(英文),识别实际工具进程配置的密钥。查控制台标签和创建入口,不要凭密钥字符串的外观判断。一个账号可以同时存在多类密钥。
| 控制台密钥类别 | 来源 | 要核对的计费规则 |
|---|---|---|
| Standard API Key | Standard API Key 创建入口 | 账号余额或适用资源包,不消耗 Coding Plan 额度 |
| 个人 Coding Plan API Key | Personal Coding Plan 入口 | 个人套餐额度 |
| Team Plan Key | Team Coding Plan → My Plan | 团队套餐与席位规则,包括已配置的超额用量策略 |
| 旧版 Compatible 密钥 | 自动归类的历史密钥 | 由端点和账号是否曾有套餐共同决定 |
10 月 16 日公告说明,仅因分类变化,不必替换既有密钥值。属于 Team Plan 项目的旧密钥归为 Team Plan Key;团队项目以外、账号曾拥有 Coding Plan 的合格旧个人密钥归为 Compatible;从未有过套餐的旧账号使用 Standard 分类。专属企业服务或合作渠道的例外情况可能继续遵循合同规则。
排错第一步不是轮换所有密钥。先查清当前实际使用哪一把:终端环境变量、IDE 设置、项目配置或供应商切换工具都可能还引用旧凭据。排错笔记只记非秘密的控制台标签或内部标识,不要把完整密钥贴进工单或公开截图。
按密钥类别套用端点规则
对于新建的 Standard 和 Coding Plan 密钥,在支持的端点间切换不会改变计费类型。Claude Code 中的 Standard 密钥可能扣 API 余额,即使有效 Coding Plan 仍有额度。要消耗套餐额度,应使用对应套餐密钥及受支持的工具配置。
对于旧版 Compatible 密钥,Z.ai 公告给出的规则如下:
| Base URL | 协议或用途 | Compatible 密钥行为 |
|---|---|---|
https://api.z.ai/api/paas/v4 | 标准 Chat Completions | 余额或适用资源包,不用 Coding Plan 额度 |
https://api.z.ai/api/coding/paas/v4 | Coding Plan Chat Completions | 曾有套餐的账号使用套餐额度;套餐到期后停止调用 |
https://api.z.ai/api/anthropic | Anthropic Messages | 按官方 Compatible 表执行同样的套餐历史规则 |
https://api.z.ai/api/v1 | OpenAI Responses | 按官方 Compatible 表执行同样的套餐历史规则 |
公告还说明,从未有过 Coding Plan 的账号在后三类路由上使用余额或资源包。如果你的控制台分类与该情况不符,不要仅凭 URL 推断;请让支持人员核对密钥分类与请求记录。团队超额用量和专属企业安排需要单独按账号确认。
这些是 Z.ai 路由,不代表 BigModel 中国站账号或第三方供应商的计费。Ofox 密钥遵循 Ofox 鉴权规则,不继承你的 Z.ai 订阅。切换前核对 Ofox 模型可用性和对应供应商文档,不要把表里的 URL 复制进 Ofox 配置。
从客户端追到一条请求的用量记录
改配置前,先填写一份小型核对表:
Client and version:
Process actually launched (CLI / IDE / container):
Provider and Base URL:
Protocol (Messages / Chat Completions / Responses):
Exact model ID or alias mapping:
Key class shown in provider console (NO secret value):
Plan active? Remaining quota? Team overage enabled?:
Local timestamp and time zone:
HTTP status / business code / sanitized request ID:
Usage record and billing bucket after the test:
表内依次记录客户端及版本、实际启动进程、供应商与 Base URL、协议、模型 ID 或别名映射、控制台密钥类别(不含密钥值)、套餐与超额用量状态、本地时间及时区、HTTP 状态与脱敏请求 ID,以及测试后的用量记录和计费来源。
暂停其他测试会话,避免混入干扰数据。记录相关套餐用量和余额视图,再仅在认可可能产生费用的情况下,发送一次小型、非敏感请求。例如让已配置模型只返回 READY,不调用工具、不读取仓库。这只验证基本调用,不是质量评测。
随后对照客户端时间、可用的请求标识、所选模型和供应商用量条目。成功响应本身不证明由哪一项余额或额度支付。留出供应商看板的统计延迟;如果归属仍不清楚,停止实验,保存脱敏证据交给支持人员,不要连续发出付费探测。
以下三种结果是说明性示例,不是实测结果:
- 新 Standard 密钥在 Claude Code 中成功调用,并进入标准 API 用量记录。即使套餐还有额度,也符合文档规则。
- 旧 Compatible 密钥在标准 Chat Completions 端点成功调用并扣余额。只改这把旧密钥的路由可能改变计费来源,但不能推广到新建 Standard 密钥。
- 套餐到期的 Compatible 密钥在套餐路由失败。公告说明不会自动切到按量付费。若决定使用 API 余额计费,应创建 Standard 密钥,在受支持端点使用,并确保余额充足;这是计费选择,不是免费回退。
对于新建密钥,换成正确类别,重启实际客户端进程,再做一次受控核对。对于 Compatible 密钥,先决定用套餐还是标准 API 计费,再按文档规则配置。不要同时改密钥、端点、模型和重试策略,否则会丢失判断哪项修改解决问题的证据。
读取 429 内部的业务错误码
Z.ai 的错误码参考(英文)把多种原因都映射为 HTTP 429。通用指数退避循环不能解决所有情况。
| 业务码 | 文档分类 | 有效处理 |
|---|---|---|
1113 | 余额或资源包不足 | 核对计费来源和资金,不要默认套餐额度适用 |
1302 | 请求速率限制 | 降低并发,采用有上限的退避重试 |
1305 | 暂时过载 | 限制重试次数;持续失败则记录 |
1308、1310 | 用量窗口限制 | 读取返回的重置时间,不要按本地午夜推断 |
1309 | Coding Plan 到期 | 查套餐状态,选择获准续费或明确转用标准 API |
1311 | 套餐没有所选模型权限 | 核对模型权限及精确映射 |
1313 | 公平使用限制 | 走供应商支持流程;增加密钥不是解决办法 |
1315 | 密钥仅限企业编程场景 | 使用正确产品类型的密钥和账号配置 |
1316–1321 | 用量窗口叠加额外用量余额或消费上限条件 | 读具体消息,改消费前先查超额资格及已配置限制 |
鉴权错误属于另一分支。例如参考文档中的 1000、1001 对应 HTTP 401。提高额度不能补上缺失的认证头;反过来,反复更换有效密钥也不能恢复到期套餐。
要在本地分类已保存的错误响应,将下方代码保存为 classify_glm_error.py。它从标准输入读取 JSON,只输出错误码和诊断类别,不打印响应消息或任何凭据。
import json
import sys
categories = {
"1000": "authentication", "1001": "authentication",
"1003": "authentication", "1005": "authentication",
"1113": "billing-balance", "1302": "request-rate",
"1305": "temporary-overload", "1308": "usage-window",
"1309": "plan-expired", "1310": "usage-window",
"1311": "model-entitlement", "1313": "fair-usage",
"1314": "enterprise-plan-expired", "1315": "key-product-mismatch",
}
categories.update({str(n): "extra-usage-condition" for n in range(1316, 1322)})
data = json.load(sys.stdin)
error = data.get("error", {}) if isinstance(data, dict) else {}
code = str(error.get("code", "unknown")) if isinstance(error, dict) else "unknown"
print(json.dumps({"code": code, "category": categories.get(code, "inspect-provider-response")}))
本地合成检查:
printf '%s\n' '{"error":{"code":"1311","message":"synthetic example"}}' | python3 classify_glm_error.py
预期类别是 model-entitlement。我们在本地测试了分类器,包括数字错误码和缺失 error 对象。它不诊断网络故障、不展开网关专有响应格式,也不能替代阅读供应商原始消息。返回 unknown 意味着需要查看响应结构,不代表请求成功。对于 SSE 流中途异常终止,Z.ai 文档说明会在 finish_reason 中提供原因,而非这些普通错误码。应单独保存和检查流事件;此 JSON 分类器不解析 SSE。
修好计费后,单独核对模型选择
密钥和路由正确后,独立验证模型精确映射。官方模型切换指南(英文)目前列出 GLM-5.3 和 GLM-5.3-Flash。订阅档位、客户端的 Opus 等别名和公开 API 模型 ID 是三回事。
客户端提示模型不存在时,把配置的 ID、协议与当前供应商文档对照。OpenAI model-not-found 排查指南(英文)中的供应商、端点与权限核对方法可借鉴;它不是 GLM 专属错误的复现记录。Ofox 路由的请求节奏可参考 Ofox 限流文档,但不能把这些限制类推到 Z.ai 账号。
不要用猜测的 GLM 5.5 名称验证套餐。先选账号和路由明确可用的模型,基本调用与计费归属都通过后,再测长 Agent 任务、工具和上下文扩展。
用证据结束排查,不再堆重试
解决记录应明确密钥类别、目标端点、被接受的模型与实际计费来源,并证明修正配置后相关错误已停止。保留旧设置,便于回退配置,而不必重新创建秘密凭据。
如果供应商记录与文档规则矛盾,向支持人员提供含时区的时间、脱敏请求 ID、密钥类别、模型和错误码。没有另外获准的理由和安全通道,不要发送完整凭据或私有提示词。这样才能有效调查计费,而不是再发一批归属不明的请求。
常见问题
- 更换 Base URL,能让新的 Standard 密钥使用 Coding Plan 额度吗?
- 不能。Z.ai 说明,2026 年 10 月 16 日起创建的 Standard 和 Coding Plan 密钥,在支持的端点上由密钥类型决定计费。旧版 Compatible 密钥遵循不同规则。
- GLM 返回 HTTP 429,都应该等一等再重试吗?
- 不是。供应商业务错误码可能表示余额、额度、套餐到期、模型权限或请求限流。先处理明确指出的原因,再考虑重试。


