docs: 完善DeepSeek大模型配置文档
- 添加DeepSeek大模型配置指南 - 更新README.md中的AI服务说明 - 完善致谢部分,添加DeepSeek感谢 - 创建DEEPSEEK_SETUP.md详细配置文档
This commit is contained in:
parent
2ec2c0a1ab
commit
7b3cbb2324
157
DEEPSEEK_SETUP.md
Normal file
157
DEEPSEEK_SETUP.md
Normal file
@ -0,0 +1,157 @@
|
|||||||
|
# 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密钥,不要将其提交到版本控制系统。
|
||||||
12
README.md
12
README.md
@ -58,7 +58,8 @@
|
|||||||
### AI服务集成
|
### AI服务集成
|
||||||
- **阿里云OCR** - 业界领先的中文OCR识别能力
|
- **阿里云OCR** - 业界领先的中文OCR识别能力
|
||||||
- **百度智能云** - 专业的图像分析和识别服务
|
- **百度智能云** - 专业的图像分析和识别服务
|
||||||
- **阿里云DashScope** - 强大的AI大模型文案生成
|
- **DeepSeek大模型** - 先进的创意文案生成(主要)
|
||||||
|
- **阿里云+DashScope** - 强大的AI大模型文案生成(备用)
|
||||||
|
|
||||||
## 🚀 快速开始
|
## 🚀 快速开始
|
||||||
|
|
||||||
@ -92,7 +93,10 @@ ALIYUN_OCR_ENDPOINT=ocr-api.cn-hangzhou.aliyuncs.com
|
|||||||
BAIDU_API_KEY=your-baidu-api-key
|
BAIDU_API_KEY=your-baidu-api-key
|
||||||
BAIDU_SECRET_KEY=your-baidu-secret-key
|
BAIDU_SECRET_KEY=your-baidu-secret-key
|
||||||
|
|
||||||
# DashScope配置(AI文案生成)
|
# DeepSeek大模型配置(主要AI文案生成)
|
||||||
|
DEEPSEEK_API_KEY=your-deepseek-api-key
|
||||||
|
|
||||||
|
# DashScope配置(备用AI文案生成)
|
||||||
DASHSCOPE_API_KEY=your-dashscope-api-key
|
DASHSCOPE_API_KEY=your-dashscope-api-key
|
||||||
```
|
```
|
||||||
|
|
||||||
@ -134,6 +138,9 @@ data-extractor-converter/
|
|||||||
### 阿里云OCR配置
|
### 阿里云OCR配置
|
||||||
参考: [ALIYUN_OCR_SETUP.md](docs/ALIYUN_OCR_SETUP.md)
|
参考: [ALIYUN_OCR_SETUP.md](docs/ALIYUN_OCR_SETUP.md)
|
||||||
|
|
||||||
|
### DeepSeek大模型配置
|
||||||
|
参考: [DEEPSEEK_SETUP.md](docs/DEEPSEEK_SETUP.md)
|
||||||
|
|
||||||
### 百度智能云配置
|
### 百度智能云配置
|
||||||
参考: [BAIDU_AI_SETUP.md](docs/BAIDU_AI_SETUP.md)
|
参考: [BAIDU_AI_SETUP.md](docs/BAIDU_AI_SETUP.md)
|
||||||
|
|
||||||
@ -203,6 +210,7 @@ uv run isort .
|
|||||||
## 🙏 致谢
|
## 🙏 致谢
|
||||||
|
|
||||||
感谢以下服务提供的AI能力支持:
|
感谢以下服务提供的AI能力支持:
|
||||||
|
- [DeepSeek](https://www.deepseek.com/) - 先进的AI大模型文案生成服务
|
||||||
- [阿里云](https://www.aliyun.com/) - OCR和AI大模型服务
|
- [阿里云](https://www.aliyun.com/) - OCR和AI大模型服务
|
||||||
- [百度智能云](https://cloud.baidu.com/) - 图像分析服务
|
- [百度智能云](https://cloud.baidu.com/) - 图像分析服务
|
||||||
- [Streamlit](https://streamlit.io/) - Web应用框架
|
- [Streamlit](https://streamlit.io/) - Web应用框架
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user