Model Configuration

⚙️ 模型配置

OneDocs 支持 40+ 种 AI 模型，涵盖官方 API、第三方平台和本地部署模型。本文介绍如何选择和配置模型。

---

模型供应商一览

内置免费模型

供应商	模型	说明
OneDocs	Qwen2.5-7B、Qwen3-8B、GLM-4-9B 等	免费使用，无需 API Key

⚠️ 免费模型额度有限，可能偶尔不可用。如遇错误，请切换其他模型。

付费 API 模型

供应商	推荐模型	特点
OpenAI	GPT-4o、GPT-4o mini	综合能力最强，价格较高
Anthropic	Claude 3.5 Sonnet	长文本理解优秀
Google Gemini	Gemini 2.5 Pro	多模态能力强
智谱 GLM	GLM-4-Flash（免费）、GLM-4-Plus	国内服务，部分免费
DeepSeek	DeepSeek-Chat、DeepSeek-Reasoner	性价比高，推理能力强
Moonshot	Moonshot-V1-128K	超长上下文支持

兼容平台

以下平台提供兼容 OpenAI 格式的 API 服务，可使用其 API Key 和 Base URL：

平台	说明
优云智算	国内 GPU 算力平台
302.AI	AI 模型聚合平台
小马算力	算力共享平台
硅基流动	国内模型推理服务，部分免费
星河大模型	国内部署服务
PPIO	分布式算力平台
ModelScope	阿里云模型社区
OneAPI	开源 API 管理平台
OpenRouter	国际模型聚合平台

本地模型

供应商	说明
Ollama	本地模型运行框架，默认地址 http://localhost:11434/v1
LM Studio	本地模型运行框架，默认地址 http://localhost:1234/v1

👉 详见 本地模型部署

---

配置步骤

1. 进入模型设置

点击顶部导航栏「设置」→ 左侧选择「模型」

2. 选择供应商

在供应商列表中选择你拥有的模型供应商。

3. 填写配置

字段	必填	说明
API Key	✅	供应商提供的 API 密钥
Base URL	❌	默认为官方地址，使用第三方服务时需替换
模型	✅	选择具体使用的模型

4. 保存配置

填写完毕后点击「保存」，配置会自动持久化到本地。

---

模型选择建议

按使用场景

场景	推荐模型	理由
日常使用	GPT-4o mini / DeepSeek-Chat	性价比高，速度快
复杂分析	GPT-4o / Claude 3.5 Sonnet	理解能力强
长文档	Moonshot-V1-128K / Gemini 2.5 Pro	支持超长上下文
免费体验	OneDocs 内置 / GLM-4-Flash	无需付费
隐私敏感	Ollama 本地模型	数据不出本机

按性价比

模型	价格	质量	推荐度
OneDocs 免费	免费	⭐⭐⭐	⭐⭐⭐⭐
GLM-4-Flash	免费	⭐⭐⭐	⭐⭐⭐⭐
DeepSeek-Chat	极低	⭐⭐⭐⭐	⭐⭐⭐⭐⭐
GPT-4o mini	低	⭐⭐⭐⭐	⭐⭐⭐⭐
GPT-4o	中	⭐⭐⭐⭐⭐	⭐⭐⭐⭐
Claude 3.5 Sonnet	中	⭐⭐⭐⭐⭐	⭐⭐⭐⭐

---

添加自定义模型

如果供应商列表中没有你需要的模型，可以手动添加：

1. 在模型设置页面，找到「自定义模型」区域
2. 输入模型名称（如 my-custom-model）
3. 点击添加

💡 自定义模型名称需要与 API 供应商支持的模型 ID 一致。

---

常见问题

Q: 模型报错 "API Key 无效"？

• 检查 API Key 是否正确复制（注意前后空格）
• 确认 API Key 对应的供应商选择正确
• 部分 API Key 有额度限制，确认账户有余额

Q: 分析结果质量不好？

• 尝试切换更高级的模型（如从 GPT-3.5 升级到 GPT-4o）
• 开启「格式复查」功能（设置 → 通用）
• 配置 RAG 嵌入模型提升分析质量

Q: 免费模型无法使用？

免费模型额度有限，可能暂时不可用。建议：

• 稍后重试
• 切换其他免费模型
• 使用付费模型（DeepSeek 价格极低）