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