# deepseek调用

**Repository Path**: wei_dawn/deepseek-call

## Basic Information

- **Project Name**: deepseek调用
- **Description**: deepseek调用
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-11
- **Last Updated**: 2026-01-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DeepSeek API 集成服务器

一个基于Spring Boot的服务器应用，用于集成DeepSeek及其他大模型API，支持思考模式和多轮对话功能。

## 功能特性

- ✅ 支持DeepSeek API集成
- ✅ 支持OpenAI API集成
- ✅ 支持Anthropic (Claude) API集成
- ✅ 支持百度文心一言API集成
- ✅ DeepSeek思考模式支持
- ✅ 多轮对话支持
- ✅ RESTful API接口
- ✅ Swagger文档
- ✅ 完善的错误处理
- ✅ 详细的日志记录

## 技术栈

- Java 1.8
- Spring Boot 2.7.18
- OkHttpClient 4.10.0
- SpringDoc OpenAPI 1.6.14

## 项目结构

```
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/
│   │   │       └── deepseek/
│   │   │           └── server/
│   │   │               ├── config/         # 配置类
│   │   │               ├── controller/      # REST控制器
│   │   │               ├── service/         # 业务逻辑层
│   │   │               └── DeepseekServerApplication.java  # 主应用类
│   │   └── resources/
│   │       ├── application.yml             # 应用配置
│   │       └── logback.xml                 # 日志配置
│   └── test/
├── pom.xml                                  # Maven依赖配置
├── Dockerfile                               # Docker构建文件
└── README.md                                # 项目说明
```

## 快速开始

### 1. 配置API密钥

在 `src/main/resources/application.yml` 文件中配置API密钥：

```yaml
deepseek:
  api:
    key: your-deepseek-api-key
```

或者通过环境变量配置：

```bash
export DEEPSEEK_API_KEY=your-deepseek-api-key
```

### 2. 构建项目

```bash
mvn clean package -DskipTests
```

### 3. 运行应用

```bash
java -jar target/deepseek-server-0.0.1-SNAPSHOT.jar
```

或者使用Maven运行：

```bash
mvn spring-boot:run
```

### 4. 访问API文档

启动后，可通过以下地址访问Swagger文档：

- Swagger UI: http://localhost:8080/swagger-ui.html
- API文档: http://localhost:8080/v3/api-docs

## API接口

### 1. 通用聊天接口

```bash
POST /api/chat
Content-Type: application/json

{
  "message": "你好，大模型！",
  "model": "deepseek"  # 可选: deepseek, openai, anthropic, ernie
}
```

### 2. DeepSeek思考模式接口

```bash
POST /api/deepseek/thinking
Content-Type: application/json

{
  "message": "9.11和9.8，哪个更大？",
  "enableThinking": true
}
```

### 3. DeepSeek多轮对话接口

```bash
POST /api/deepseek/multi-turn
Content-Type: application/json

{
  "conversationHistory": "[{\"role\": \"user\", \"content\": \"你好，你是谁？\"}, {\"role\": \"assistant\", \"content\": \"我是DeepSeek，一个由深度求索开发的人工智能助手。\"}, {\"role\": \"user\", \"content\": \"你能做什么？\"}]",
  "enableThinking": false
}
```

## 环境变量

| 环境变量 | 描述 | 默认值 |
|---------|------|-------|
| DEEPSEEK_API_KEY | DeepSeek API密钥 | 无 |
| DEEPSEEK_API_URL | DeepSeek API地址 | https://api.deepseek.com/v1/chat/completions |
| OPENAI_API_KEY | OpenAI API密钥 | your-api-key-here |
| OPENAI_API_URL | OpenAI API地址 | https://api.openai.com/v1/chat/completions |
| ANTHROPIC_API_KEY | Anthropic API密钥 | your-api-key-here |
| ANTHROPIC_API_URL | Anthropic API地址 | https://api.anthropic.com/v1/messages |
| ERNIE_API_KEY | 百度文心一言API密钥 | your-api-key-here |
| ERNIE_API_URL | 百度文心一言API地址 | https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions |

## Docker部署

### 构建镜像

```bash
docker build -t deepseek-server .
```

### 运行容器

```bash
docker run -d -p 8080:8080 \
  -e DEEPSEEK_API_KEY=your-deepseek-api-key \
  --name deepseek-server \
  deepseek-server
```

## 日志配置

日志文件默认存储在 `logs/application.log`，配置详见 `src/main/resources/logback.xml`。

## 故障排查

### 1. 连接失败

- 检查API密钥是否正确
- 检查网络连接是否正常
- 查看日志文件中的详细错误信息

### 2. 依赖下载失败

- 确保网络连接正常
- 尝试使用Maven镜像
- 检查Maven配置文件

### 3. 启动失败

- 检查端口是否被占用
- 查看日志文件中的详细错误信息
- 确保所有依赖项都已正确配置

## 版本历史

- 1.0.0: 初始版本，支持基本聊天功能
- 1.1.0: 添加DeepSeek思考模式和多轮对话支持
- 1.2.0: 添加Swagger文档支持
- 1.3.0: 添加Docker部署支持

## 许可证

Apache 2.0 License