需通过Zion开发者工具Network面板抓取GraphQL/API请求的Preview/Response,提取error.code(如invalid_api_key)和error.message,再依ID定位组件并分三层归因:鉴权、参数、配额问题。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Zion中查看模型返回的错误码
想确认大模型API调用失败时具体返回了什么错误码,不是看浏览器控制台红字或插件弹窗,而是要直接拿到原始响应体里的error.code字段——Zion平台把这一步藏在「智能校验」触发后的网络请求里,必须手动打开开发者工具抓取。
第一步:在Zion编辑器中复现报错操作。比如点击一个配置了AI调用的按钮,或提交一个触发模型推理的表单,确保错误真实发生一次。
第二步:按下 F12 打开浏览器开发者工具 → 切换到 Network 标签页 → 点击上方的 Fetch/XHR 过滤器。
第三步:在页面上再次触发同一操作(如重点击按钮),此时Network面板会新增一条请求记录。找到最新的一条,名称通常为 graphql 或 api 开头的条目,点击它。
第四步:在右侧详情面板中,切换到 Preview 或 Response 标签页。向下滚动,查找包含 "error" 的 JSON 字段。重点提取其中的 【error.code】 和 【error.message】 两项内容——前者是平台定义的结构化错误码(如 invalid_api_key、context_length_exceeded),后者是人类可读的补充说明。不要只看 status=400 就停手,HTTP状态码只是表层,真正定位问题靠的是这个 error.code。
通过组件ID快速定位出错模型节点
Zion里模型调用常绑定在具体组件上(如“AI问答框”“自动摘要按钮”),如果错误码提示指向某个组件逻辑异常,就得立刻锁定它。这时不能靠肉眼翻页找,要用ID精准跳转。
方法一:从错误提示框直接跳转
若报错弹窗里明确显示了“目标位置”和“自定义列表”等文字,点击该文字链接,编辑器将自动滚动并高亮对应组件。
方法二:用mRef或inputsOf反查ID
在上一步获取的 Preview 响应体中,搜索关键词 mRef 或 inputsOf,其后紧跟的字符串就是该组件的唯一ID(例如 "mRef": "kv9d3gwj")。复制这段ID。
方法三:全局搜索组件
点击Zion编辑器右上角的 搜索组件 图标 → 在弹出框中粘贴刚复制的ID → 点击搜索按钮 → 页面立即跳转至该组件所在画布位置。此时可检查其绑定的模型名称、参数配置、API密钥字段是否填写正确,尤其注意密钥末尾有没有隐藏的换行符或空格。
错误码归属分层判断(不查文档也能快速归因)
拿到 【error.code】 后,不用逐条翻文档,按以下三层直接分类:
① 如果错误码含 api_key、auth、unauthorized、forbidden 字样(如 invalid_api_key、api_key_disabled),问题一定出在鉴权层——检查Zion项目设置里的API密钥是否填错、是否过期、是否被服务商端禁用。
② 如果错误码含 request、parameter、model、max_tokens、messages 字样(如 invalid_request_error、model_not_found),说明请求参数与模型服务不匹配——核对组件配置中填写的模型ID是否拼写正确、是否已下架、max_tokens是否超出该模型允许范围。
③ 如果错误码含 rate、limit、quota、exceeded 字样(如 rate_limit_exceeded、insufficient_quota),属于配额耗尽——登录对应模型服务商后台,查看当日Token用量、QPM限制是否触顶,Zion侧无法绕过此限制。











