[Bug]: Failed to add the siliconflow model in version 0.22.1

问题场景

用户在 RAGFlow v0.22.1 的模型管理界面中，定位到 “siliconflow” 供应商并点击 “Add” 按钮，输入 API Key 后点击 “Save”，界面随即报错，无法成功添加模型。

报错原文

[Bug]: Failed to add the siliconflow model in version 0.22.1

原因分析

根据 Issue 中的维护者回复，RAGFlow 在添加 SiliconFlow 等模型时，并不是简单地保存 Key，而是会使用你输入的 Key 向模型供应商发起真实的 API 调用来做校验。如果供应商返回 401 Unauthorized，RAGFlow 就会判定 Key 无效并拒绝添加。

SiliconFlow 的 API Key 在调用时是通过 Authorization 请求头以 Bearer Token 方式传递的，RAGFlow 在 UI 字段中只期望接收纯字符串，没有任何特殊的预处理逻辑。因此，可能原因包括：

• API Key 本身已过期、被吊销或输入有误（复制时带入额外空格或引号）。
• RAGFlow 服务器无法正常访问 SiliconFlow 的 API 端点，可能受防火墙、代理或 SSL 证书问题影响，导致请求在到达供应商之前就失败。
• 如果通过 docker-compose 或环境变量方式传递配置，可能存在引号或格式转义问题。

环境排查

• 确认 RAGFlow 镜像版本为 v0.22.1。
• 确认 SiliconFlow API Key 是否仍然有效，建议登录 SiliconFlow 控制台重新生成或查看有效期。
• 检查 RAGFlow 服务器（或 Docker 容器）到 SiliconFlow API 域名的网络连通性，例如是否存在防火墙、代理或 DNS 解析问题。
• 如果使用 docker-compose 部署，检查环境变量或配置文件中是否存在多余的引号或空格。

解决步骤

1. 核对 API Key：登录 SiliconFlow 官方控制台，复制全新的 API Key。粘贴到 RAGFlow 输入框后，确认首尾没有多余空格、引号或换行符。
2. 确认 Key 状态：检查该 Key 是否已被撤销或过期，必要时重新生成一个新 Key 再试。
3. 检查网络连通性：在 RAGFlow 服务器上直接测试能否访问 SiliconFlow API 端点；如果存在防火墙、代理或 SSL 拦截，需先放通相关域名。
4. 检查部署配置：如果通过 docker-compose 或环境变量注入 Key，检查是否有多余引号或格式问题，建议改成在 UI 界面直接输入。
5. 重启后端服务：在更新 API Key 或修正配置后，重启 RAGFlow 后端容器，确保新配置生效后再尝试添加模型。

验证方法

在完成上述排查后，回到模型添加界面，重新输入 API Key 并点击 “Save”，如果能够成功保存并且模型出现在列表中，即表示问题已解决。若仍然报错，需要查看 RAGFlow 后端日志中该次请求的具体错误信息（例如 HTTP 状态码或供应商返回的错误详情），进一步定位是网络问题还是 Key 校验失败。

参考来源

infiniflow/ragflow #11515

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。