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 KeyStandard API Key 创建入口账号余额或适用资源包,不消耗 Coding Plan 额度
个人 Coding Plan API KeyPersonal Coding Plan 入口个人套餐额度
Team Plan KeyTeam 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/v4Coding Plan Chat Completions曾有套餐的账号使用套餐额度;套餐到期后停止调用
https://api.z.ai/api/anthropicAnthropic Messages按官方 Compatible 表执行同样的套餐历史规则
https://api.z.ai/api/v1OpenAI 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用量窗口限制读取返回的重置时间,不要按本地午夜推断
1309Coding 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,都应该等一等再重试吗?
不是。供应商业务错误码可能表示余额、额度、套餐到期、模型权限或请求限流。先处理明确指出的原因,再考虑重试。