必须完成API密钥认证、安装zhipuai SDK、构造合法请求三步——先在智谱AI开放平台创建并安全存储API Key，再pip install zhipuai（推荐阿里镜像源），最后用ZhipuAI客户端调用glm-4-flash等模型实现同步或流式问答。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Python项目里调用智谱清言的AI能力，必须先完成API密钥认证、安装对应SDK、构造合法请求三步，缺一不可——跳过任一环节都会触发401错误或模块导入失败。
获取并保管API Key
登录智谱AI开放平台（open.bigmodel.cn），完成实名认证后进入「控制台→API密钥」页面。点击「创建API密钥」，填写应用名称（如“个人测试”），系统自动生成Key字符串。
【Key生成后仅显示一次，且无法再次查看完整内容】
复制该Key，立即存入本地环境变量：Linux/macOS执行export ZHIPUAI_API_KEY="your_key_here"；Windows PowerShell执行$env:ZHIPUAI_API_KEY="your_key_here"。切勿写死在代码里。
立即学习“Python免费学习笔记（深入）”；
安装zhipuai官方SDK
运行命令：pip install zhipuai -i https://mirrors.aliyun.com/pypi/simple/。阿里镜像源可避免清华源偶发的超时问题。
若提示SSL证书错误，追加参数：pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org zhipuai。
Python版本需为3.8–3.10。3.11+可能引发ImportError: cannot import name 'AsyncClient'。
调用GLM-4模型完成基础问答
方法一：同步响应（适合调试）
导入SDK并初始化客户端：from zhipuai import ZhipuAI → client = ZhipuAI(api_key=os.getenv("ZHIPUAI_API_KEY"))。
构造messages列表，至少包含一个user角色字典：messages=[{"role": "user", "content": "解释量子纠缠"}]。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
发起请求：response = client.chat.completions.create(model="glm-4-flash", messages=messages)。
提取结果：print(response.choices[0].message.content)。
方法二：流式输出（适合终端交互）
在create()调用中添加stream=True参数。
用for循环逐块读取响应：for chunk in response: → if chunk.choices[0].delta.content: → print(chunk.choices[0].delta.content, end="", flush=True)。
注意：流式响应下chunk.choices[0].delta.content可能为空字符串，需判空再打印，否则会输出多余换行。
验证接入是否成功
第一步：运行以下最小化脚本
import os
from zhipuai import ZhipuAI
client = ZhipuAI(api_key=os.getenv("ZHIPUAI_API_KEY"))
res = client.chat.completions.create(model="glm-4-air", messages=[{"role":"user","content":"测试"}])
print(res.choices[0].message.content[:20])
第二步：观察终端是否输出类似“测试成功”或合理文本片段。
第三步：若报错zhipuai.core._errors.AuthenticationError，说明Key未生效或环境变量未加载；若报错ModuleNotFoundError: No module named 'zhipuai'，说明SDK未正确安装。
