Open WebUI 接入 Deepseek API 完全指南 – 2025 年 1 月

这篇文章我详细介绍如何在开源的 Open WebUI 中配置和使用 Deepseek API，打造你自己的专属 AI 助手。

欢迎免费试用 API易，3 分钟跑通 API 调用 www.apiyi.com
支持 Deepseek 等全系列模型，专业的技术支持助你解决各类问题

前言

Open WebUI 是一个功能强大的开源 AI 界面，支持多种 AI 模型的接入，包括 Ollama、OpenAI API 等。本教程将指导你如何在 Open WebUI 中配置和使用 Deepseek API，让你能够快速搭建自己的 AI 助手系统。

环境准备

1. 安装 Open WebUI

Open WebUI 提供多种安装方式，这里我们推荐使用 Docker 方式安装，简单快捷：

# 使用 Docker 安装 Open WebUI（仅 API 模式）
docker run -d -p 3000:8080 \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main

2. 获取 API 密钥

在开始之前，你需要：

1. 注册 API易 账号
2. 在【令牌】栏目点击获取 API 密钥，用默认令牌（也就是 Key）即可
3. 确保账户有足够的余额（默认赠送了 0.1 美金，可加站长微信额外获赠 1 美金）

配置步骤

1. 访问 Open WebUI

安装完成后，打开浏览器访问：

http://localhost:3000

2. 配置 Deepseek API

1. 点击右上角的设置图标
2. 选择 “API Endpoints”
3. 添加新的 API 配置：
   • Base URL: https://vip.apiyi.com/v1
   • API Key: 填入你的 API易 密钥
   • 选择 OpenAI 兼容模式

3. 模型配置

在 Open WebUI 中，你可以使用以下 Deepseek 模型：

1. DeepSeek-V3：
   • 模型名称：deepseek-chat
   • 上下文长度：64K tokens
   • 适用场景：通用对话、内容创作
2. DeepSeek-R1：
   • 模型名称：deepseek-reasoner
   • 上下文长度：64K tokens
   • 适用场景：推理分析、复杂问题解决

使用指南

1. 创建新对话

1. 点击左侧 “+” 按钮创建新对话
2. 在模型选择下拉菜单中选择 Deepseek 模型
3. 开始你的对话！

2. 参数调优

为获得最佳体验，建议设置以下参数：

{
  "temperature": 0.7,
  "max_tokens": 8000,
  "top_p": 0.9,
  "frequency_penalty": 0,
  "presence_penalty": 0
}

3. 高级功能

Open WebUI 提供多种高级功能，配合 Deepseek API 使用效果更佳：

• 多模型对话：可同时使用多个 Deepseek 模型
• 历史记录：自动保存所有对话历史
• 提示词管理：可保存常用提示词模板
• 导出功能：支持导出对话记录

性能优化建议

1. 合理设置 max_tokens：
   • 一般对话：2000-4000
   • 长文生成：4000-8000
2. 优化提示词：
   • 使用清晰、具体的指令
   • 避免模糊不清的表述
3. 缓存管理：
   • 定期清理浏览器缓存
   • 及时清理无用的对话历史

常见问题解答

1. 连接问题

Q：为什么显示连接失败？
A：检查以下几点：

• API 密钥是否正确
• Base URL 是否正确配置
• 账户余额是否充足

2. 响应问题

Q：为什么有时候响应很慢？
A：可能原因：

• 网络连接不稳定
• 服务器负载高
• 提示词过长

3. 计费问题

Q：如何查看 API 调用费用？
A：在 API易 控制台可以查看：

• 实时使用量
• 费用统计
• 调用记录

最佳实践

1. 合理使用模型：
   • 简单对话使用 DeepSeek-V3
   • 复杂推理使用 DeepSeek-R1
2. 优化对话体验：
   • 使用清晰的提示词
   • 适当设置参数
   • 及时保存重要对话
3. 成本控制：
   • 监控 API 使用量
   • 设置用量预警
   • 优化 token 使用

总结

通过本教程，你已经学会了如何在 Open WebUI 中配置和使用 Deepseek API。这个组合不仅让你能够使用最先进的 AI 模型，还能享受到开源社区带来的持续更新和改进。

记住，API易 提供专业的技术支持，如果你在使用过程中遇到任何问题，都可以随时联系我们的支持团队。

欢迎免费试用 API易，3 分钟跑通 API 调用 www.apiyi.com
支持 Deepseek 等全系列模型，专业的技术支持助你解决各类问题

---

本文作者：API易团队

最后更新：2025-01-20

欢迎关注我们的更新，持续分享 AI 开发经验和最新动态。