GLM API 由智谱（智谱华章，港交所代码 02513.HK）开放平台提供，官方入口是 open.bigmodel.cn，注册并完成实名认证后即可在控制台生成 API Key。通用调用端点为 https://open.bigmodel.cn/api/paas/v4/，天然兼容 OpenAI SDK，改一行 base_url 就能复用现有代码。平台上有 GLM-4.7-Flash、GLM-4.6V-Flash 两个完全免费的模型，新用户注册还可获得赠送额度；最新旗舰 GLM-5.3 支持 1M 上下文，输入 8 元、输出 28 元每百万 token。 GLM API 接入端点与官方入口一览
接入前先把入口认清楚，分清「开放平台」「文档」「定价」「聊天产品」四件事，能省掉大量无效折腾：
- 海外站 z.ai：面向海外开发者的通道，美元计价，模型与国内站同源。
根据官方 HTTP API 文档与 GLM Coding Plan 文档，目前可用的接入端点共五类，选错端点是最常见的「调不通」原因：
| | |
|---|
| https://open.bigmodel.cn/api/paas/v4/ | OpenAI Chat Completion 兼容，绝大多数场景用这个 |
| https://open.bigmodel.cn/api/coding/paas/v4 | |
| https://open.bigmodel.cn/api/anthropic | |
| https://open.bigmodel.cn/api/v1 | |
| https://api.z.ai/api/anthropic | |
注意区分：Coding 端点与通用端点额度不通用、场景不通用。同理，GLM Coding Plan 团队套餐生成的 Key 也和平台其他 API Key 不通用，用团队额度就必须用团队套餐的 Key，这一点官方在文档里专门加粗提示过。
GLM API Key 获取步骤与首个调用示例
整个流程对国内开发者友好——手机号注册、境内支付、无需境外身份，通常十分钟能跑通第一次调用：
- 访问 open.bigmodel.cn，用手机号或邮箱注册并登录；
- 按平台提示完成实名认证（个人开发者通常上传身份信息并等待审核）；
- 进入控制台，找到 API Keys（API 密钥管理）页面；
- 点击「创建 API 密钥」，系统会生成密钥串，官方形态为 id 与 secret 两部分（以点号分隔），两者都属于敏感凭证；
- 立即复制并妥善保存，建议直接写入环境变量而非硬编码进代码；
- 确认要调用的模型名（如 glm-5.2、glm-4.7-flash），并确认账户余额或赠送额度已到账；
- 用 curl 或 SDK 发起第一次调用，返回正常即表示接入成功；
- 如需更高安全性，可改用 JWT 鉴权：把 API Key 按点号拆成 id 与 secret，用 PyJWT 按官方示例签发一个带过期时间的 token，再放进 Authorization 头。
最简单的原生调用示例：
- 请求地址：https://open.bigmodel.cn/api/paas/v4/chat/completions
- 请求头：Authorization: Bearer 你的API Key，Content-Type: application/json
- 请求体：{"model": "glm-5.2", "messages": [{"role": "user", "content": "你好"}]}
如果已有基于 OpenAI SDK 的代码，只需把 base_url 指向通用端点即可，其余代码基本不用改：
- client = OpenAI(api_key=os.environ["BIGMODEL_API_KEY"], base_url="https://open.bigmodel.cn/api/paas/v4/")
- 官方同时提供 zhipuai SDK 与 Python / JavaScript / Java 多语言示例，新手可优先用 SDK 起步。
GLM API 接入的注意事项
- 密钥形态是双段：平台生成的密钥包含 id 与 secret 两部分，做 JWT 鉴权时要按点号拆分；两段都属敏感信息，都不能进代码仓库。
- 端点与套餐要对齐：通用 Key 走通用端点、Coding 套餐 Key 走 Coding 端点、团队额度必须用团队 Key，混用会直接报权限或额度错误。
- 模型名要写全：大小写与连字符都对不上会返回 1211「模型不存在」。GLM 迭代很快，生产环境请把模型名做成配置项。
- 新模型有格式要求：部分新模型对 messages 数组首条 role 有约束（只允许 user 或 system），沿用旧写法可能触发 1214 参数非法。
- 并发与频率要控制：免费额度与低档位账户并发较低，突发高并发会触发 1302 / 1305，建议加指数退避重试。
GLM 模型清单与最新价格
以下价格整理自智谱开放平台官方定价页，核查时间 2026 年 9 月 9 日，单位为人民币元 / 每百万 token。多个价格表示按输入长度分档（分界线通常为 32K）。
视觉（多模态）模型价格：
官方定价页同时标注：缓存存储在限时免费期内不计费，缓存命中价远低于常规输入价，长提示词复用场景能省下可观成本。海外站 z.ai 采用美元计价，同一模型的美元单价与国内站人民币报价并非简单汇率换算，跨境部署时请以对应站点定价页为准。
GLM API 计费规则与免费额度
智谱开放平台采用按量付费 + 资源包 / 套餐的混合模式：
- 按量付费：按实际输入、输出 token 计费，余额或资源包额度扣完即停，适合用量不稳定的场景；
- 资源包：预先购买 token 额度，单价通常比纯按量更优惠；
- GLM Coding Plan 订阅套餐：面向编程工具的订阅制，分个人版与团队版，按季或按年订阅，可在 Claude Code、Cline、Roo Code、Cursor 等官方支持的工具中使用；
- 免费额度：官网明示新用户注册可获赠 token 额度，且 GLM-4.7-Flash 与 GLM-4.6V-Flash 两个模型完全免费，不消耗账户余额。
账户里的额度通常分为赠送额度与充值额度，两者有效期与扣减规则不同，具体以控制台显示为准。建议先到控制台确认当前余额、有效期与并发上限，再决定用哪个模型起步。对于只是想验证接入是否跑通的场景，直接从两个免费模型开始，成本为零。
选型上给个直白的建议：日常高频、简单任务优先 GLM-4.7-Flash 或 GLM-4.7-FlashX；需要长上下文与复杂推理再上 GLM-5.2 / GLM-5.3；做视觉或文档理解先看 GLM-4.6V 系列；编程工具接入则优先考虑 GLM Coding Plan 套餐。
GLM API 常见错误码与排查
智谱的返回结构是外层 HTTP 状态码 + 内层业务错误码，排查时先看 HTTP 状态码定方向，再按业务码定位具体原因。以下是官方错误码文档中的高频条目：
| | | |
|---|
| | | 核对 API Key 是否完整、是否复制进了空格或换行 |
| | Header 中未收到 Authentication 参数 | 补上 Authorization: Bearer xxx 请求头 |
| | | |
| | | |
| | | |
| | | |
| | | 对照文档检查参数，注意新模型对 messages 首条 role 的约束 |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
实践建议：4xx 优先改自己的请求（鉴权、参数、模型名），429 优先降速加退避，5xx 先看官方是否有服务公告——这时候改代码是无效劳动。
GLM API 接入常见问题
Q：GLM API 有免费的吗？
A：有。GLM-4.7-Flash 与 GLM-4.6V-Flash 是完全免费的模型，不消耗余额；新用户注册还可获赠 token 额度，具体以控制台显示为准。
Q：国内可以直接访问吗？需要境外手机号或信用卡吗？
A：可以。智谱是国产厂商，开放平台支持手机号注册、实名认证与境内支付，不存在境外身份与外币卡门槛。
Q：通用端点和 Coding 端点有什么区别？
A：通用端点 https://open.bigmodel.cn/api/paas/v4/ 用于常规调用；Coding 端点 https://open.bigmodel.cn/api/coding/paas/v4 仅供 GLM Coding Plan 在编程工具中使用，两者额度与场景都不通用。
Q：已有 OpenAI SDK 的代码能直接用吗？
A：能。把 base_url 改成智谱通用端点、替换模型名与密钥即可，请求与响应结构与 OpenAI Chat Completion 兼容。
Q：API Key 生成后由几部分组成？
A：官方生成的密钥包含 id 与 secret 两部分（以点号分隔）。简单鉴权直接用整串；做 JWT 鉴权时需要按点号拆开，用 secret 签发 token。
Q：为什么返回 1211「模型不存在」？
A：九成是模型名拼写问题，注意大小写与连字符；剩下的一成是当前套餐或账户没有该模型的权限（会对应 1311）。
Q：并发上不去，一直报 1302 怎么办？
A：1302 是速率限制。短期加指数退避重试、控制并发数；长期联系官方提升限额或改用更高档位套餐。
Q：想接 Claude Code 之类的工具怎么配？
A：走 Anthropic 协议端点，把工具的 ANTHROPIC_BASE_URL 指向 https://open.bigmodel.cn/api/anthropic，并填入对应的鉴权信息与模型名即可，官方也提供了 GLM Coding Plan 的配置参考。
Q：GLM Coding Plan 的团队 Key 能当通用 Key 用吗？
A：不能。官方明确说明团队套餐 Key 与平台其他 API Key 不通用，用团队额度必须使用团队套餐生成的 Key。
Q：缓存命中是怎么计费的？
A：缓存命中价远低于常规输入价，官方定价页还标注缓存存储在限时免费期内不计费。长系统提示词、固定知识库这类高频复用内容最划算。
Q：国内站和海外站 z.ai 的价格一样吗？
A：不一样。国内站以人民币计价、海外站以美元计价，两者并非简单汇率换算，跨境部署请分别查阅对应站点的定价页。
Q：模型更新很快，代码里怎么避免踩坑？
A：把模型名与端点都做成配置项，关注官方的弃用公告与版本说明。GLM 从 4.5、4.6、4.7 到 5.x 迭代节奏很快，硬编码旧模型名的服务会在某个早晨毫无征兆地挂掉。
Q：实名认证是不是必须做？
A：平台要求完成实名认证后才能正常使用 API 服务，个人开发者按提示上传身份信息并等待审核即可，具体时效以平台显示为准。
以上内容仅供参考，智谱开放平台的模型版本、价格、免费额度与套餐规则可能随时调整，请以 open.bigmodel.cn 定价页与 docs.bigmodel.cn 官方文档的最新公布为准。
AI 速览
