智谱（Z.AI）成立于 2019 年，由清华大学计算机系知识工程实验室（KEG）技术成果转化而来，具备从底层算法、预训练框架到国产硬件适配的大模型全链路自主研发能力。公司以“让机器像人一样思考”为愿景，以实现通用人工智能（AGI）为目标，极致专注探索人工智能上限，致力于用大模型实现甚至超越人类的语言、推理、视觉、听觉、工具使用等能力。
一、说明
智谱清言国内官网是日常网页聊天的入口，地址为https://www.zhipuai.cn/zh，在这里只能在线对话，没法创建API密钥；要申请调用接口的密钥，必须进入专门的智谱AI开放平台，地址为https://open.bigmodel.cn/，两个平台的账号体系互通，但功能完全独立。
我们申请API Key需要进入智谱AI开放平台。
二、智谱清言 GLM API 前置须知
本段全部基于本人实操总结，区别于网上复制的官方说明：
账号要求：支持个人开发者、企业开发者两种认证；个人仅需身份证 + 支付宝刷脸实名，无额外资质；未完成实名无法调用任何模型接口。企业认证需要营业执照，适合商用并发项目。
免费额度：新用户注册即送基础 Token，完成个人实名额外赠送 2000 万通用 Token，但是这些Token确实用不了多久。
使用场景：通用 AI 对话、长文档总结、代码生成、脚本编写、知识库 RAG、智能体开发，支持 128K 超长上下文输入，非常适合个人工具、自动化脚本、小型本地项目。
智谱官方还推出了 GLM Coding Plan，这个编程套餐，和直接调用API地址不一样。
注意：使用 GLM 编码套餐 时，需要配置专属的 Coding 端点 - https://open.bigmodel.cn/api/coding/paas/v4 而非通用端点 - https://open.bigmodel.cn/api/paas/v4 注意：Coding API 端点仅限 Coding 场景，并不适用通用 API 场景，请区分使用。
三、智谱清言 GLM API Key 获取完整步骤
登录智谱 AI 开放平台 & 进入控制台
浏览器打开智谱开放平台官网open.bigmodel.cn，手机号 / 微信扫码登录已有账号，点击页面右上角「控制台」进入开发者后台主页。
确认账号已完成实名认证
左侧菜单栏点击个人头像进入账号设置，查看实名认证状态；未认证会限制全部 API 调用权限，个人认证全程 5 分钟左右完成。
进入密钥管理中心，创建 API Key
控制台左侧侧边栏找到「API Key」选项，点击右上角「新建 API Key」，自定义填写密钥名称（比如本地测试、工具项目），点击确认创建。
保存密钥
新建密钥生成后完整字符串仅弹窗展示一次，页面刷新、关闭弹窗后无法二次查看，务必立刻复制保存到记事本；密钥丢失只能删除旧密钥重新创建。
四、新手必踩坑汇总
全部为本人长期使用踩坑总结，全网通用教程很少详细说明：
坑 1：【实名问题】只注册账号不做实名，调用接口直接返回鉴权失败；身份证照片模糊、支付宝刷脸光线不足会导致认证驳回，重新提交即可。
坑 2：【模型名称问题】模型名称需要看官网文档，写错大小写、横杠写错会直接报 Model not found。
坑 3：【额度问题】赠送 2000 万 Token 仅通用对话可用，批量文档、图片生成会单独扣费；免费额度耗尽会自动停机，会返回如下提示。
{"error":{"code":"1113","message":"余额不足或无可用资源包,请充值。"}}
坑 4：【安全问题】密钥不要直接写死在公开代码、Github、博客中，极易被盗刷消耗 Token；闲置不用的密钥及时在后台删除，降低被盗风险。
坑 5：【账号区分坑】网页聊天版账号≠开放平台开发者账号，仅登录聊天页面无法创建 API 密钥，必须进入open.bigmodel.cn开发者后台。
五、极简调用测试代码
一段代码，只要把【这里替换成你的YOUR_API_KEY】替换自己的 API Key 就能一键运行测试。
curl 命令，复制粘贴到 Windows PowerShell/CMD、Mac 终端
curl https://open.bigmodel.cn/api/paas/v4/chat/completions -H "Authorization: Bearer 这里替换成你的YOUR_API_KEY" -H "Content-Type: application/json" -d "{\"model\":\"glm-5.2\",\"messages\":[{\"role\":\"user\",\"content\":\"测试密钥是否可用\"}]}"
六、日常使用建议 & 密钥安全规范
额度查看：控制台「费用 - 用量统计」实时查看 Token 消耗，随时监控免费额度剩余量；
密钥重置：项目更换、代码公开前，在 API Key 管理页面删除旧密钥，新建全新密钥使用；
调用频率限制：免费glm-4-flash支持 30 并发，批量循环脚本不要无限制高频请求，避免接口限流；
防扣费设置：后台开启月度消费限额，设置 0 元防止误调用付费模型产生账单；
密钥存储规范：本地项目建议使用环境变量存放 API Key，不要明文写在源码内。
