Paperless-AI项目中使用自定义OpenAI兼容API的配置指南

背景介绍

Paperless-AI是一个基于AI技术的文档处理工具，它能够与各种AI模型集成以实现智能文档分类、内容提取等功能。在实际部署中，许多用户希望使用本地部署的OpenAI兼容API服务（如Open WebUI、LMStudio等）而非直接访问Ollama服务。

核心问题

默认情况下，Paperless-AI需要直接访问Ollama服务端口。但在生产环境中，出于安全考虑，用户可能只希望暴露Open WebUI等中间层的端口，而不是直接暴露Ollama服务。

解决方案

Paperless-AI提供了灵活的配置选项，允许用户指定自定义的OpenAI兼容API端点：

1. 使用自定义提供者：在Paperless-AI的设置中，选择"custom"提供者选项
2. 配置API端点：需要填写完整的OpenAI兼容API路径，包括/v1/chat/completions后缀
3. 认证信息：根据后端服务要求，可能需要配置API密钥或其他认证信息

配置示例

以下是一个典型的配置示例：

API类型：自定义
端点URL：http://your-service-address/v1/chat/completions
API密钥：[根据需要填写]

技术要点

1. 兼容性要求：后端服务必须完整实现OpenAI API规范，包括所有必需的端点
2. 网络配置：确保Paperless-AI容器能够访问到目标API服务
3. 性能考虑：本地部署的API服务可能需要调整资源分配以满足处理需求

最佳实践

1. 建议使用HTTPS协议保障通信安全
2. 对于生产环境，考虑配置适当的请求超时和重试机制
3. 定期监控API服务的可用性和响应时间

通过这种配置方式，用户可以在保持安全性的同时，灵活地集成各种OpenAI兼容的AI服务，满足不同的业务需求和技术架构要求。