ChatGLM API Key怎么检查是否可用

快速确认手头的ChatGLM API Key能否正常调用glm-4或glm-5模型，是开发中绕不开的关键一步。直接发请求测试是最可靠的方式，不依赖第三方工具或网页界面，全程可控、可复现。下面给出三种验证方法，覆盖开发常用的本地脚本、命令行和平台后台。

用Python脚本本地验证

先安装zhipuai SDK：pip install zhipuai

新建一个test_chatglm.py文件，粘贴以下代码（注意替换为你自己的API Key）：

from zhipuai import ZhipuAI
client = ZhipuAI(api_key="
【你的完整API Key，必须带sk-前缀且无空格】
")
try:
    response = client.chat.completions.create(
        model="glm-4",
        messages=[{"role": "user", "content": "请用中文回答：北京是中国的首都吗？"}],
        max_tokens=100
    )
    print("✅ 调用成功，返回内容：", response.choices[0].message.content[:50] + "...")
except Exception as e:
    print("❌ 错误类型：", type(e).__name__)
    print("❌ 错误详情：", str(e))

运行python test_chatglm.py。若输出✅，说明Key有效且账户余额充足；若报错ZhipuAIError且提示“invalid api key”，说明Key格式错误或已被撤销；若提示“insufficient balance”，则需充值或切换免费额度通道。

用curl命令行快速检测

方法一：发送最简POST请求

curl -X POST https://open.bigmodel.cn/api/paas/v4/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer 
【你的API Key】
" \
  -d '{"model":"glm-4","messages":[{"role":"user","content":"hi"}]}'

方法二：加-v参数查看HTTP状态码（关键！）

curl -v -X POST https://open.bigmodel.cn/api/paas/v4/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -d '{"model":"glm-4","messages":[{"role":"user","content":"test"}]}' 2>&1 | grep "HTTP/"

看到HTTP/2 200表示认证通过且服务可用；HTTP/2 401说明Key无效；HTTP/2 429说明触发限流；HTTP/2 402代表账户欠费。这一步比看返回体更早暴露问题。

检查智谱平台后台状态

第一步：登录智谱AI控制台

第二步：点击左侧菜单【API Key管理】→ 找到你正在测试的Key行

第三步：确认状态列显示为

，不是“已禁用”或空白；同时核对“剩余调用次数”和“剩余Token额度”是否大于0

第四步：点击该Key右侧的【查看】→ 在弹窗中检查“所属项目”是否与当前调用场景匹配；若Key绑定在“default”项目但你在代码里指定了其他project_id，会静默失败

注意：新注册账号默认只有“default”项目，且首次生成Key后需手动点击“启用”按钮，否则状态始终为灰色不可用。