7b3cbb2324
- 添加DeepSeek大模型配置指南 - 更新README.md中的AI服务说明 - 完善致谢部分，添加DeepSeek感谢 - 创建DEEPSEEK_SETUP.md详细配置文档
157 lines
4.2 KiB
Markdown
157 lines
4.2 KiB
Markdown
# 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密钥，不要将其提交到版本控制系统。 |