调用智谱清言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 判断再打印,否则终端会出现空行乱序。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











