# DeepSeek大模型配置指南

## 概述

DeepSeek大模型是本项目的主要AI文案生成引擎，提供先进的创意文案生成能力。本指南将帮助您配置和使用DeepSeek大模型服务。

## 获取API密钥

### 步骤1：访问DeepSeek平台

1. 访问 [DeepSeek开放平台](https://platform.deepseek.com)
2. 注册账号并完成实名认证
3. 进入控制台，创建新的API密钥

### 步骤2：创建应用

1. 在控制台中点击"创建应用"
2. 填写应用名称（如：数据提取转换器）
3. 选择适用的模型（推荐：DeepSeek-V3）
4. 设置使用权限和配额

### 步骤3：获取API密钥

1. 在应用详情页面找到"API密钥"部分
2. 点击"生成新密钥"
3. 复制生成的API密钥（格式：`sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`）

## 配置环境变量

### 编辑.env文件

在项目根目录下的`.env`文件中添加DeepSeek配置：

```env
# DeepSeek大模型配置（主要AI文案生成）
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
DEEPSEEK_BASE_URL=https://api.deepseek.com
```

### 参数说明

- **DEEPSEEK_API_KEY**: 您的DeepSeek API密钥
- **DEEPSEEK_BASE_URL**: DeepSeek API服务地址（默认值已设置）

## 功能特性

### 主要功能

- **创意文案生成**: 基于照片内容生成多种风格的文案
- **智能内容分析**: 自动识别照片主题和关键元素
- **多风格支持**: 支持商务、文艺、幽默等多种文案风格
- **长度控制**: 可生成短、中、长三种长度的文案

### 模型特点

- **高准确性**: 基于先进的深度学习模型
- **快速响应**: 优化的API响应速度
- **中文优化**: 专门针对中文内容进行优化
- **安全可靠**: 企业级的安全保障

## 使用示例

### 在应用中启用DeepSeek

1. 确保`.env`文件中已配置正确的API密钥
2. 启动应用：`uv run streamlit run app.py`
3. 在"AI照片评分"功能中点击"AI写文案"
4. 选择文案风格和长度
5. 系统将使用DeepSeek大模型生成创意文案

### 代码调用示例

```python
from utils.deepseek_copywriter import DeepSeekCopywriter

# 初始化DeepSeek客户端
copywriter = DeepSeekCopywriter()

# 生成文案
photo_description = "一张美丽的日落照片，有橙色的天空和剪影"
result = copywriter.generate_copywriting(
    description=photo_description,
    style="文艺",
    length="中等"
)

print(result)
```

## 故障排除

### 常见问题

#### 1. API密钥无效
**症状**: 返回"Invalid API key"错误
**解决方案**: 
- 检查API密钥格式是否正确（以`sk-`开头）
- 确认API密钥是否已激活
- 检查账户余额是否充足

#### 2. 请求频率限制
**症状**: 返回"Rate limit exceeded"错误
**解决方案**:
- 降低请求频率
- 检查API配额和使用限制
- 联系DeepSeek客服调整配额

#### 3. 网络连接问题
**症状**: 连接超时或网络错误
**解决方案**:
- 检查网络连接
- 确认防火墙设置
- 尝试使用代理服务器

### 调试方法

1. **检查配置**: 运行配置检查脚本
   ```bash
   uv run python -c "from utils.deepseek_copywriter import check_deepseek_config; print(check_deepseek_config())"
   ```

2. **测试连接**: 运行简单的API测试
   ```bash
   uv run python -c "from utils.deepseek_copywriter import DeepSeekCopywriter; c = DeepSeekCopywriter(); print(c.test_connection())"
   ```

## 成本估算

DeepSeek大模型的定价基于使用量：

- **输入Token**: 约 ¥0.001/千Token
- **输出Token**: 约 ¥0.002/千Token
- **平均成本**: 每次文案生成约 ¥0.01-0.05

**建议**: 新用户可以先申请免费试用额度进行测试。

## 备用方案

如果DeepSeek服务不可用，系统会自动切换到阿里云DashScope作为备用方案。确保同时配置好DashScope API密钥。

## 技术支持

- **官方文档**: [DeepSeek API文档](https://platform.deepseek.com/api-docs)
- **社区支持**: DeepSeek开发者社区
- **客服联系**: 平台内嵌的在线客服

## 更新日志

### v1.0.0 (2025-01-08)
- 首次集成DeepSeek大模型
- 实现创意文案生成功能
- 添加故障转移机制
- 完善配置文档

---

**注意**: 请妥善保管您的API密钥，不要将其提交到版本控制系统。