智谱清言api报错主因是配置错误、权限未开通、端点误用国际版或余额耗尽；需依次验证key状态、切换国内端点https://open.bigmodel.cn/api/paas/v4、精确匹配模型名、检查api平台余额。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
智谱清言突然报错无法使用，页面卡在加载、提示“网络异常”“模型不可用”或直接弹出429/401错误，不是你本地网络问题——大概率是API配置错位、权限未开通、端点指向国际版，或是账户余额真被扣光了。充了50块5分钟烧完的教训，就始于这一步没看清。
先确认是不是Key本身失效
打开智谱开放平台（不是网页聊天页），登录后进入「API Key管理」，检查你正在用的Key状态是否为「启用中」。若显示「已禁用」或「过期」，立刻新建一个Key。
复制新Key，在开放平台左侧「在线体验」里选同一模型（如glm-4-flash），粘贴Key并发送“测试”，看能否返回正常响应。【这一步必须做——Dify里报错Model not found，90%是因为Key根本没权限调用该模型】。
如果「在线体验」也报“权限不足”，说明该模型需单独申请。点击模型名称旁的「申请权限」按钮提交，审核通常1–2工作日，别在Dify里反复重试。
查端点：国内用户最常栽在这里
方法一：看报错语言
英文429（Insufficient balance or no resource package）→ 你正在调用国际版端点 api.z.ai，国内Key不认；中文“余额不足或无可用资源包”→ 端点正确，但open.bigmodel.cn账户真没钱了。
方法二：改base_url
进Dify「设置 → 模型供应商 → 智谱AI → 配置」，把「基础URL」手动填成：
https://open.bigmodel.cn/api/paas/v4
删掉默认值或留空都不行，必须显式填写这个国内端点。
方法三：清缓存（Hermes等第三方工具必做）
找到本地路径 %USERPROFILE%\.hermes\auth.json，直接删除该文件。重启工具后它会强制重新读取.env和config.yaml里的新base_url，否则永远走旧端点。
验证模型名拼写是否精确
第一步：打开智谱开放平台「在线体验」页面，下拉模型列表，记下你要用的模型全称，例如：
glm-4-air、glm-4-flash、glm-4-plus——注意短横线、小写字母、无空格。
第二步：回到Dify配置页，在「模型名称」栏**逐字对照粘贴**，不能靠记忆手敲。glm4air、GLM-4-AIR、glm-4 air都会触发Authentication failed。
第三步：保存后点击右侧「测试」按钮。绿色对勾出现才算真正通过，灰色或红色都代表未生效。
查钱：两个账本，互不通用
登录 https://open.bigmodel.cn，右上角点头像→「账户中心」→「余额」，看「API开放平台」余额是否大于0。Coding Plan（IDE插件套餐）、App内充值、Apple订阅的积分，全部不计入此处。
若余额为0，有两个选择：
① 立即充值（最低10元起）；
② 临时切换免费模型，比如把模型名改成 glm-4-flash，它目前仍对新注册用户开放体验额度。
注意：Apple退款后积分冻结，不影响open.bigmodel.cn账户余额，但若你用的是Apple订阅自动续费，需主动取消，否则每月仍会从支付宝/微信扣款。
