必须显式指定模型名称，大小写、连字符或空格错误会导致Model not found；Python SDK中通过chat.completions.create(model="glm-4.7-flash")传参，Dify需在模型供应商配置页填准确全称，RESTful API可通过JSON body、URL路径或Hermes交互式配置设定。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在代码或平台中正确调用智谱清言API，必须显式指定模型名称，填错大小写、连字符或空格会导致Model not found错误，且该参数无法被系统自动补全或纠错。
Python SDK中设置模型名称
使用官方zhipuai SDK时，模型名直接传入chat.completions.create()方法的model参数。
第一步：确认你已安装最新版SDK——运行pip install zhipuai --upgrade，旧版本可能不支持glm-4.7-flash等新模型。
第二步：初始化客户端后，在每次请求中明确写出模型全称，例如：
response = client.chat.completions.create(model="glm-4.7-flash", messages=[{"role": "user", "content": "你好"}])
注意：model参数值必须与智谱开放平台文档完全一致，【glm-4.7-flash不能写成glm47flash、GLM-4.7-FLASH或glm-4.7 flash】，否则返回404。
Dify后台配置模型供应商
在Dify中绑定智谱模型，本质是为整个工作区预设一个可用模型，后续应用可直接选用，无需每处重复填写。
登录Dify后台 → 点击左侧【设置】→ 【模型供应商】→ 搜索并安装“智谱AI”插件 → 进入配置页。
在「模型名称」字段中，输入你已在智谱开放平台开通权限的模型全称，例如：glm-4-plus、glm-4-air、auto-glm-05。
这一步填错会直接导致测试按钮灰显，且错误提示不明确——【务必回到智谱控制台「在线体验」页，用同一Key和同一模型名先验证能返回正常响应】。
RESTful API请求中设置模型
方法一：通过JSON body传参
在POST请求体中，将模型名作为model字段值提交，例如：
{"model":"glm-4v-plus","prompt":"描述这张图","temperature":0.5}
方法二：部分接口支持URL路径指定模型（如AutoGLM沉思API）
请求地址直接包含模型标识，例如：https://open-api.glm.ai/v1/auto-think/completions隐含使用auto-glm-05，此时body中仍需显式声明"model": "auto-glm-05"，否则部分网关会拒绝请求。
方法三：Hermes Agent交互式配置
运行hermes setup model → 输入API Key → 在模型列表中选择序号（如输入7选glm-4.5-air）→ 确认即可。该操作会将模型名写入本地配置文件.hermes/config.yaml，后续所有调用默认使用此模型。
