必须实名认证后创建带模型权限的api key，使用v4版url和严格匹配的model名发起http请求，并携带正确authorization与content-type头。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在项目里调用智谱清言的文本生成能力，必须拿到带对应模型权限的API Key，并用正确的URL、模型名和请求格式发起HTTP调用——填错model字段或漏掉Authorization头，请求直接返回401；用错基础地址，连服务端都找不到。
获取合法可用的API Key
智谱清言的API Key不是注册完账号就自动开通，必须实名认证后手动创建并勾选所需模型权限。
第一步：访问智谱AI开放平台，用手机号完成实名认证（个人需上传身份证正反面，企业需营业执照）。
第二步：登录后点击右上角头像 →「用户中心」→「项目管理」→「API Keys」→「添加新的API Key」。
第三步：在「应用名称」栏填写可识别名称（如“客服系统-生产环境”），【务必勾选你要用的模型权限，例如glm-4-flash、glm-4-plus等】，点击确认创建。
第四步：复制生成的Key（以sk-开头、共64位），【该Key仅显示一次，关闭页面即不可再查，丢失只能新建】。立即存入密码管理器或加密文件，不要粘贴到代码里。
确认服务地址与模型标识
智谱清言文本生成接口使用v4版路径，不是v3也不是网页版地址，用错就报404或“model not found”。
方法一：直接使用官方推荐REST地址
基础URL为 https://open.bigmodel.cn/api/paas/v4/chat/completions，不可省略/chat/completions后缀。
方法二：用zhipuai官方SDK（推荐≥2.2.0）
安装命令：pip install zhipuai -i https://mirrors.aliyun.com/pypi/simple/
初始化客户端时传入model参数，如ZhipuAI(api_key="sk-xxx").chat.completions.create(model="glm-4-flash", ...)。
注意：model字段必须与官网定价页列出的文本模型名完全一致，大小写、点号、连字符都不能错。例如不能写成“glm4-flash”或“GLM-4-FLASH”。
构造合规的请求体
请求体是JSON格式，字段名、嵌套结构、数据类型全错不得——少一个messages数组或role值不是"system"/"user"/"assistant"，立刻返回400。
① 必填字段model：字符串，值为已开通权限的模型名，如"glm-4-plus"。
② 必填字段messages：数组，至少含一个{"role": "user", "content": "你的提示词"}对象；若加system角色，必须放在最前面。
③ 可选但强烈建议字段stream：设为true启用流式响应，避免长文本卡死；设为false则等待全部生成完毕才返回。
④ 其他常用字段：temperature（0.0~1.0）、max_tokens（默认1024，最大8192）、top_p（0.1~1.0），不填则走模型默认值。
发送带认证头的HTTP请求
所有请求必须携带两个关键Header，缺一不可。
Authorization：固定格式Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx，【sk-前缀和Key之间有空格，且Key前后不能有换行或中文标点】。
Content-Type：必须为application/json，不是text/plain或未设置。
Python requests示例：
import requests<br>url = "https://open.bigmodel.cn/api/paas/v4/chat/completions"<br>headers = {<br> "Authorization": "Bearer sk-xxx",<br> "Content-Type": "application/json"<br>}<br>data = {"model": "glm-4-flash", "messages": [{"role": "user", "content": "你好"}]}<br>res = requests.post(url, json=data, headers=headers)<br>print(res.json())大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
