遇到问题
AI 报错对照表
解析招标文件、生成正文、AI 改写时弹出的报错逐条对照:密钥不被接受、余额不足、接口地址不对、连不上、输入超长、输出被截断、流式中断、不支持看图、没有嵌入接口,各自的原因和处理办法。
- 预计用时
- 按需查阅
- 适用版本
- v0.1.0 及以上
报错原文都以软件里的实际文字为准,可以用 Ctrl+F 在本页搜索报错里的关键词。大多数问题都在 系统设置 的「AI 模型」卡片里解决。
配置类
| 报错(开头) | 原因 | 怎么办 |
|---|---|---|
| 未配置 API Key,请在「系统设置 · AI 模型」填写 | 还没保存密钥 | 按 配置 AI 模型 填写并保存 |
| 未配置模型名 / 未配置模型服务地址(base_url) | 模型或地址为空 | 选服务商后点「获取」,从清单里选模型 |
| 模型账户不可用:密钥不被服务商接受 | 401 / 403:密钥错、过期或被吊销 | 到服务商后台重新创建密钥,粘贴后保存 |
| 模型账户不可用:账户余额不足 | 402:欠费 | 到服务商控制台充值,或换一把有余额的密钥 |
| 模型服务返回 404 …:接口地址(Base URL)的路径可能不对 | 地址少了或多了 /v1 一类的路径 |
点「获取」,提示里有「一键改用 …」时直接点 |
| 模型服务返回的是网页而不是模型响应 | 地址指向了网站首页、登录页或网关页面 | 同上,核对接口地址 |
| 当前版本还不支持「…」协议的模型服务 | 所选服务的协议本版本不支持 | 换一个服务商,或升级软件 |
网络类
| 报错(开头) | 原因 | 怎么办 |
|---|---|---|
| 请求模型服务失败: … | 连不上服务商:断网、超时、需要代理 | 检查网络;访问海外服务商要在「AI 模型」卡片的「出网代理」里配好代理 |
| 模型服务返回 429:… | 请求太频繁或额度用完(已自动重试 3 次) | 稍等再试;查看服务商控制台的限额 |
| 模型服务返回 5xx:… | 服务商故障(已自动重试 3 次) | 稍后再试,或临时换一个服务商 |
| 模型流式响应在结束前中断,内容可能不完整(已收到约 N 字) | 生成到一半网络断了 | 检查网络后重新生成这一章 |
| 模型流式响应没有返回任何内容 | 服务商没有返回内容 | 重试;反复出现就换一个模型 |
| 模型服务返回错误:… | 服务商在返回内容时报错,冒号后面是服务商原话 | 按服务商原话处理 |
不支持流式输出的服务商不会报错,界面提示「当前模型服务不支持流式输出,正在等待整段返回…」,等一会儿即可。
内容长度类
| 报错(开头) | 原因 | 怎么办 |
|---|---|---|
| 输入超出模型上下文窗口 | 一次发给模型的内容超过了它能读的长度 | 解析招标文件时软件会自动把这一块缩一半重试;编辑器里请少选一些文字,或换上下文更长的模型 |
| 模型输出被截断(finish_reason=length):几乎没写出正文 | 模型的「思考 / 推理」过程把输出额度占满了 | 换用非思考(非推理)模型,或在服务商控制台关闭深度思考 |
| 模型输出被截断(finish_reason=length):本次只写出约 N 字 | 要写的内容超过了模型单次输出上限 | 逐章生成、缩小范围,或换输出上限更大的模型 |
| 全部 N 块都抽取失败,未产生任何结果 | 解析时每一块都失败了,多为模型不可用或不擅长按要求输出 | 先看上方的具体提醒;密钥、余额没问题就换一个模型重新解析 |
看图与知识库
| 报错(开头) | 原因 | 怎么办 |
|---|---|---|
| 模型「…」不支持看图(不认 image_url) | 扫描件识别、营业执照识别要用能看图的模型 | 在「AI 模型」卡片的「视觉模型」换成支持看图的模型(如 qwen-vl-max、glm-4v-flash、gpt-4o) |
| 未配置嵌入模型 | 知识库要用嵌入模型建索引 | 在「嵌入服务(知识库向量检索)」填嵌入模型名,如 text-embedding-v3 |
| 当前嵌入服务地址(…)不提供向量嵌入接口(/embeddings) | 当前服务商没有嵌入接口(如 DeepSeek) | 在「嵌入服务」单独填一个支持嵌入的地址,详见 知识库与素材库 |
「获取」按钮的提示
在「AI 模型」卡片点「获取」时看到的提示:
| 提示 | 怎么办 |
|---|---|
| 接口地址不对:该地址下没有模型接口 | 点下方的「一键改用 …」 |
| 密钥无效或已过期 | 检查密钥是否复制完整,或重新申请 |
| 连不上该地址:国内访问这个站点通常需要代理 | 在下方「出网代理」配好代理并保存,再点「获取」 |
| 连不上该地址 | 检查网络;用本机模型时确认 Ollama / LM Studio 已经启动 |
| 端点不认识当前模型名,已载入它提供的可用清单 | 从下拉清单里重新选模型 |
| 请先填写接口地址 | 填好接口地址再点「获取」 |
| 端点返回了无法解析的内容 | 地址多半指向了别的服务,核对地址 |
常见问题
报错框里的「去配置」按钮是做什么的?
报错和模型配置有关(密钥、地址、未配置)时会出现,点它直接跳到「系统设置 › AI 模型」。
遇到 429 或 5xx 要不要马上重试?
软件已经自动重试过(最多 3 次,每次间隔最长 20 秒),仍失败才会报出来。多半是服务商限流或故障,稍等几分钟再试,或换一个模型服务。
怎么判断是地址、密钥的问题,还是模型本身不能用?
在「系统设置 › AI 模型」点「获取」:它不花钱,只验证地址和密钥。「获取」通过而「保存并测试连接」失败,问题在模型本身(没开通、额度用完、中转站上游故障)。