glm5.3如何使用？GLM-5.3 的官方使用入口分两条主线。只想先试效果，走 open.bigmodel.cn 的体验中心，不需要 API Key；要自己写代码调用，走标准 API，模型编码 glm-5.3，官方给了 3 个协议端点（OpenAI Chat Completion、OpenAI Response、Anthropic Message）；要在编码工具里用，走 GLM Coding Plan 订阅套餐，官方文档目前列出 22 款可接入工具。还有一条最容易踩的规则写在模型页上：GLM-5.3 始终开启思考，不再支持关闭。
GLM-5.3 的 4 类官方入口怎么区分
搜「GLM-5.3 怎么用」最容易踩的坑，是把几条通道当成一回事。官方目前给出的是四类互不替代的入口，选的依据是「你要不要拿 Key、按什么方式付钱」。
| | | | |
|---|
| bigmodel.cn/trialcenter 下的文本模型入口 | | | |
| open.bigmodel.cn，3 个协议端点见下节 | | | |
| | | | |
| | | | 想要开箱即用的 Agent 工作台、不想自己拼工具链 |
注意区分：前两类吃的是「平台按量计费」，后两类吃的是「Coding Plan 套餐额度」，两套钱的账户不一样，端点也不一样。
四个容易被忽略的边界条件
- 体验中心不能用编码套餐。官方常见问题页写明「官网体验中心不支持使用编码套餐」，在体验中心试出来的效果与套餐额度无关。
- 团队版 Key 与平台 Key 不通用。官方在快速开始与工具接入页都加了一句「团队套餐 Key 与平台其他 API Key 不通用，使用团队额度请务必使用团队套餐 Key」。
- 配错端点会扣错钱。官方在接入工具页用警告块写明「错误配置端点将导致无法使用 GLM Coding Plan 套餐额度」；常见问题里对应的现象是余额被扣或报「1113 余额不足」。
- 订阅过套餐的账号有协议限制。GLM-5.3 模型页写明：如果你订阅过 GLM Coding Plan（含已过期），暂时只能通过 OpenAI Chat Completion 协议调用模型 API。
拿到 API Key 并跑通第一次调用
标准 API 的接入流程官方写在《HTTP API 调用》与《快速开始》两页里，可归纳为五步。整个过程不需要预充值，但需要实名与一把 Key。
- 注册账号：访问 open.bigmodel.cn，点右上角「注册/登录」，用手机号或微信扫码完成注册。
- 实名认证：进入控制台完成实名，未实名的账户可能无法解锁赠送额度，调用时会提示额度不可用。
- 新建密钥：进入【API Keys】管理页面新建，得到一串 sk- 开头的字符串；赠送额度是否到账可在【财务】→【资源包】核对。
- 立即复制保存：完整密钥只在创建时显示一次，关闭页面后无法再查看，丢了只能删除重建。
- 选端点、填模型编码：把 Base URL 与模型编码 glm-5.3 填进代码或客户端，发起第一次调用。
用 cURL 发一次最小请求（把 YOUR_API_KEY 换成上一步保存的密钥）：
换成官方 Python SDK（pip install zai-sdk），结构完全一致：
第一次调用最容易写错的三个参数
- 不要关思考。GLM-5.3 与 GLM-5.3-Flash 的 thinking.type 只接受 enabled，传 disabled 会直接报错——官方深度思考页与模型页都单独写了这条提示。
- 推理档位只有三档。reasoning_effort 仅支持 low、high、max，默认 max，其余输入会报错。官方建议复杂编码任务直接用 max。
- 采样参数只调一个。temperature 默认 1.0、top_p 默认 0.95，官方迁移清单明确建议两者只选一个调参，不建议同时改。
模型规格、3 个协议端点与官方 SDK 版本
GLM-5.3 系列目前有两个可调用编码，都属于旗舰表，但在输入模态上分工不同。
标准 API 一共开放三个协议端点，官方在 GLM-5.3 模型页的「如何使用」一节逐条列出：
| | |
|---|
OpenAI Chat Completion 协议 | https://open.bigmodel.cn/api/paas/v4 | |
| https://open.bigmodel.cn/api/v1 | 用 Response 形态接口的客户端（如 Codex） |
| https://open.bigmodel.cn/api/anthropic | 已有 Anthropic SDK 代码、想改两行就切过来的人 |
三套官方 SDK 里，Python 有两代包名，新旧并存。下表第三列是文档与示例里写的版本号，第四列是用包管理器实测的最新版本：
| | | |
|---|
| | 模型页示例写 0.2.3，SDK 文档页提示「最新 0.2.2」 | |
| | | |
| | | |
三个用 Key 之前该知道的安全动作
- 不要硬编码。官方在 HTTP 调用页、Claude 兼容页、快速开始页三处都重复了同一句建议——把 API Key 设为环境变量，不要直接写在代码里。
- 不要提交进仓库。密钥只显示一次，一旦随代码推送出去，就只能删除重建。
- 两套 Key 别混用。套餐 Key 走套餐额度，平台 Key 走按量余额；用错的那把不会被拦下，而是按错误的账户扣费或直接报错。
一次调用的钱按几段算：官方计费公式与单价
智谱开放平台的模型推理采用按量计费，官方定价页把计费拆成四段：调用费用 = 未命中缓存的输入费用 + 缓存命中费用 + 输出费用 + 缓存存储费用。单价统一按「元/百万 tokens」展示。
换算口径有两处值得记一下：
- Token 与汉字：官方定价页写明「GLM 系列模型的 Token 与汉字数量换算比例约为 1:1.6」，实际数量以接口返回的用量信息为准。
- 批处理打五折：支持 Batch API 的模型按对应标准调用价格的 5 折计费，适合大规模、非实时的任务。
按上表自算一个示例（非官方账单样例，仅为量级参考）：10 万输入 tokens 加 2,000 输出 tokens、全部未命中缓存的单次调用——GLM-5.3 约 0.856 元（0.1×8 + 0.002×28），GLM-5.3-Flash 约 0.0856 元（0.1×0.8 + 0.002×2.8），两者相差约 10 倍。
注意：GLM-5.3 本身不在免费清单里
官方定价页上单价标为「免费」的模型有多款（文本、视觉、图像生成、视频生成各有一批），但都是 GLM-4.x 或 Cog 系列，GLM-5.3 与 GLM-5.3-Flash 均为付费模型。宣传里的「0 元」指的是这些常驻免费模型，不是旗舰模型；免费模型清单以官方定价页当日展示为准。
GLM Coding Plan 的积分怎么算
GLM Coding Plan 是订阅制，新版（2026 年 7 月 30 日起上线）采用积分制，同时设每 5 小时与每周两道上限。
积分不是按 token 一比一扣的，而是走一套抵扣系数：
把这套系数代入对比一下：GLM-5.3 的输入系数是 Flash 的 3 倍、输出系数是 3 倍，缓存命中系数是约 3.04 倍——同一份工作量，选 GLM-5.3 大约要花 Flash 的 3 倍积分，这个倍数直接决定套餐能撑多久。
四条影响可用量的规则
- 非高峰半价：非高峰时段的模型调用按基础积分消耗的 50% 抵扣；高峰时段为每周一至周五 14:00 至 18:00（UTC+8），周末全天算非高峰。
- 两套刷新节奏：5 小时积分用动态刷新（请求消耗 5 小时后重置），周积分自套餐下单时起以 7 天为一个周期。
- 额度耗尽不会扣余额：官方写明套餐额度用完后需等下一个 5 小时周期恢复，系统不会继续消耗其他资源包或账户余额（团队版可另行开启超额按量付费）。
- 存在两代套餐口径：新版按积分计，历史 V1／V2 套餐按「次 prompt」计（Lite 约 80 次/5 小时、400 次/周；Pro 约 400／2000；Max 约 1600／8000）。看第三方教程时要先确认它讲的是哪一代。
套餐订阅价的处理方式需要单独说一句：官方文档只公布了积分额度与抵扣系数，新版套餐的具体价格以订阅页面展示为准，文档里没有列出金额；可以核到金额的是历史 V2 版套餐价——Lite 49 元、Pro 149 元、Max 469 元（包月），包季 9 折、包年 8 折。
编码套餐的 22 款接入工具清单
GLM Coding Plan 的额度只能在官方指定工具里用。官方《接入工具》页把可接入对象分成两组，合计 22 款。
| | | |
|---|
| | | |
| | |
| | Claude Code 的 IDE 插件，支持 VS Code 与 JetBrains |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | | 深度适配 GLM 的工作助手，含法律、金融领域知识库 |
| | 可在本地运行的开源 AI 助手，支持 Skills 扩展 |
| | |
| | |
接入动作本身只有三步：选协议 → 配 Base URL → 填 Key 与模型编码。编码套餐的端点与标准 API 有一处不同，这是最常见的翻车点：
| | |
|---|
OpenAI Chat Completion 协议 | https://open.bigmodel.cn/api/coding/paas/v4 | https://open.bigmodel.cn/api/paas/v4 |
| https://open.bigmodel.cn/api/v1 | https://open.bigmodel.cn/api/v1 |
| https://open.bigmodel.cn/api/anthropic | https://open.bigmodel.cn/api/anthropic |
换句话说：OpenAI Chat Completion 这条路上，套餐比标准 API 多一段 coding；另外两条协议两者共用同一个地址。官方常见问题里还留了一处写法差异——Cherry Studio 配置的 Base URL 写作 https://open.bigmodel.cn/api/coding/paas/v4/（带尾斜杠），而 Claude Code 之外的其他工具写作 https://open.bigmodel.cn/api/coding/paas/v4（不带）。
两个省事的动作
- 用一键安装助手：官方提供命令行助手 @z_ai/coding-helper（npm 包，实测最新 0.1.1，国内镜像已同步），前提是 Node.js 18 及以上。运行 npx @z_ai/coding-helper 可自动完成工具安装、套餐配置与 MCP 服务器管理，目前支持 Claude Code、Codex、OpenCode、Crush、Factory Droid。
- 用官方脚本配 Claude Code：macOS／Linux 下执行官方给的 claude_code_env.sh 脚本，会自动改写 ~/.claude/settings.json；Windows 走手动配置。配完必须新开一个终端窗口才生效。
顺带一个默认值提醒：在 Claude Code 里，ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL 三个环境变量，官方给的默认值都是 GLM-5.3-Flash。想跑 GLM-5.3 需要自己改，或者在会话里用 /effort 之外的方式显式指定模型。
从 GLM-5.2 迁移到 GLM-5.3 的 5 个必改项
官方专门写了一页《迁移至 GLM-5.3》和一份迁移清单。清单里最要命的一条是思考开关——不改正会直接让请求失败。
| | |
|---|
| | |
| thinking.type 可传 disabled 关闭思考 | 只能 enabled；传 disabled 会报错，改法是把 reasoning_effort 设为 low |
| 接受 max／xhigh／high／medium／low／minimal／none | |
| | temperature 默认 1.0、top_p 默认 0.95，官方建议只调一个 |
| | 要拿工具参数的实时流，需同时开 stream=true 与 tool_stream=true |
编码套餐侧的档位还会被二次映射
在 Coding Plan 通道里，官方文档说明传入值会被映射到实际档位：none／minimal／low 一律映射为 low，medium／high 映射为 high，xhigh／max 映射为 max；未知字符串回退默认档。处理优先级是显式 effort > thinking 开关 > 默认 max——也就是说，你以为关掉了思考，实际只是降到了 low，模型仍在轻量思考。
接入报错速查表
GLM 调用返回的是「外层 HTTP 状态码 + 内层业务错误码」两层结构，业务码更具体。下表取自官方《错误码》页，按接入阶段排列：
| | | |
|---|
| | Header 中未收到 Authentication 参数 | |
| | | |
| | | 充值；套餐用户同时检查端点是否配成了标准 API 地址 |
| | | |
| | | |
| | | 压缩上下文或拆分请求，注意 1M 是输入输出合用的额度 |
| | | |
| | | 降并发、加队列；通用 API 可申请提额，编码套餐不支持 |
| | | |
| | | |
| | | |
| | | |
还有一类不属于上表：使用流式（SSE）调用时，如果推理过程中异常终止，不会返回业务错误码，而是在响应体的 finish_reason 字段里返回异常原因。
关于并发限制，两类用户走两套规则：通用 API 按用户权益等级与模型维度设并发上限，可在控制台的速率限制页查看，确有需要可通过表单申请提额（官方说明 10 个工作日内完成审核）；编码套餐用户的并发与套餐等级绑定，官方建议的项目数是 Lite 单个、Pro 1 至 2 个、Max 2 个以上，并明确写「暂不支持申请调整」。
GLM-5.3 常见问题
Q：GLM-5.3 免费吗？多少钱？
不免费。官方定价页上 GLM-5.3 是输入 8 元、输出 28 元、缓存命中 2 元每百万 tokens，GLM-5.3-Flash 是 0.8／2.8／0.23 元。定价页里标「免费」的是 GLM-4.x 与 Cog 系列的一批模型，不含 GLM-5.3。
Q：只是想试试效果，怎么用最省事？
走开放平台的体验中心，网页里直接选模型试用，不需要创建 API Key。官方常见问题里有一条相关限制：官网体验中心不支持使用编码套餐，也就是说体验中心的试用与套餐额度是两件事。
Q：在 Claude Code 里怎么换成 GLM-5.3？
先订阅 GLM Coding Plan 并拿到套餐 Key，再把 Base URL 配成 https://open.bigmodel.cn/api/anthropic。官方脚本会自动改写 ~/.claude/settings.json，配完要新开一个终端窗口；启动后用 /status 确认当前模型，会话内可用 /effort 切换思考强度（默认 max）。
Q：为什么配好了套餐，还是提示余额不足？
大多是端点配错了。编码套餐的 OpenAI 兼容端点是 https://open.bigmodel.cn/api/coding/paas/v4，比标准 API 多一段 coding；Claude Code 用 /api/anthropic。另外团队版套餐 Key 与平台其他 Key 不通用，用平台 Key 走套餐也会失败。
Q：GLM-5.3 能关掉思考、让它答得快一点吗？
不能完全关掉。GLM-5.3 与 GLM-5.3-Flash 的 thinking.type 只接受 enabled，传 disabled 会报错；想快点只能把 reasoning_effort 设成 low，但模型仍会轻量思考。
Q：1M 上下文和 128K 输出，是两个额度可以相加吗？
不是两份额度。官方在模型页写的是「支持 1M 上下文窗口，最大输出 Tokens 为 128K」，而 GLM 系列的计费公式也是把缓存命中与未命中的输入、加上输出分别计费。做容量规划时按「一次请求的输入加输出受 1M 约束、输出另有 128K 上限」来理解，不要相加。
Q：套餐额度用完了会自动扣我账户余额吗？
个人版不会。官方写明「套餐额度耗尽后，需要等待下一个 5 小时周期恢复额度，系统不会继续消耗您的其他资源包/账户余额」。团队版是例外：可开启超额按量付费，官方写按模型 API 刊例价的 9 折计费（限时优惠）。
Q：报 1302 和报 1305 有什么区别？
1302 是账户自己的并发或频率超了上限，降并发、加队列就能解；1305 是平台模型侧整体访问量过大触发的保护机制，与你的调用行为无关，只能增加重试间隔、稍后再试。
Q：企业把代码交给它，数据会被拿去训练吗？
官方在团队版权益页写明「数据默认不用于模型训练」：提交的代码、提示词、对话内容等不会用于模型训练，企业认证后可开具企业专票，管理员还能设置 IP 白名单限制访问来源。通用 API 侧的内容安全与合规要求，另见官方《内容安全》与《模型备案》两页。
AI 速览
