[Feature Request]: Add Synthorai as a model provider (OpenAI- and Anthropic-compatible gateway)

该问题并非报错,而是一个功能请求——为 RAGFlow 添加名为 Synthorai 的模型提供商(OpenAI 与 Anthropic 兼容网关)。问题已通过 PR #18830 解决并合并(2026-08-27),如果你需要接入 Synthorai,请确保 RAGFlow 版本已包含该合并;若你

快速结论:该问题并非报错,而是一个功能请求——为 RAGFlow 添加名为 Synthorai 的模型提供商(OpenAI 与 Anthropic 兼容网关)。问题已通过 PR #18830 解决并合并(2026-08-27),如果你需要接入 Synthorai,请确保 RAGFlow 版本已包含该合并;若你使用的是旧版本,优先检查 conf/llm_factories.json 中是否已有 Synthorai 条目。

适用环境:RAGFlow;涉及 conf/llm_factories.jsonconf/models/synthorai.jsoninternal/entity/models/synthorai.gorag/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 兼容路径)。

解决步骤

  1. 确认当前 RAGFlow 版本是否包含 PR #18830 的合并——若为 2026-08-27 之后的版本,通常已包含。
  2. 打开 conf/llm_factories.json,搜索 Synthorai 条目;如果没有,考虑升级 RAGFlow 或手动添加配置。
  3. 若需手动添加,参考 PR 中的实现:在 conf/llm_factories.json 添加工厂条目(名称、logo、tags 为 “LLM”、status “1”、url 为 https://synthorai.io/v1、llm 模型列表),并添加 conf/models/synthorai.json 模型元数据。
  4. 在 RAGFlow 界面中选择 Synthorai 提供商,粘贴 API Key(环境变量建议为 SYNTHORAI_API_KEY)。
  5. 注意:不要修改默认的 base URL——PR 中已固定端点,防止租户提供的 base URL 重定向 API 密钥导致安全问题。

验证方法

在 RAGFlow 的模型提供商设置中,确认 Synthorai 已作为独立选项出现;选择后能获取 Synthorai 目录中的模型列表(而非所有模型);使用一个 Synthorai 模型(如 Claude、GPT、Gemini 等)进行聊天测试,确认请求成功返回。另外可验证远程模型发现中只显示声明的 chat 模型 id。

参考来源

infiniflow/ragflow #18822

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 20751

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注