GLM API Key 怎么申请？在哪找、怎么用、额度在哪看

2026-08-24

本文依据智谱开放平台官方文档站（docs.bigmodel.cn）逐字核对整理，核对时间 2026-08。控制台页面为前端渲染，本文只按官方文档描述的入口名称说明位置，具体界面以你登录后看到的为准。

先给答案：GLM 的 API Key 不在文档站里，也不在什么申请表里，它在控制台自己建。官方快速开始文档写的路径是——注册登录智谱开放平台，进入「个人中心」页面，点击「API Keys」，创建一个新的 Key。没有审核、没有排队、不需要先充值，建完当场就能拿去调接口。

真正让人卡住的从来不是”点哪个按钮”，而是后面那一串：Key 建出来了放哪、代码里怎么填、为什么明明有 Key 却一直报 401、编程套餐买了却提示 Key 用不了、额度到底还剩多少去哪看。这篇就按这个顺序过一遍，每一条都对着官方文档核，没核到的地方我会直说没核到。

如果你要的是完整的接入教程（SDK 选型、模型挑选、最小可跑代码），可以直接看智谱 GLM API 怎么接入？密钥申请、SDK 调用与免费额度，这篇更聚焦在 Key 本身。

一、Key 在哪拿：官方给的就是四步

智谱官方的快速开始文档把整个流程拆成了五步，前四步是拿到能用的 Key，第五步才是发请求：

注册账号。访问智谱开放平台，点右上角的「注册/登录」，按提示走完注册。平台有两个域名并存，open.bigmodel.cn 和 bigmodel.cn 指向同一套东西，从哪个进都行。
获取 API Key。登录后在「个人中心」页面点「API Keys」，创建一个新的 Key。
选择模型。平台上文本、视觉、图像、视频、向量各类模型都有，选哪个决定了你后面代码里 model 字段填什么。
选择开发方式。官方列了四条路：HTTP API（标准 RESTful，任何语言都能用）、Python SDK、Java SDK，以及直接翻 API 参考文档。

关于注册本身，官方注册登录 FAQ 里有两条值得先知道：支持海外手机号注册，注册时选对应国家区号收短信验证码就行；验证码收不到多半是被频率限制挡了，官方的建议是等 5 分钟再试，短时间内反复点发送反而会一直发不出来。

还有个新手常纠结的问题：要不要先实名认证才能调 API？官方实名认证 FAQ 的原文是”目前调用 API 并不强制要求实名认证”，只是从账户安全角度建议做。所以你完全可以先拿 Key 把链路跑通，再决定认不认证。个人账号后续也能变更成企业账号，反过来则不行——企业实名不支持改回个人，这个方向是单向的，注册时如果是拿公司名义在用，一开始就想清楚。

二、★ 最容易踩的坑：编程套餐的 Key 和通用 API Key 不是一套

这一条我放在最前面，因为它造成的困惑最大，而且报错信息不看错误码根本猜不出来。

如果你订阅的是 GLM Coding Plan（就是拿来接 Claude Code、Cline、Cursor 这类编码工具的订阅套餐），它的 Key 不在「个人中心 → API Keys」那里建。按官方 Coding Plan 快速开始，个人版套餐用户要去「个人编程套餐 → 套餐概览」新建 Key，团队版套餐成员要去「团队编程套餐 → 我的套餐」获取；文档还专门加粗提醒，团队套餐的 Key 与平台其他 API Key 不通用，想用团队额度就必须用团队套餐的那把 Key。

拿错了会怎样？官方错误码表里有一条对应的：业务错误码 1315，提示是”该 API Key 仅限企业编程套餐场景使用，请到官网更换对应产品类型的 API Key”。看到这句，就是 Key 的类型和你调用的场景对不上，不是 Key 本身坏了。

顺带把另一个长期含糊的点也补上：编程套餐的 base_url 和通用 API 不是同一个。官方 Coding Plan 文档给出了一张明确的端点表，按协议分三种——Anthropic Message 协议、OpenAI Chat Completion 协议、OpenAI Response 协议各有各的 Base URL，其中 OpenAI 兼容那条走的是带 coding 段的路径。而普通 API 调用用的是 https://open.bigmodel.cn/api/paas/v4/chat/completions 这个端点。这两套地址混用，是”Key 明明是对的却调不通”的另一大来源。站内早前那篇接入文里我曾把编程专用端点标注为”只在第三方教程见过、官方未逐字给出”，这次在官方文档里核到了，这里更正一下。

三、拿到 Key 之后放哪、代码里怎么填

官方在获取 Key 那一步就写了一句提醒，原话是：“请妥善保管您的 API Key，不要泄露给他人，也不要直接硬编码在代码中。建议使用环境变量或配置文件来存储 API Key。”

注意官方这里只说了”用环境变量或配置文件”，并没有规定一个统一的环境变量名。网上不同教程里出现的变量名不一样，那些通常是各自 SDK 或各自工具的约定，不是平台层面的强制规范——你用哪个 SDK，就照那个 SDK 的文档来，别照着别人的截图抄一个名字然后纳闷为什么读不到。

填法本身很简单。走 HTTP 的话，Key 是放在请求头的 Authorization 里，格式是 Bearer 加上你的 Key，官方 curl 示例就是这个结构：

curl -X POST "https://open.bigmodel.cn/api/paas/v4/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{ "model": "你选的模型", "messages": [{"role":"user","content":"你好"}] }'

走 Python 的话有一个细节值得说：官方快速开始页现在同时挂着两套 Python SDK。一套是新的 zai-sdk（pip install zai-sdk，代码里 from zai import ZhipuAiClient），另一套的标签页明确写着”Python SDK(旧)“，也就是老的 zhipuai 包（from zhipuai import ZhipuAI）。两套的 Key 都是同一把，构造客户端时用 api_key= 传进去。如果你手头的教程年份比较早，八成用的是旧包——它还在文档里、没有被删掉，但既然官方已经把它标成”旧”，新项目从新包起步会省事一些。Java 那边官方给的是 ai.z.openapi:zai-sdk。

至于 Key 放进代码之后的长期管理——多环境怎么隔离、泄露了怎么办、要不要定期轮换——那是另一个话题，可以看 API Key 怎么管才不泄漏：开发者常犯的几个错和 API 密钥轮换：什么时候必须换，怎么无缝换。这里只强调一件事：别提交进 Git。

四、“Key 用不了”通常是这几种，对着错误码认

智谱的报错是两层结构，这一点官方错误码文档写得很清楚：外层是 HTTP 状态码，内层是响应体正文里的业务错误码。也就是说光看到一个 401 或 429 是不够的，得把响应体打出来看里面的 code 字段，才知道到底是哪一种。官方给的响应示例长这样：

{"error":{"code":"1001","message":"Header 中未收到 Authentication 参数，无法进行身份验证"}}

外层 401，内层 1001，两者含义完全不同。按这个思路，常见的几类可以这么归：

HTTP 401 一族——是身份的问题。 1000 是身份验证失败（Key 填错、复制时多带了空格或换行是高频原因）；1001 是压根没在 Header 里收到认证参数（多半是请求头名字写错，或者变量是空的没读到）；1003 是 Token 已过期需要重新生成；1005 是账号开了二次认证保护，需要先完成二次认证登录。

HTTP 400 一族——是请求内容的问题，跟 Key 没关系。 1211 是”模型不存在，请检查模型代码”，这条最常见，通常是模型名拼错或者用了已经下线的型号；1210 是参数有误；1213/1214 是某个字段没传或者传得不合法；1261 是 Prompt 超长。看到 400 就别再折腾 Key 了，去核请求体。

HTTP 403——1220，“您无权访问某接口”，是权限没开，不是 Key 无效。

HTTP 429 一族——最杂，得细看内层码。 这里面既有 1302（账户达到速率限制）、1305（该模型当前访问量过大，属于平台侧过载）这类真限流，也有 1113（账户已欠费，充值后重试）、1309（Coding Plan 套餐已到期）、1315（前面说的 Key 类型不对）这类其实跟”频率”无关的情况。还有 1308/1310 这种”已达到使用上限，限额将在某时刻重置”的。所以看到 429 别条件反射地去加重试和退避——如果内层是欠费或者套餐到期，你重试一万次也不会好。限流那一类的具体处理姿势，站内单独写过 GLM API 撞限流怎么办：并发和配额是两回事。

还有一个坑：流式调用不走这套错误码。 官方在错误码页末尾专门加了注：使用流式（SSE）调用时，如果 API 在推理过程中异常终止，不会返回上述错误码，而是把异常原因放在响应体的 finish_reason 参数里。你要是流式请求”没报错但结果不完整”，就去看 finish_reason，别在错误码表里找。更多报错场景可以对照 GLM API 常见报错排查：密钥、模型名与配额。

五、额度、账单、限流：只讲去哪看和怎么算

具体数字这里一个都不写——价格、免费额度、并发上限这几样都是会变的，写死在文章里等于埋雷。但机制是稳定的，把机制记住，数字随时自己去查。

计费怎么算。 官方费用问题 FAQ 的口径是：以 token 为单位计费，按你输入和输出的总 token 数算；图像、视频、搜索这几类模型不消耗 token，是按次收费的。一个容易漏掉的点：如果你开了搜索服务，搜索结果作为输入也会被计费——这条是不少人对不上账的原因。

钱从哪扣。 有两个池子：资源包和现金余额。扣减顺序是固定的——优先扣资源包，扣完再扣现金余额；如果你手上有多个适用场景相同的资源包，会优先扣最快过期的那个。还有两条相关的：欠费状态下仍然可以使用有效期内的资源包；资源包一旦过期就不支持延期、续费或重新激活，所以自己盯着过期时间比较实在。

账单在哪看。 官方指的是控制台的「财务总览」页，能看今日消费金额和近 6 个月的消费统计；要看逐笔明细去「费用账单」页；要下载去「导出记录」页。

免费的怎么用。 文档站的模型分类里有一个独立的「免费模型」栏目，里面按型号一个个列出来，文本、视觉、图像、视频各有覆盖。这个列表会随模型迭代增删，所以这里不复述型号名，你直接去文档站左侧导航的「免费模型」下面看当前有哪些最准。想了解免费档整体怎么规划着用，可以看 GLM 有哪些免费模型？能用到什么程度。

限流额度在哪看、怎么提。 官方速率限制文档说明了几件事：速率限制主要体现在并发请求数上，而”并发数”指的是同一时刻正在处理中的请求数量，不是每分钟多少次；不同模型有各自独立的并发上限；额度大小跟你的用户权益等级挂钩，通用 API 用户可以在控制台的「速率限制」页查看自己各模型当前的速率。如果业务确实需要更高并发，官方开放了提交申请的通道，需要填要调整的模型、期望的并发数和实际业务场景，平台审核后通过注册手机号或站内通知告知结果。另外要注意，Coding Plan 套餐用户的并发是按套餐等级统一给的，官方明确说暂不支持申请调整，套餐等级之间的高低顺序是 Max 大于 Pro 大于 Lite，低峰期平台会动态给到更高并发。

最后一条，充值前务必知道。 官方费用 FAQ 里白纸黑字：“智谱开放平台暂时不支持任意形式的退款功能。“特殊情况可以联系客服走申请，但已消耗的部分、已开票的部分都不支持退。所以别为了凑什么优惠一次性充一大笔，按实际用量分次充更稳妥。想先把成本估个数再决定充多少，参考智谱 GLM API 怎么收费？各模型 token 单价与省钱用法。

六、几条能省事的小结

Key 建了就当场存好。 各家平台的通行做法都是明文只给你看一次，关掉弹窗再想复制就晚了。
删 Key 不会留尾巴。 官方明确说 API Key 被删除后就无法再成功调用接口，也不会再产生扣费——怀疑泄露的时候，删掉是干净利落的止血手段。
一个账号可以多端同时登录，官方说目前没有登录端数量限制，不用担心在公司登了家里就掉线。
报错先看内层业务码再动手，尤其是 429，一半的 429 其实跟频率无关。
别把易变的数字抄进自己的文档里。价格、免费额度、并发上限这些，在你的项目 wiki 里写一句”见官方定价页/速率限制页”比抄一个数字强，抄下来的那个数半年后一定是错的。