想在项目里接入大模型能力，第一步就是拿到API Key。智谱清言背后的GLM系列模型由智谱AI提供，不少朋友在智谱清言的App和网页版里翻遍了设置页面也没找到密钥入口，这是因为API Key并不在对话产品里，而是在智谱AI的开放平台（bigmodel.cn）上申请的。本文把完整的申请流程、注意事项以及调用配置一次性讲清楚。
一、在开放平台注册账号并完成认证
首先需要明确一点：智谱清言是面向普通用户的对话助手，而API服务由智谱AI开放平台提供，两者账号体系是打通的，但API Key必须在开放平台的控制台里创建。打开浏览器访问智谱AI开放平台官网，点击右上角的注册按钮，可以使用手机号注册，也支持直接用微信扫码登录，注册流程很快，一分钟内就能完成。
注册成功后不要急着找密钥，先完成实名认证。个人开发者在个人中心里找到认证入口，填写姓名和身份证号，提交后一般几分钟内就能通过审核。企业用户建议做企业认证，可以开通更高的调用额度和并发限制。认证这一步虽然不是强制的，但不认证的话部分模型的调用权限和额度发放会受到限制，尤其是需要发票或商用场景，企业认证基本是必选项。
认证通过后，新用户通常会收到平台赠送的资源包或代金券，不同时期活动力度不一样，有的阶段直接送几百万token的免费体验额度，足够跑通开发调试。建议在费用中心的资源包页面确认一下自己拿到了哪些免费额度，以及对应的有效期，避免过期浪费。
二、创建API Key的具体步骤
登录开放平台后，点击右上角进入控制台，在左侧菜单里找到API密钥（API Keys）管理页面。点击新建API Key按钮，可以给密钥填写一个备注名称，比如my-project-key，方便后续多个项目区分管理。确认后系统会生成一串以随机字符组成的密钥，形如xxxxxx.xxxxxxxx的格式。
这里有一个非常重要的提醒：密钥只在创建成功的那一刻完整展示一次，关闭弹窗后就无法再次查看完整内容，只能看到掩码后的前几位。所以拿到密钥的第一件事就是立即复制并保存到安全的地方，比如本地密码管理器或者环境变量配置文件。如果手快关掉了弹窗也没关系，直接删掉这个密钥重新建一个就行，删除和新建都不限次数，也没有额外费用。
密钥管理上还有几点细节值得注意。一个账号可以创建多个API Key，建议按项目或环境分开，测试环境和生产环境各用一把，这样某一把泄露时可以单独作废，不影响其他服务。发现密钥泄露或者疑似泄露时，直接在控制台删除该密钥即可，删除后立即生效，用这把密钥的请求会立刻返回鉴权失败。另外不要把密钥硬编码进代码再提交到代码仓库，哪怕是私有仓库也建议用环境变量的方式注入，这是基本的安全习惯。
三、拿到Key之后如何调用
密钥到手后就可以写代码了。智谱官方提供了zhipuai的Python SDK，通过pip安装即可使用，调用的入参和返回结构与主流大模型接口风格接近，上手成本很低。下面是一个基础调用示例：
import os
from zhipuai import ZhipuAI
# 从环境变量读取密钥，避免硬编码
client = ZhipuAI(api_key=os.environ.get("ZHIPU_API_KEY"))
response = client.chat.completions.create(
model="glm-4-flash",
messages=[
{"role": "user", "content": "用一句话介绍一下你自己"}
],
)
print(response.choices[0].message.content)
如果不想引入额外的SDK，也可以用OpenAI兼容模式。智谱的接口兼容openai库的调用协议，只需要把base_url换成智谱的地址，api_key填入自己的密钥，就能复用已有的OpenAI生态代码，非常适合那些原本基于openai库开发、想要切换或增加国产模型供应商的项目。示例代码如下：
import os
from openai import OpenAI
# 使用OpenAI兼容模式调用智谱GLM模型
client = OpenAI(
api_key=os.environ.get("ZHIPU_API_KEY"),
base_url="https://open.bigmodel.cn/api/paas/v4/"
)
resp = client.chat.completions.create(
model="glm-4-flash",
messages=[{"role": "user", "content": "帮我写一句开发标语"}],
)
print(resp.choices[0].message.content)
环境变量的设置方式也要说一下。Windows下可以在命令行执行set ZHIPU_API_KEY=你的密钥，或者通过系统属性的环境变量面板永久配置，配置后需要重启终端或IDE才生效。macOS和Linux下可以在~/.bashrc或~/.zshrc里加上export ZHIPU_API_KEY=你的密钥，然后执行source命令让配置生效。这样代码仓库里完全不会出现密钥明文，迁移和协作都更安全。
四、常见问题与排查思路
第一次调用经常遇到的问题主要是鉴权失败。如果接口返回错误提示鉴权不通过，先检查密钥有没有多余的空格或换行，复制粘贴时最容易混入这类不可见字符。其次确认密钥没有被删除，控制台里能看到当前状态。还要注意接口地址是否正确，OpenAI兼容模式必须使用智谱的base_url，直接请求OpenAI官方地址肯定是过不了鉴权的。
模型选择方面，不同模型的计费策略差异很大。部分flash系列模型提供免费调用额度，适合开发调试和轻量场景，而旗舰模型的单价更高但效果更好。调用前在平台的模型广场确认自己要用的模型名称拼写是否准确，模型名写错会直接返回模型不存在的错误。速率限制方面，免费或低等级账户的并发数较低，如果遇到限流报错，可以在代码里加上重试逻辑，或者申请提升配额。
最后再强调一次密钥安全：不要在公开场合、群聊、截图里暴露密钥，写技术博客分享代码时记得把密钥打码或用占位符代替。一旦怀疑泄露立即删除重建，养成定期轮换密钥的习惯，配合按项目分密的策略，就能把风险控制在很小的范围内。按照上面的流程操作，从注册到跑通第一个请求，通常十分钟内就能全部完成。
智谱清言API Key大模型API调用openai兼容接口修改时间：2026-09-16 15:46:41