调用智谱清言API前必须完成身份认证、环境配置与代码接入三类动作，缺一不可；需注册账号并实名认证（上传身份证正反面，5分钟内审核），登录后在“项目管理→API Keys”创建密钥；推荐使用虚拟环境安装zhipuai SDK（指定阿里源），避免混用openai包；调用时应将API Key存于环境变量，支持同步调用、沉思模式（auto-glm-05+thinking_enabled=True）及流式输出（需判空处理）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
调用智谱清言API前必须完成身份认证、环境配置与代码接入三类动作，缺一不可，否则会直接返回401错误或Connection refused。
注册账号并实名认证
访问 https://open.bigmodel.cn，点击右上角“注册”，用手机号+邮箱创建账户；注册后立即进入实名认证环节，个人用户须上传身份证正反面照片，系统审核通常在5分钟内完成，【未完成实名认证将无法创建API Key】。
登录后点击头像→“个人中心”→左侧菜单栏“项目管理”→“API Keys”，点击“添加新的API Key”，输入名称（如“本地测试”）即可生成密钥。
安装SDK并配置开发环境
推荐使用虚拟环境隔离依赖：python -m venv glm-env → source glm-env/bin/activate（macOS/Linux）或 glm-env\Scripts\activate（Windows）。
执行 pip install zhipuai -i https://mirrors.aliyun.com/pypi/simple/ 安装官方SDK；清华镜像源当前不稳定，强制指定阿里源可避免下载中断。
不要安装旧版 zhipu 包（已弃用），也不要混用 openai 和 zhipuai SDK 的调用方式——二者接口不兼容，强行混用会导致 model 参数被忽略。
编写调用代码并设置关键参数
方法一：基础同步调用（推荐新手）
第一行写 import os；第二行写 api_key = os.getenv("ZHIPU_API_KEY")，把密钥存在系统环境变量里，而不是硬编码在脚本中；第三步初始化 client = ZhipuAI(api_key=api_key)；第四步调用 response = client.chat.completions.create(model="glm-4-flash", messages=[{"role": "user", "content": "你好"}], stream=False)；第五步 print(response.choices[0].message.content) 输出完整回复。
方法二：启用沉思模式（适合复杂推理）
改用 auto-glm-05 模型，并显式传入 thinking_enabled=True 参数；该模式会自动构建内部推理链，但响应延迟比普通模式高30%～50%，【若仅需快速问答，请勿开启】。
方法三：流式输出（适合终端实时显示）
将 stream=True 传入 create()，然后用 for chunk in response 循环读取；注意每次 chunk.choices[0].delta.content 可能为空字符串，需加 if chunk.choices[0].delta.content 判断再打印，否则终端会出现空行乱序。
