快速结论:该问题并非报错,而是一个功能请求——为 RAGFlow 添加名为 Synthorai 的模型提供商(OpenAI 与 Anthropic 兼容网关)。问题已通过 PR #18830 解决并合并(2026-08-27),如果你需要接入 Synthorai,请确保 RAGFlow 版本已包含该合并;若你使用的是旧版本,优先检查 conf/llm_factories.json 中是否已有 Synthorai 条目。
适用环境:RAGFlow;涉及 conf/llm_factories.json、conf/models/synthorai.json、internal/entity/models/synthorai.go、rag/llm/chat_model.py 等文件;PR 合并日期为 2026-08-27,未涉及操作系统、Python、CUDA 或显卡的特定版本信息。
最快修复方案:暂无确认的一步修复方案。该问题为功能请求,已通过合并 PR #18830 解决;如果你在旧版本中遇到无法使用 Synthorai 提供商的问题,请升级到包含该合并的 RAGFlow 版本。
注意事项:PR 合并时修复了两个审查中发现的问题:端点已固定,防止租户提供的 base URL 重定向 API 密钥;远程模型发现被过滤为已声明的 chat 模型 ID,而非返回目录中的所有内容。如果你使用 Synthorai 提供商,应避免配置自定义 base URL 以避免安全风险。
问题场景
该 Issue 是 Synthorai 维护者提交的自我提名功能请求。Synthorai(https://synthorai.io)是一个 OpenAI 和 Anthropic 兼容的 LLM 网关,目前用户已经可以通过 RAGFlow 的通用 OpenAI-API-Compatible 提供商手动配置 base URL 和模型名来使用它,但这种方式操作繁琐、没有图标和精选目录。用户请求将 Synthorai 添加为命名提供商,使其获得与 OpenRouter、CometAPI、302.AI 等相同的待遇。
报错原文
[Feature Request]: Add Synthorai as a model provider (OpenAI- and Anthropic-compatible gateway)
原因分析
这不是一个错误或故障,而是一个可用性改进请求。可能原因是:Synthorai 作为 LLM 网关虽然已经能通过通用 OpenAI 兼容接口在 RAGFlow 中使用,但用户体验较差——需要手动粘贴 base URL、逐个手输模型名,且没有图标和精选模型目录。添加命名提供商条目可以显著降低配置门槛。
环境排查
- 确认 RAGFlow 版本是否在 2026-08-27(PR #18830 合并日)之后发布或包含该合并。
- 检查
conf/llm_factories.json中是否已存在Synthorai条目。 - 如果使用旧版本,确认当前使用的模型提供商配置方式(通用 OpenAI-API-Compatible 或 Anthropic 兼容路径)。
解决步骤
- 确认当前 RAGFlow 版本是否包含 PR #18830 的合并——若为 2026-08-27 之后的版本,通常已包含。
- 打开
conf/llm_factories.json,搜索Synthorai条目;如果没有,考虑升级 RAGFlow 或手动添加配置。 - 若需手动添加,参考 PR 中的实现:在
conf/llm_factories.json添加工厂条目(名称、logo、tags 为 “LLM”、status “1”、url 为https://synthorai.io/v1、llm 模型列表),并添加conf/models/synthorai.json模型元数据。 - 在 RAGFlow 界面中选择 Synthorai 提供商,粘贴 API Key(环境变量建议为
SYNTHORAI_API_KEY)。 - 注意:不要修改默认的 base URL——PR 中已固定端点,防止租户提供的 base URL 重定向 API 密钥导致安全问题。
验证方法
在 RAGFlow 的模型提供商设置中,确认 Synthorai 已作为独立选项出现;选择后能获取 Synthorai 目录中的模型列表(而非所有模型);使用一个 Synthorai 模型(如 Claude、GPT、Gemini 等)进行聊天测试,确认请求成功返回。另外可验证远程模型发现中只显示声明的 chat 模型 id。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


